gigafibre-fsm/docs/PLATFORM-STRATEGY.md

Gigafibre Platform Strategy

Vision unifiée par département — Inspiré Calix CommandIQ / SmartTown

Avril 2026 — Document de planification stratégique

---

1. Inventaire des applications actuelles

Applications à CONSERVER (core platform)

App	URL	Rôle	Stack
ERPNext v16	erp.gigafibre.ca	Source de vérité (clients, facturation, équipement, tickets)	Python/PostgreSQL
Targo Ops	erp.gigafibre.ca/ops/	Console opérations internes (dispatch, clients, tickets, réseau)	Vue 3 / Quasar PWA
Targo Hub	msg.gigafibre.ca	Backend API, SSE temps réel, SMS, vision AI, magic links, page mobile tech	Node.js 20
Client Portal	client.gigafibre.ca	Self-service client (factures, support, catalogue)	Vue 3 / Quasar PWA
Website	www.gigafibre.ca	Site vitrine marketing, vérification d'adresse	React / Vite
Authentik (Client)	id.gigafibre.ca	SSO clients et staff	Docker
Traefik	—	Reverse proxy, TLS, routing	Docker
n8n	n8n.gigafibre.ca	Workflows automatisés (SMS, email, webhooks)	Docker

Applications à RETIRER (legacy / redondantes)

App	URL	Raison du retrait	Fonctionnalités à migrer	Statut migration
dispatch-app (legacy)	dispatch.gigafibre.ca	Remplacé par Ops /dispatch + page mobile /t/{token}	Timeline dispatch ✅, Mobile tech ✅, Magic links ✅, Catalogue équipement dans mobile ✅, Scan barcode ✅	Prêt à retirer
Targo Field App	(apps/field/)	Remplacé par page mobile lightweight /t/{token} servi par targo-hub	Job list ✅, Job detail ✅, Scan barcode ✅, Diagnostic (à évaluer)	Prêt à retirer
Oktopus CE (TR-069 ACS)	oss.gigafibre.ca	⚠️ Fait du TR-369 — pas d'alternative connue pour big data CPE temps réel	—	Conserver

Applications à NE PAS RETIRER

App	Raison
Authentik (Staff) auth.targo.ca	Activement utilisé — remplacement impossible à court terme
Legacy DB (MariaDB)	Migration incomplète (~20/160 tables). Données critiques encore exclusives : comptabilité, soumissions, accords, télécom, projets, consommation, fibre/IP
Oktopus CE	Seule solution TR-369 pour statut temps réel et big data des CPE clients

Applications PARALLÈLES (hors scope Gigafibre FSM)

App	Rôle	Note
Targo Backend/Frontend	RH/Feuilles de temps employés Targo	Projet séparé, pas de chevauchement
Infra-Map-Vue	Cartographie fibre topologique (poteaux, routes optiques)	À intégrer éventuellement dans Ops comme module réseau
Device Monitor	Monitoring devices (prototype)	Fonctionnalités à absorber par targo-hub OLT/SNMP

---

2. Fonctionnalités par département

MARKETING — Segmentation dynamique et ventes contextuelles

"Patterns and contextual signals are analyzed to dynamically segment audiences and identify upsell and cross-sell opportunities."

Données disponibles dans ERPNext aujourd'hui :

• Historique de facturation (115K+ factures) — panier moyen, ancienneté, churn risk
• Tickets de support (242K+) — fréquence des appels, types de problèmes récurrents
• Équipement installé (7 500+) — âge du modem, capacité Wi-Fi, nombre d'appareils
• Abonnements actifs (21K+) — services manquants (pas de TV, pas de VoIP)
• Données réseau (OLT, signal optique, débit) — qualité de service réelle

Stratégie upsell/cross-sell contextuelle :

Signal contextuel	Action marketing	Canal
Client avec Internet seulement + ticket "lenteur Wi-Fi"	Proposer routeur Wi-Fi 6 mesh + bornes extérieures	SMS personnalisé via Twilio
Client sans TV + visionnement Netflix détecté (DPI/QoS)	Offrir IPTV bundle à prix réduit	Email via Mailjet + bannière portail
Client avec ancien modem (>3 ans)	Upgrade gratuit vers ONT dernière gen	Notification push portail client
Client avec >3 tickets/mois	Offrir Support Prioritaire (10$/mois)	Appel proactif CSR
Déménagement détecté (changement adresse)	Offrir installation complète maison intelligente	Visite tech + catalogue domotique
Client fidèle >5 ans, 0 ticket	Programme fidélité : caméra d'entrée offerte	Lettre personnalisée + portail

Modules à développer :

Module	Description	Où
Segment Engine	Requêtes ERPNext automatisées qui tagguent les clients par segment (à risque, upsell TV, upgrade Wi-Fi, fidèle, nouveau)	n8n workflow + ERPNext Custom Script
Campaign Manager	Interface dans Ops pour créer/envoyer des campagnes SMS/email ciblées par segment	Ops app — nouveau module /campaigns
Smart Banners	Bannières contextuelles dans le portail client basées sur le profil	Client Portal — composant dynamique
QR Modem → Offre	QR code sur le modem → URL → détecte le client → affiche offres personnalisées	targo-hub page servie (comme /t/{token})

Produits domotique à offrir :

• Bornes Wi-Fi extérieures (mesh outdoor)
• Caméras d'entrée connectées (Doorbell IP)
• Thermostats intelligents
• Détecteurs de fumée/CO connectés
• Serrures intelligentes
• Hub domotique Zigbee/Z-Wave

---

OPERATIONS — Proactivité et résolution automatique

"Operations agent workforce works around the clock to proactively uncover and resolve issues, reducing outages and improving the subscriber experience."

Monitoring proactif actuel :

• OLT SNMP polling (targo-hub olt-snmp.js) — signal optique, statut ONU
• GenieACS TR-069 — paramètres CPE, reboots, firmware
• Traccar GPS — position techniciens en temps réel

Vision proactive à implémenter :

Détection	Action automatique	Notification
Signal optique ONU dégradé (<-25 dBm)	Créer ticket prioritaire + dispatch auto tech le plus proche	SMS client : "Nous avons détecté un problème, un technicien est en route"
ONT hors ligne >30 min (pas panne secteur)	Vérifier statut OLT, si OK → créer ticket	SMS client : "Votre connexion semble interrompue, nous investiguons"
Wi-Fi congestionné (>20 clients, canal saturé)	Push config optimale via TR-069 (changement canal auto)	Notification portail : "Nous avons optimisé votre Wi-Fi"
Latence >50ms vers gateway	Alert dispatch + diagnostic réseau auto	Rien (résolution silencieuse si possible)
Firmware CPE obsolète	Schedule mise à jour nocturne via GenieACS	Email : "Mise à jour de sécurité appliquée"
Panne OLT (multiple ONU down)	Créer incident majeur, notifier tous clients affectés en masse	SMS masse : "Panne détectée dans votre secteur, résolution en cours"

Modules existants vs à développer :

Module	Statut	Prochaine étape
Dispatch Timeline (drag-drop, Gantt)	✅ Complet	—
Tags/Compétences (match auto)	✅ Complet	—
Horaires + RRULE (garde, shifts)	✅ Complet	—
Publication SMS + magic links	✅ Complet	—
Page mobile tech lightweight	✅ Complet	—
Scan barcode + gestion équipement	✅ Complet	—
Pool d'offres Uber-style	✅ Complet	—
Confirmation unassign jobs publiés	✅ Complet	—
OLT SNMP monitoring	✅ Basique	Ajouter alertes automatiques
Proactive ticket creation	❌ À faire	n8n workflow : SNMP alert → create Issue
Auto-dispatch (matching algo)	❌ À faire	Algorithme basé sur tags + distance + charge
Outage detection + mass notify	❌ À faire	Corréler ONU down par OLT → SMS masse
CPE auto-config via TR-069	❌ À faire	GenieACS presets + targo-hub proxy

---

SERVICE — Intelligence contextuelle pour CSR et résolution au premier appel

"Specialized service agents share best practices and contextual insights to CSRs to solve problems faster and on the first call."

Données contextuelles disponibles pour le CSR (dans Ops app) :

• Historique complet du client (tickets, factures, paiements)
• Équipement installé avec diagnostics en temps réel (signal, Wi-Fi, devices connectés)
• Notes des techniciens sur les visites précédentes
• Statut réseau du secteur (panne en cours ?)
• Historique des interventions sur cette adresse

Outils d'aide CSR à développer :

Outil	Description	Impact
Client Context Card	Vue unifiée en 1 écran : abo actifs, dernier ticket, équipement, santé réseau, paiements en retard	Réduction temps d'appel de 40%
Diagnostic Auto	Bouton "Diagnostiquer" sur la fiche client → lance ping, speedtest, check signal ONU, vérifie firmware	Résolution 1er appel +30%
Knowledge Base contextuelle	Suggestions automatiques basées sur le type de problème : "Ce client a un HG8245H → vérifier le port LAN 4 connu pour défaillance"	Partage best practices
Script d'appel guidé	Flow interactif : symptôme → questions → diagnostic → solution → escalation si nécessaire	Uniformité du service
Historique interactions	Timeline unifiée : appels, SMS, emails, visites tech, modifications de compte	Contexte complet

État actuel vs cible :

Fonctionnalité	Statut
Fiche client avec équipement et tickets	✅ Ops /clients/:id
Détail équipement avec diagnostic OLT	✅ EquipmentDetail.vue
Envoi SMS/email depuis Ops	✅ Via targo-hub/Twilio
Historique thread de tickets	✅ Ops tickets module
Diagnostic auto (1 clic)	❌ À intégrer (GenieACS + SNMP)
Suggestions contextuelles AI	❌ À faire (Gemini sur historique tickets similaires)
Scripts d'appel guidés	❌ À faire

---

SUBSCRIBER — L'intelligence du support dans les mains du client

"Subscriber agents extend the reach of support organizations directly to subscribers with personalized upsell opportunities, optimization techniques, and outage information through the subscriber's app."

Portail client actuel (client.gigafibre.ca) :

• ✅ Consultation factures et historique
• ✅ Paiement Stripe
• ✅ Création/suivi de tickets
• ✅ Catalogue produits avec panier
• ✅ Auth SSO (id.gigafibre.ca)

Fonctionnalités Subscriber à ajouter :

Feature	Description	Priorité
QR Code sur modem	Étiquette QR collée sur le modem → URL msg.gigafibre.ca/q/{mac} → identifie le compte → envoie token SMS/email au propriétaire → accès gestion compte	🔴 Haute
Dashboard santé réseau	Vitesse actuelle, latence, uptime 30 jours, appareils connectés	🔴 Haute
Contrôle parental (langage naturel)	"Bloquer TikTok pour les enfants après 21h" → traduit en règles TR-069 → push au routeur	🟡 Moyenne
Notifications outage	Push/SMS automatique quand panne détectée dans le secteur, avec ETA résolution	🔴 Haute
Optimisation Wi-Fi	Conseils personnalisés : "Votre routeur est dans le sous-sol, déplacez-le au rez-de-chaussée pour +40% de couverture"	🟡 Moyenne
Self-diagnostic	Bouton "Tester ma connexion" → speedtest + vérification signal → rapport	🔴 Haute
Offres personnalisées	Bannières contextuelles : "Ajoutez la TV IPTV à votre forfait pour 20$/mois" basé sur profil	🟡 Moyenne
Gestion appareils	Liste des appareils connectés, renommer, bloquer, prioritiser	🟡 Moyenne
Historique consommation	Graphique de bande passante utilisée par jour/semaine/mois	🟢 Basse

---

3. QR Code Modem — Flow technique détaillé

Le QR code sur le modem est un game-changer pour l'expérience client. Flow :

┌─────────────────────────────────────────────────────────┐
│  ÉTIQUETTE QR SUR LE MODEM                              │
│  URL: msg.gigafibre.ca/q/{MAC_ADDRESS}                  │
└──────────────────────┬──────────────────────────────────┘
                       │
                       ▼
┌─────────────────────────────────────────────────────────┐
│  targo-hub GET /q/{mac}                                 │
│  1. Lookup Service Equipment par MAC                     │
│  2. Trouver le Customer lié                              │
│  3. Récupérer téléphone/email du Customer                │
│  4. Envoyer OTP 6 chiffres par SMS (Twilio)              │
│  5. Afficher page : "Code envoyé au 514-***-**89"        │
└──────────────────────┬──────────────────────────────────┘
                       │ Client entre le code OTP
                       ▼
┌─────────────────────────────────────────────────────────┐
│  POST /q/{mac}/verify  { otp: "123456" }                │
│  1. Vérifier OTP (Redis, TTL 5 min)                      │
│  2. Générer JWT session (24h)                            │
│  3. Servir page subscriber :                             │
│     - Santé réseau (signal, vitesse, uptime)             │
│     - Appareils connectés                                │
│     - Contrôle parental                                  │
│     - Offres personnalisées                              │
│     - Lien vers portail complet (client.gigafibre.ca)    │
└─────────────────────────────────────────────────────────┘

Avantages :

• Zéro mot de passe à retenir
• Accessible même par des clients non technologiques
• Le QR est physiquement chez le client → preuve de possession
• Upsell contextuel immédiat (le client est devant son modem)
• Support proactif : "Votre signal est faible, voulez-vous un diagnostic ?"

---

4. Architecture cible — Plateforme unifiée

                    ┌─────────────────────────┐
                    │     www.gigafibre.ca     │  Marketing
                    │    (React — vitrine)     │  Vérification adresse
                    └────────────┬────────────┘
                                 │
    ┌────────────────────────────┼────────────────────────────┐
    │                            │                            │
    ▼                            ▼                            ▼
┌─────────┐           ┌──────────────────┐          ┌──────────────────┐
│  Ops    │           │  Client Portal   │          │  Mobile Tech     │
│  App    │           │  (Vue/Quasar)    │          │  /t/{token}      │
│  (PWA)  │           │  client.gigafibre│          │  (HTML pur)      │
│         │           │                  │          │                  │
│ Dispatch│           │ Factures         │          │ Jobs du jour     │
│ Clients │           │ Paiements        │          │ Scan barcode     │
│ Tickets │           │ Support          │          │ GPS navigation   │
│ Réseau  │           │ Catalogue        │          │ Status update    │
│ Campagns│           │ QR Modem portal  │          │ Équipement CRUD  │
└────┬────┘           └────────┬─────────┘          └────────┬─────────┘
     │                         │                             │
     └─────────────────────────┼─────────────────────────────┘
                               │
                    ┌──────────▼──────────┐
                    │     targo-hub       │
                    │   (Node.js 20)      │
                    │                     │
                    │ SSE temps réel      │
                    │ SMS (Twilio)        │
                    │ Vision AI (Gemini)  │
                    │ Magic links / OTP   │
                    │ OLT SNMP polling    │
                    │ QR modem → auth     │
                    │ TR-069 proxy        │
                    │ Segment engine      │
                    └──────────┬──────────┘
                               │
                    ┌──────────▼──────────┐
                    │    ERPNext v16      │
                    │   (PostgreSQL)      │
                    │                     │
                    │ Customers  6,600+   │
                    │ Invoices   115K+    │
                    │ Equipment  7,500+   │
                    │ Tickets    242K+    │
                    │ Subscriptions 21K+  │
                    └──────────┬──────────┘
                               │
              ┌────────────────┼────────────────┐
              ▼                ▼                 ▼
        ┌──────────┐   ┌──────────┐      ┌──────────┐
        │ GenieACS │   │ Traccar  │      │ id.giga  │
        │ TR-069   │   │ GPS      │      │ Authentik │
        │ 7,500 CPE│   │ 46 techs │      │ SSO      │
        └──────────┘   └──────────┘      └──────────┘

---

5. Plan de retrait des applications legacy

Phase 1 — Immédiat (avril 2026)

Action	Risque	Validation
Retirer dispatch-app du docker-compose apps	Bas — toutes les features sont dans Ops + /t/{token}	Vérifier que les magic links SMS pointent vers msg.gigafibre.ca/t/
Retirer le container apps-dispatch-frontend-1	Bas	Confirmer qu'aucun bookmark/lien externe pointe vers dispatch.gigafibre.ca
Supprimer le repo dispatch-app de la CI	Aucun	—

Phase 2 — Court terme (mai 2026)

Action	Risque	Validation
Retirer apps/field/ du monorepo	Bas — /t/{token} couvre tout	Comparer features field vs /t/{token}
Migrer auth.targo.ca → id.gigafibre.ca pour n8n et Hub	Moyen — tester les flows n8n	Tester chaque workflow n8n post-migration
Éteindre legacy-db MariaDB	Bas — migration 100% complétée	Garder un dump SQL en backup
Évaluer retrait Oktopus CE vs intégration GenieACS	Moyen	Comparer fonctionnalités monitoring

Phase 3 — Moyen terme (été 2026)

Action	Risque	Validation
Absorber device-monitor dans targo-hub OLT SNMP	Bas	Vérifier couverture fonctionnelle
Intégrer infra-map-vue comme module Ops /network/map	Moyen	iframe ou migration Vue
Unifier Targo Backend avec targo-hub (si pertinent)	Élevé — évaluer	Audit des fonctionnalités RH

---

6. Métriques de succès par département

Département	KPI	Cible
Marketing	Taux de conversion upsell via portail/SMS	5% des clients ciblés
Marketing	Revenu additionnel par client (ARPU lift)	+8$/mois moyen
Operations	Tickets proactifs (créés avant appel client)	30% des incidents réseau
Operations	Temps moyen de résolution dispatch	<4h (actuellement ~8h)
Service	Résolution au premier appel (FCR)	75% (actuellement ~55%)
Service	Temps moyen d'appel CSR	<6 min (actuellement ~10 min)
Subscriber	Adoption portail self-service	40% des clients actifs
Subscriber	Réduction appels support via self-diagnostic	-25% volume appels

---

7. Analyse concurrentielle

Gaiia (gaiia.com) — Comparable principal

Canadian-founded (2021), YC-backed, $13.2M Series A. 40+ ISP customers.

Gaiia Module	Gigafibre Status
Workforce & Scheduling	Done (dispatch PWA)
Field Service App	Done (/t/{token} mobile)
Billing & Revenue	ERPNext (basic)
Customer Portal	Not built
Online Checkout	Not built
Network Monitoring	Oktopus CE + OLT SNMP
Workflow Builder	n8n

Avantages Gigafibre vs Gaiia

• Self-hosted / souverain (pas de frais par abonné)
• Full ERP (accounting, HR, inventory inclus)
• Dispatch board avancé (lasso, undo, auto-dispatch, route optimization)
• Open source — offrable à d'autres ISPs

Gaps à combler (vs Gaiia)

• Customer portal self-service
• Online checkout (Gaiia rapporte 6x conversion)
• Billing proration (mid-cycle changes)
• Auto travel time on dispatch

Industrie — Matrice comparative

Feature	Gaiia	Odoo FS	Zuper	Salesforce FS	Gigafibre
Target	ISP-specific	General	Telecom	Enterprise	ISP custom
Self-hosted	No	Yes	No	No	Yes
Pricing	Per-subscriber	$30/user	$50/user	$200/user	Free (OSS)
Dispatch drag-drop	Yes	Yes	Yes	Yes	Yes
GPS real-time	Yes	Limited	Yes	Yes	Yes (WS)
Equipment tracking	Yes	Yes	Yes	Yes	Yes
Customer portal	Yes	Yes	Yes	Yes	Not yet
Online checkout	Yes	No	No	No	Not yet

---

Document vivant — dernière mise à jour : 12 avril 2026