louispaulb
beb6ddc5e5
docs: reorganize into architecture/features/reference/archive folders
...
All docs moved with git mv so --follow preserves history. Flattens the
single-folder layout into goal-oriented folders and adds a README.md index
at every level.
- docs/README.md — new landing page with "I want to…" intent table
- docs/architecture/ — overview, data-model, app-design
- docs/features/ — billing-payments, cpe-management, vision-ocr, flow-editor
- docs/reference/ — erpnext-item-diff, legacy-wizard/
- docs/archive/ — HANDOFF-2026-04-18, MIGRATION, status-snapshots/
- docs/assets/ — pptx sources, build scripts (fixed hardcoded path)
- roadmap.md gains a "Modules in production" section with clickable
URLs for every ops/tech/portal route and admin surface
- Phase 4 (Customer Portal) flipped to "Largely Shipped" based on
audit of services/targo-hub/lib/payments.js (16 endpoints, webhook,
PPA cron, Klarna BNPL all live)
- Archive files get an "ARCHIVED" banner so stale links inside them
don't mislead readers
Code comments + nginx configs rewritten to use new doc paths. Root
README.md documentation table replaced with intent-oriented index.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-04-22 11:51:33 -04:00
louispaulb
41d9b5f316
feat: flow editor, Gemini QR scanner with offline queue, dispatch planning v2
...
Major additions accumulated over 9 days — single commit per request.
Flow editor (new):
- Generic visual editor for step trees, usable by project wizard + agent flows
- PROJECT_KINDS / AGENT_KINDS catalogs decouple UI from domain
- Drag-and-drop reorder via vuedraggable with scope isolation per peer group
- Chain-aware depends_on rewrite on reorder (sequential only — DAGs preserved)
- Variable picker with per-applies_to catalog (Customer / Quotation /
Service Contract / Issue / Subscription), insert + copy-clipboard modes
- trigger_condition helper with domain-specific JSONLogic examples
- Global FlowEditorDialog mounted once in MainLayout, Odoo inline pattern
- Server: targo-hub flow-runtime.js, flow-api.js, flow-templates.js
- ERPNext: Flow Template/Run doctypes, scheduler, 5 seeded system templates
- depends_on chips resolve to step labels instead of opaque "s4" ids
QR/OCR scanner (field app):
- Camera capture → Gemini Vision via targo-hub with 8s timeout
- IndexedDB offline queue retries photos when signal returns
- Watcher merges late-arriving scan results into the live UI
Dispatch:
- Planning mode (draft → publish) with offer pool for unassigned jobs
- Shared presets, recurrence selector, suggested-slots dialog
- PublishScheduleModal, unassign confirmation
Ops app:
- ClientDetailPage composables extraction (useClientData, useDeviceStatus,
useWifiDiagnostic, useModemDiagnostic)
- Project wizard: shared detail sections, wizard catalog/publish composables
- Address pricing composable + pricing-mock data
- Settings redesign hosting flow templates
Targo-hub:
- Contract acceptance (JWT residential + DocuSeal commercial tracks)
- Referral system
- Modem-bridge diagnostic normalizer
- Device extractors consolidated
Migration scripts:
- Invoice/quote print format setup, Jinja rendering
- Additional import + fix scripts (reversals, dates, customers, payments)
Docs:
- Consolidated: old scattered MDs → HANDOFF, ARCHITECTURE, DATA_AND_FLOWS,
FLOW_EDITOR_ARCHITECTURE, BILLING_AND_PAYMENTS, CPE_MANAGEMENT,
APP_DESIGN_GUIDELINES
- Archived legacy wizard PHP for reference
- STATUS snapshots for 2026-04-18/19
Cleanup:
- Removed ~40 generated PDFs/HTMLs (invoice_preview*, rendered_jinja*)
- .gitignore now covers invoice preview output + nested .DS_Store
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-04-22 10:44:17 -04:00
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
louispaulb
c6b2dd1491
refactor: extract composables from 5 largest files — net -1950 lines from main components
...
DispatchPage.vue: 1320→1217 lines
- Extract SbModal.vue + SbContextMenu.vue reusable components
- Extract useAbsenceResize composable
- Extract dispatch constants to config/dispatch.js
ProjectWizard.vue: 1185→673 lines (-43%)
- Extract useWizardPublish composable (270-line publish function)
- Extract useWizardCatalog composable
- Extract wizard-constants.js (step labels, options, categories)
SettingsPage.vue: 1172→850 lines (-27%)
- Extract usePermissionMatrix composable
- Extract useUserGroups composable
- Extract useLegacySync composable
ClientDetailPage.vue: 1169→864 lines (-26%)
- Extract useClientData composable (loadCustomer broken into sub-functions)
- Extract useEquipmentActions composable
- Extract client-constants.js + erp-pdf.js utility
checkout.js: 639→408 lines (-36%)
- Extract address-search.js module
- Extract otp.js module
- Extract email-templates.js module
- Extract project-templates.js module
- Add erpQuery() helper to DRY repeated URL construction
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-08 17:57:24 -04:00
