Principes directeurs
Les décisions structurantes qui contraignent toutes les autres — acheter le chat, construire les connecteurs, tout en Nix, lecture par défaut.
Ces principes priment sur les choix locaux. Quand un arbitrage se présente, on tranche dans leur sens.
1. Acheter le chat, construire les connecteurs
Le modèle de langage et l'interface de chat sont une commodité qui évolue plus vite que nous ne pourrions suivre. La valeur de SOFRA est dans la glue : connaître Sage, Yooz, Bazimo, les mentions obligatoires, les cas d'usage RFE. On investit donc tout l'effort d'ingénierie dans les connecteurs et les services, pas dans le chat.
→ Voir Le chat IA.
2. MCP comme contrat unique
Tout ce que la plateforme expose au chat est un outil MCP. Connecteurs et services parlent le même protocole. Conséquence : on peut changer de chat (Claude → Mistral) sans rien réécrire côté plateforme, et un nouveau service est immédiatement utilisable par le chat dès qu'il publie ses outils MCP.
→ Voir Connecteurs MCP.
3. Suivre la réforme, ne pas la doubler
La RFE re-plateformise déjà le SI (Sage V12, Sage Network, Yooz harmonisé). On branche l'IA sur les nouvelles API issues de ce chantier ; on ne construit pas de connecteur sophistiqué sur la V8.10 fichier qui va disparaître. Là où la réforme ne résout rien (dédoublonnage tiers, classification B2B/B2C, outils legacy sans API), c'est exactement là que l'IA crée de la valeur.
4. Lecture par défaut, écriture sur autorisation
Un connecteur est livré en lecture seule. Toute capacité d'écriture (créer un tiers, émettre une facture, lancer un paiement) est un outil distinct, explicitement activé, journalisé, et soumis à une politique au niveau du hub.
→ Voir Sécurité & données.
5. Reproductible par construction (Nix)
Pas de serveur « pet » configuré à la main. Chaque connecteur/service est un flake,
chaque serveur est une config NixOS versionnée. Un déploiement est nixos-rebuild,
un rollback est instantané. Même pattern que nos sites de documentation.
→ Voir Déploiement NixOS.
6. Déterministe quand c'est possible, IA quand c'est nécessaire
Les calculs (TVA, IS, prorata, mentions obligatoires, génération FEC/Factur-X) sont du
code déterministe et testé, pas des réponses de modèle. L'IA orchestre, interprète
le langage naturel et tranche les cas ambigus ; elle n'invente pas un montant. Ce
principe est déjà celui de paperasse (scripts calc.js, generate-fec.js, validateurs).
7. Capitaliser sur l'existant
paperasse (skills métier français) et paperasse-mcp (serveur MCP Go : Qonto/Stripe,
FEC, Factur-X, validation des mentions) sont le point de départ, pas une feuille
blanche. On étend ce socle aux systèmes SOFRA plutôt que de repartir de zéro.
8. Souveraineté et traçabilité des données
Données financières et personnelles : hébergement maîtrisé (NixOS chez nous / cloud souverain), résidence des données en UE, journalisation exhaustive, archivage à valeur probante. Le choix du modèle de chat tient compte de la résidence des données.