root
8fc88ffc14
Build & Push / Pipeline Tests (push) Failing after 59s
Build & Push / Build & Push Docker Image (push) Has been skipped
Test / Type Check (all packages) (push) Failing after 51s
Test / API Unit Tests (push) Has been skipped
Test / Homepage Unit Tests (push) Has been skipped
Test / Carplace Unit Tests (push) Has been skipped
Test / Admin Unit Tests (push) Has been skipped
Test / Dashboard Unit Tests (push) Has been skipped
Test / API Integration Tests (push) Has been skipped
1.6 KiB
1.6 KiB
Billing & notification source-of-truth map
Status: Phase 2 convergence guide
Date: 2026-08-12
Billing
| Generation | Models | Rule |
|---|---|---|
| Canonical | BillingAccount, BillingInvoice, line items, intents, attempts, credits, tax, refunds |
Write path for new money movement |
| Legacy compat | SubscriptionInvoice, older payment-attempt shapes linked via billingInvoiceId |
Read/migrate only; do not create new orphans |
Invariant: One money-moving command → one canonical BillingInvoice (or intent) → provider idempotency key → webhook reconciliation → auditable outcome.
Until legacy rows are archived:
- Prefer canonical reads in admin/finance UI
- Keep dual-read adapters only where needed for historical invoices
- Block new writes that create legacy-only invoice rows
Notifications
| Generation | Models | Rule |
|---|---|---|
| Canonical | NotificationEvent → NotificationRecipient → NotificationDelivery + NotificationOutbox |
All new product notifications |
| Legacy | Flat Notification |
Migrate reads; no new writes after GA |
Dispatch: Outbox worker (Phase 1) is the only delivery executor. Direct sendTransactionalEmail remains allowed for auth/security messages that must not wait on the outbox.
Exit evidence for convergence
- Inventory counts of legacy vs canonical rows in staging/prod
- No new legacy-only writes in code paths covered by tests
- Retention policy applied consistently across both generations during migration