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

docs(02-03): complete Subscriber and ServicePlan management plan

Browse Source 
Tasks completed: 2/2
- Task 1: Subscriber and ServicePlan Prisma models + service layer
- Task 2: Subscriber and ServicePlan API routes + tests

SUMMARY: .planning/phases/02-subscriber-and-billing-core/02-03-SUMMARY.md
This commit is contained in:
kevin-asprec
2026-03-04 23:04:15 +08:00
parent 03a4a29150
commit 5c6969343b
2 changed files with 156 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
.planning/STATE.md
View File

@@ -10,11 +10,11 @@ See: .planning/PROJECT.md (updated 2026-03-04)
## Current Position
Phase: 2 of 5 (Subscriber and Billing Core) — In progress
Plan: 1 of 5 in phase 2 complete (6/20 total)
Status: In progress. 02-01 (COA + Accounting Periods) complete.
Last activity: 2026-03-04 — Completed 02-01-PLAN.md (ISP Chart of Accounts, accounting period management, 121 tests)
Plan: 3 of 5 in phase 2 complete (8/20 total)
Status: In progress. 02-01 (COA + Accounting Periods) and 02-03 (Subscriber + ServicePlan) complete.
Last activity: 2026-03-04 — Completed 02-03-PLAN.md (Subscriber management, service plans, 41 new tests, 162 total)
Progress: [██████░░░░] 30% (6/20 plans across all phases)
Progress: [████████░░] 40% (8/20 plans across all phases)
## Performance Metrics
@@ -28,10 +28,10 @@ Progress: [██████░░░░] 30% (6/20 plans across all phases)
| Phase | Plans | Total | Avg/Plan |
|-------|-------|-------|----------|
| 01-foundation | 5/5 complete | 41 min | 8.2 min |
| 02-subscriber-and-billing-core | 1/5 complete | 7 min | 7 min |
| 02-subscriber-and-billing-core | 3/5 complete | 21 min | 7 min |
**Recent Trend:**
- Last 6 plans: 01-01 (11 min), 01-02 (8 min), 01-03 (9 min), 01-04 (7 min), 01-05 (6 min), 02-01 (7 min)
- Last 7 plans: 01-01 (11 min), 01-02 (8 min), 01-03 (9 min), 01-04 (7 min), 01-05 (6 min), 02-01 (7 min), 02-03 (7 min)
- Trend: stable around 7-8 min
*Updated after each plan completion*
@@ -74,6 +74,10 @@ Recent decisions affecting current work:
- [02-01]: seedChartOfAccounts receives Prisma tx client — works inside createTenant $transaction for atomic provisioning
- [02-01]: Accounting periods created on-demand via getOpenPeriod() — not pre-seeded on signup (no wasted periods for unused months)
- [02-01]: close route uses closure pattern over withPermission HOF — withPermission doesn't support dynamic params directly; POST fn closes over Next.js params
- [02-03]: creditBalance on Subscriber is operational convenience (FIFO credit allocation for 02-05), NOT a ledger balance — always updated atomically with journal entries
- [02-03]: billingDay capped at 28 — subscribers signing up on days 29-31 get billingDay=28 to avoid month-length invoice generation issues
- [02-03]: CANCELLED -> ACTIVE transition is reversible by design — ISPs frequently reinstate cancelled accounts per CONTEXT.md
- [02-03]: as any cast in service create() calls — Prisma static type requires tenantId but withTenantContext() extension injects at runtime; cast is intentional
### Pending Todos
@@ -88,6 +92,6 @@ None.
## Session Continuity
Last session: 2026-03-04T14:51:56Z
Stopped at: Completed 02-01-PLAN.md (COA + accounting period management + 28 new tests, 121 total)
Last session: 2026-03-04T15:02:45Z
Stopped at: Completed 02-03-PLAN.md (Subscriber + ServicePlan management + 41 new tests, 162 total)
Resume file: None