gigafibre-fsm/docs/ROADMAP.md
louispaulb 607ea54b5c refactor: reduce token count, DRY code, consolidate docs
Backend services:
- targo-hub: extract deepGetValue to helpers.js, DRY disconnect reasons
  lookup map, compact CAPABILITIES, consolidate vision.js prompts/schemas,
  extract dispatch scoring weights, trim section dividers across 9 files
- modem-bridge: extract getSession() helper (6 occurrences), resetIdleTimer(),
  consolidate DM query factory, fix duplicate username fill bug, trim headers
  (server.js -36%, tplink-session.js -47%, docker-compose.yml -57%)

Frontend:
- useWifiDiagnostic: extract THRESHOLDS const, split processDiagnostic into
  6 focused helpers (processOnlineStatus, processWanIPs, processRadios,
  processMeshNodes, processClients, checkRadioIssues)
- EquipmentDetail: merge duplicate ROLE_LABELS, remove verbose comments

Documentation (17 → 13 files, -1,400 lines):
- New consolidated README.md (architecture, services, dependencies, auth)
- Merge ECOSYSTEM-OVERVIEW into ARCHITECTURE.md
- Merge MIGRATION-PLAN + ARCHITECTURE-COMPARE + FIELD-GAP + CHANGELOG → MIGRATION.md
- Merge COMPETITIVE-ANALYSIS into PLATFORM-STRATEGY.md
- Update ROADMAP.md with current phase status
- Delete CONTEXT.md (absorbed into README)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-13 08:39:58 -04:00

2.0 KiB

Gigafibre FSM — Roadmap

Phase 1 — Foundation (Done, March 2026)

  • ERPNext v16 + PostgreSQL
  • Custom FSM doctypes (Service Location, Equipment, Subscription)
  • Dispatch doctypes (Job, Technician, Tag with skill levels)
  • Dispatch PWA with timeline, drag-drop, Mapbox map
  • GPS tracking (Traccar hybrid REST + WebSocket)
  • Authentik SSO (forwardAuth)
  • ERPNext API proxy (nginx same-origin)
  • Legacy migration (6,667 customers, 21K subs, 115K invoices, 242K tickets)

Phase 2 — Ops App (Done, March 2026)

  • Unified ops PWA (erp.gigafibre.ca/ops/)
  • Client list/detail with inline editing (Odoo-style)
  • Dispatch module + ticket management
  • Equipment tracking with OLT/SNMP diagnostics
  • SMS/Email notifications (Twilio + Mailjet)
  • Invoice OCR (Ollama Vision)
  • Field tech mobile (/t/{token})
  • Authentik federation (staff → client SSO)
  • Modem-bridge (Playwright headless for TP-Link ONU diagnostics)
  • WiFi diagnostic panel (mesh topology, client signal, packet loss)

Phase 3 — Workflows & Automation (In Progress)

  • Tag technicians with skills (46 techs to tag)
  • Wire auto-dispatch (cost-optimization matching)
  • Issue → Dispatch Job creation
  • Job completion → equipment status + close ticket
  • Equipment swap → inventory log
  • n8n escalation workflows
  • Twilio 10DLC production upgrade
  • SLA tracking

Phase 4 — Customer Portal

  • Self-service app (invoices, tickets, equipment)
  • Stripe payments
  • Online appointment booking
  • Real-time tech tracking SMS
  • Legacy password migration (MD5 → PBKDF2)
  • QR code modem → subscriber dashboard

Phase 5 — Advanced Features

  • Van stock inventory per tech
  • Revenue analytics (MRR, churn, ARPU)
  • Proactive monitoring (auto-ticketing)
  • Online checkout (e-commerce signup)
  • Marketing segmentation + campaigns
  • Tech performance dashboards
  • Preventive maintenance scheduling