kibin/NetForge
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(02): create phase plan

Browse Source 
Phase 02: Subscriber and Billing Core
- 5 plans in 4 waves
- Wave 1: 02-01 (COA), 02-03 (Subscribers) parallel
- Wave 2: 02-02 (Journal Entry Service)
- Wave 3: 02-04 (Billing Engine)
- Wave 4: 02-05 (Payment Tracker)
- Ready for execution

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
kevin-asprec
2026-03-04 22:27:35 +08:00
parent e14b926da1
commit 9489b5c7bc
6 changed files with 1214 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
.planning/ROADMAP.md
View File

@@ -51,14 +51,14 @@ Plans:
3. Office staff can record a full or partial cash or bank payment against an invoice; the invoice status updates to partial or paid in real time
4. Every payment and invoice generation event produces a balanced journal entry in the ledger (debits = credits) with no manual accounting step required
5. Staff can generate an overdue/outstanding report filtered by date range, status, and amount showing correct outstanding balances derived from the journal — no stored balance fields exist
**Plans**: TBD
**Plans**: 5 plans
Plans:
- [ ] 02-01: Chart of Accounts — pre-configured ISP COA auto-provisioned at tenant signup, ACCT-01 and ACCT-09 (balance derivation from ledger, no mutable balance fields)
- [ ] 02-02: Journal Entry Service — JournalEntryService as sole gateway to ledger, debit=credit enforcement, immutable entries, reversing entry pattern (ACCT-02, ACCT-03, ACCT-07)
- [ ] 02-03: Subscriber management — registration, plan assignment, status lifecycle (active/suspended/cancelled), subscriber search and filtering (SUB-01, SUB-02, SUB-03, SUB-04)
- [ ] 02-04: Billing engine — prepaid and postpaid as distinct state machines, monthly invoice auto-generation via BullMQ scheduled job, due date calculation, overdue detection (BILL-01, BILL-02)
- [ ] 02-05: Payment tracker — cash/bank payment recording, partial payment support, invoice status update, outstanding balance reports, idempotency keys on payment creation, subscriber payment history ledger (BILL-03, BILL-04, BILL-05, BILL-06, SUB-05)
- [ ] 02-01-PLAN.md — Chart of Accounts: ISP COA auto-provisioned at tenant signup, accounting period management (ACCT-01, ACCT-09)
- [ ] 02-02-PLAN.md — Journal Entry Service: sole ledger gateway, debit=credit enforcement, immutable entries, reversing entries, maker-checker (ACCT-02, ACCT-03, ACCT-07)
- [ ] 02-03-PLAN.md — Subscriber management: registration, plan assignment, status lifecycle, search and filtering (SUB-01, SUB-02, SUB-03, SUB-04)
- [ ] 02-04-PLAN.md — Billing engine: prepaid/postpaid invoice generation, anniversary billing, overdue detection, journal entry per invoice (BILL-01, BILL-02)
- [ ] 02-05-PLAN.md — Payment tracker: FIFO allocation, partial/full/overpayment, void with reversing entries, outstanding report, payment history (BILL-03, BILL-04, BILL-05, BILL-06, SUB-05)
---