Read-only. Reports what a corte would touch without touching it.
The platform inherited legacy's BALANCE FORWARD rows (1,170, all dated
2026-01-01) but not the yearly process that produces them, and
BillingService floors balances per customer on those rows. Two populations
fall outside that floor, and they are unrelated defects that happen to
surface as the same symptom — a customer whose balance reads as a credit
the office does not owe.
A. 102 customers have no BALANCE FORWARD row, so their balance is a raw
lifetime sum. Only the current-year charge ledger (datos2) was migrated;
the per-year charge tables stayed in DreamHost. What survives before the
cutover is the EFECTIVO cash journal, and it shows: 199 of their 201
pre-cutover rows are credits. Flooring them at 2026-01-01 moves the book
by -82,297.78 MXN and -52,020.20 USD. 91 of the 102 are left with no rows
at all, so their balance becomes zero — an assertion, not a figure
recovered from anywhere, which is why this script proposes and does not
apply.
B. 276 cash receipts booked twice in 2026 — once in EFECTIVO under folio N,
once in datos2 as reference CN — across 120 customers, 986,240.00 MXN and
88,252.00 USD on the EFECTIVO side. Both rows sit after the floor so both
count. The statement already hides them via
STATEMENT_EXCLUDED_SOURCE_TABLES; the balances worklist, the movement
browser and the /clientes/:id card do not.
The folio alone does not establish a pair — folios are reused. Every pair is
corroborated on money too: equal amounts when both legs share a currency, or
an implied USD->MXN rate inside the band exchange_rates observed that year.
Two of 278 folio matches fail that test and are reported apart rather than
counted, both same-day partial applications that need a human.
Matches the balance-forward row in both shapes, as numid.service.ts does.
Databases imported before the type was minted carry those rows with typeId
NULL, and name-only matching reports every customer as floorless on such a
copy — including the dev database, which the API itself currently reads as
+20,653,109.15 MXN against a floored -9,194.61.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
