Scope and Gaps

Confirmed implementation decisions, out-of-scope areas for V1, and known backend gaps.

Repository (`crelio-app`)

File	Purpose
`finance/views/bill_split.py`	View layer — request validation, mode routing, and response construction
`finance/views/bill_split_manager.py`	Manager — all business logic, DB operations, and post-commit side effects
`finance/urls/__init__.py`	URL registration for `POST /api-v3/finance/bill/split/{bill_id}`
`admin/account/models/lab_settings.py`	`enable_bill_split` field definition
`admin/account/migrations/0110_labsettings_enable_bill_split.py`	Migration adding the field
`admin/account/views/account_configuration_constant.py`	Admin panel config entry for the flag

No parent-child mapping table is created. The ActivityLog with log_context = BILL_SPLIT is the authoritative audit trail.
orderNumber on the split bill is derived from the parent by appending ~{step} — providing lineage without a dedicated linking table.

Smart report attachments are soft-deleted on the parent; users can regenerate reports as needed.
Bill approval, unresolved missing details, and symptoms relations are cloned — not shared — to keep each bill independently actionable.
AOE and patient consent records are migrated in the same atomic transaction as the split.
LabForm (consent type) is handled: a new LabForm record is cloned for the split bill. Revoked forms are excluded.
LabForm (AOE config type) is not handled: the form config structure stays on the parent. Only QuestionValue responses are migrated.

Destination source defaults to Org Pay; Self Pay is the other option. Both are non-insurance sources.
For non-insurance destination, insurance-specific payable fields (co_pay_amount, deductible_amount, patientPayableAmount) are reset to 0 on both the split bill and moved BillingInfo rows.

The enable_bill_split field on LabSettings must be True for the feature to be accessible.
Added via migration 0110_labsettings_enable_bill_split.
Configurable in the admin panel under Workflow Configurations → Enable Bill Splitting.

Splitting paid or settled bills.
Splitting into more than two bills.
Merge or reverse-split flows.
Claim-linked split variants beyond existing allowed checks.
Home collection, appointment, and kit-centric split workflows.
Full advanced batch/rack scenarios beyond current validated coverage.
AOE Promotion and Store process types (left on parent bill, not migrated).
LabForm AOE config records — only QuestionValue responses are migrated, not the form config.
prescriptions, TestClinicalInfo, BillClassifierTags — not migrated; no planned V1 support.