kibin/NetForge
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
59 Commits 1 Branch 0 Tags
86284f1f5b23c25c1447daa11491ff4b38e7425f
Commit Graph

29 Commits

Author SHA1 Message Date
kevin-asprec
0373810d9e docs(03-02): complete Collector Collection and Remittance plan 
Tasks completed: 2/2
- Task 1: Collection/Remittance schema, 1030 COA, migration, tenant scoping
- Task 2: Collector service, remittance service, report service, APIs, 26 tests

SUMMARY: .planning/phases/03-operational-modules/03-02-SUMMARY.md
 2026-03-05 07:56:20 +08:00
kevin-asprec
570218320c docs(03-03): complete Ticketing System plan 
Tasks completed: 2/2
- Task 1: Ticket schema, categories, migration, and tenant scoping
- Task 2: Ticket service, category service, API routes, and 28 integration tests

SUMMARY: .planning/phases/03-operational-modules/03-03-SUMMARY.md
 2026-03-05 07:41:39 +08:00
kevin-asprec
2321bf2ada docs(03-01): complete zone management plan 
Tasks completed: 2/2
- Task 1: Zone schema, migration, and tenant scoping
- Task 2: Zone service, API routes, and integration tests

SUMMARY: .planning/phases/03-operational-modules/03-01-SUMMARY.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-05 07:32:21 +08:00
kevin-asprec
d54b517e2e docs(03): create phase plan 
Phase 03: Operational Modules
- 5 plans in 3 waves
- Wave 1: 03-01 (zones), 03-03 (tickets) — parallel
- Wave 2: 03-02 (collector collections), 03-04 (job orders) — parallel
- Wave 3: 03-05 (technician compensation)
- Ready for execution

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-05 07:11:44 +08:00
kevin-asprec
9af86c54c3 docs(03): research phase domain 
Phase 03: Operational Modules
- Standard stack identified (no new dependencies)
- Architecture patterns documented (10 patterns from codebase)
- Pitfalls catalogued (8 pitfalls from direct code inspection)
 2026-03-05 06:20:41 +08:00
kevin-asprec
ef0150654b docs(03): create phase plan 
Phase 03: Operational Modules
- 5 plans in 3 waves
- Wave 1: 03-01 (zones), 03-03 (tickets) — parallel
- Wave 2: 03-02 (collector collections), 03-04 (job orders) — parallel
- Wave 3: 03-05 (technician compensation) — sequential
- Ready for execution

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-05 06:05:55 +08:00
kevin-asprec
4b4f7bce3b docs(03): capture phase context 
Phase 03: Operational Modules
- Implementation decisions documented
- Phase boundary established
 2026-03-05 05:53:44 +08:00
kevin-asprec
e6e09bd0cb docs(02): complete Subscriber and Billing Core phase 
Phase 2 verified: 5/5 plans executed, 265 tests passing.
16 requirements marked complete (SUB-01..05, BILL-01..06, ACCT-01..03, ACCT-07, ACCT-09).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-05 00:09:09 +08:00
kevin-asprec
816ac5360f docs(02-05): complete payment system plan — Phase 2 complete 
Tasks completed: 2/2
- Task 1: Payment model with FIFO allocation and void
- Task 2: Payment APIs, outstanding report, and 29 passing tests

Phase 2 (Subscriber and Billing Core) complete — 265/265 tests passing
SUMMARY: .planning/phases/02-subscriber-and-billing-core/02-05-SUMMARY.md
 2026-03-04 23:54:42 +08:00
kevin-asprec
df4a467a38 docs(02-04): complete billing engine plan 
Tasks completed: 2/2
- Task 1: Invoice model + BillingService + InvoiceService + CreditService
- Task 2: Billing API routes + comprehensive tests (38 passing)

SUMMARY: .planning/phases/02-subscriber-and-billing-core/02-04-SUMMARY.md
 2026-03-04 23:41:50 +08:00
kevin-asprec
c60c22b080 docs(02-02): complete JournalEntryService plan 
Tasks completed: 2/2
- Task 1: JournalEntry models + JournalEntryService
- Task 2: Journal entry API routes + comprehensive tests

SUMMARY: .planning/phases/02-subscriber-and-billing-core/02-02-SUMMARY.md
 2026-03-04 23:25:42 +08:00
kevin-asprec
5c6969343b docs(02-03): complete Subscriber and ServicePlan management plan 
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
 2026-03-04 23:04:15 +08:00
kevin-asprec
e49db94f38 docs(02-01): complete Chart of Accounts plan 
Tasks completed: 2/2
- Task 1: Account and AccountingPeriod Prisma models + COA definition
- Task 2: COA auto-provisioning on tenant signup + API routes + tests

SUMMARY: .planning/phases/02-subscriber-and-billing-core/02-01-SUMMARY.md
 2026-03-04 22:53:38 +08:00
kevin-asprec
bd8e83bf68 fix(02): revise plans based on checker feedback 
- 02-05: Update outstanding report key_link and action to document
  Invoice.amountPaid as transactional convenience field (not standalone
  stored balance), consistent with creditBalance pattern in 02-03
- 02-04: Add applyCredit wiring to generateInvoiceForSubscriber, add
  credit-service.ts extraction to avoid circular imports, add credit
  auto-application tests
- 02-01/02-03: Add parallel Prisma migration serialization notes for
  Wave 1 concurrent execution

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-04 22:35:59 +08:00
kevin-asprec
9489b5c7bc docs(02): create phase plan 
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>
 2026-03-04 22:27:35 +08:00
kevin-asprec
e14b926da1 docs(02): capture phase context 
Phase 02: Subscriber and Billing Core
- Implementation decisions documented
- Phase boundary established

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-04 22:06:07 +08:00
kevin-asprec
0cb9a483bf docs(01): complete Foundation phase 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-04 19:22:00 +08:00
kevin-asprec
9d8c45ce10 docs(01-05): complete super-admin panel plan 
Tasks completed: 2/2
- Task 1: Super-admin API routes and middleware guard
- Task 2: Super-admin UI panel and comprehensive test harness

Phase 1 Foundation: COMPLETE (5/5 plans)
93 tests passing across auth, RBAC, tenant isolation, super-admin

SUMMARY: .planning/phases/01-foundation/01-05-SUMMARY.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-04 19:08:38 +08:00
kevin-asprec
d25885aaeb docs(01-04): complete CASL RBAC plan 
Tasks completed: 2/2
- Task 1: CASL permission definitions and ability factory
- Task 2: API authorization middleware and RBAC tests

SUMMARY: .planning/phases/01-foundation/01-04-SUMMARY.md
 2026-03-04 18:59:14 +08:00
kevin-asprec
dc85d348ef docs(01-03): complete tenant provisioning and isolation plan 
Tasks completed: 2/2
- Task 1: Tenant signup API, tenant service, and signup UI
- Task 2: Prisma tenant middleware, PostgreSQL RLS, and isolation tests

SUMMARY: .planning/phases/01-foundation/01-03-SUMMARY.md
 2026-03-04 18:47:01 +08:00
kevin-asprec
cf790c3257 docs(01-02): complete authentication plan 
Tasks completed: 2/2
- Task 1: NextAuth.js configuration with credentials provider and JWT
- Task 2: Login page UI, logout flow, seed script, and auth unit tests

SUMMARY: .planning/phases/01-foundation/01-02-SUMMARY.md
 2026-03-04 18:44:29 +08:00
kevin-asprec
19a5520dd5 docs(01-01): complete project scaffold and dev environment plan 
Tasks completed: 2/2
- Task 1: Next.js 15 project with Docker Compose dev environment
- Task 2: Prisma schema with Tenant/User models and Vitest setup

SUMMARY: .planning/phases/01-foundation/01-01-SUMMARY.md
 2026-03-04 18:32:40 +08:00
kevin-asprec
7e6d286fca docs(01): create phase plan 
Phase 01: Foundation
- 5 plan(s) in 4 wave(s)
- 2 parallel (wave 2: auth + tenant provisioning), 3 sequential
- Ready for execution

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-04 18:13:27 +08:00
kevin-asprec
2506a6745c docs(01): capture phase context 
Phase 01: Foundation
- Implementation decisions documented
- Phase boundary established

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-04 18:05:03 +08:00
kevin-asprec
1bdb4eafae docs: create roadmap (5 phases) and research 
Phases:
1. Foundation: tenant isolation, auth, Docker, RBAC
2. Subscriber & Billing Core: subscribers, invoicing, payments, accounting ledger
3. Operational Modules: collectors, ticketing, job orders, technicians
4. Inventory, Expenses & Reports: event-ledger inventory, expenses, financial statements
5. Visibility & Client Portal: dashboard, client self-service, integration & e2e tests

All 66 v1 requirements mapped to phases.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-04 17:45:09 +08:00
kevin-asprec
21541fd8d5 docs: define v1 requirements 
53 requirements across 12 categories
11 requirements deferred to v2
Full double-entry accounting with audit trail and derived balances

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-04 17:40:14 +08:00
kevin-asprec
c407e182f8 docs: complete project research for NetForge ISP Management SaaS 
Files:
- STACK.md
- FEATURES.md
- ARCHITECTURE.md
- PITFALLS.md
- SUMMARY.md

Key findings:
- Stack: Next.js 15 + TypeScript + PostgreSQL + Prisma monolith; BullMQ for billing cron jobs; MikroTik client needs library verification (LOW confidence)
- Architecture: Modular monolith with shared-DB multi-tenancy; JournalEntryService as sole ledger gateway; derived financial state (no balance fields)
- Critical pitfall: Cross-tenant data leakage + fake accounting + billing state machine must all be solved in Phase 1 before any feature work

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-04 17:21:44 +08:00
kevin-asprec
ec2e583787 chore: add project config 
Mode: yolo
Depth: standard
Parallelization: disabled
Workflow agents: research=on, plan_check=on, verifier=on

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-04 17:14:25 +08:00
kevin-asprec
54fb4915f0 docs: initialize project 
Multi-tenant SaaS platform for ISP operations management — billing, payments, inventory, technician job orders, and full accounting.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-04 17:11:11 +08:00