Principes de conception
Ce sont les principes du moteur analytique jinflow.core — le framework générique que les domain packs instancient pour des secteurs spécifiques (par ex. santé, viticulture, logistique). Quatre valeurs fondamentales définissent l’identité ; dix-huit principes les implémentent.
Les quatre valeurs
Section intitulée « Les quatre valeurs »| Valeur | Devise | Principes supportés |
|---|---|---|
| Declarative | Vous déclarez ce qu’il faut détecter. Le moteur fait le reste. | #9 Compilation YAML-to-SQL, #3 Contract-First, #8 Metadata-Driven, #16 Généralisation pragmatique |
| Transparent | Rien n’est caché. Tout est interrogeable et reconstructible. | #4 Pas de filtrage silencieux, #6 Reconstructible par défaut, #17 Calibré pas juste testé, #1 Architecture en couches |
| Independent | Les mondes, tenants et couches ne se bloquent pas mutuellement. | #18 Évolution parallèle, #7 Traitement et exploration indépendants, #5 Isolation tenant, #2 Agnosticisme système source |
| Human | Les personnes décident. L’IA assiste. Le savoir est capturé. | #10 Humain dans la boucle, #11 IA comme SME, #12 IA comme collègue, #13 Pas d’IA dans le chemin de données, #14 Confidentialité, #15 Trilingue |
Les 18 principes ci-dessous sont l’implémentation. Ces 4 valeurs sont l’identité. Si une décision de conception s’aligne avec les principes mais viole une valeur, la valeur gagne.
Les 18 principes
Section intitulée « Les 18 principes »1. Architecture en couches
Section intitulée « 1. Architecture en couches »Bronze est la structure. Silver est la vérité métier. Gold est la consommation.
Trois couches medallion avec des frontières de responsabilité strictes. Pas de références vers le haut — les dépendances coulent vers le bas uniquement.
2. Agnosticisme système source
Section intitulée « 2. Agnosticisme système source »Dispatch une fois, à Bronze. Puis oubliez d’où viennent les données.
3. Contract-First
Section intitulée « 3. Contract-First »Des schémas JSON versionnés définissent chaque frontière.
4. Pas de filtrage silencieux
Section intitulée « 4. Pas de filtrage silencieux »Les lignes invalides sont signalées, jamais supprimées.
5. Isolation tenant
Section intitulée « 5. Isolation tenant »Schéma par tenant. Les données ne se mélangent jamais.
6. Reconstructible par défaut
Section intitulée « 6. Reconstructible par défaut »La base de données analytique est éphémère.
7. Traitement et exploration sont indépendants
Section intitulée « 7. Traitement et exploration sont indépendants »Ils partagent un Contract, pas un runtime.
8. Piloté par les métadonnées, pas codé en dur
Section intitulée « 8. Piloté par les métadonnées, pas codé en dur »Assumer le schéma, pas le contenu.
9. Compilation YAML-to-SQL
Section intitulée « 9. Compilation YAML-to-SQL »Un pattern de compilateur pour tout.
10. Humain dans la boucle par défaut
Section intitulée « 10. Humain dans la boucle par défaut »Le système détecte et explique. Les humains décident et agissent.
11. IA comme expert métier
Section intitulée « 11. IA comme expert métier »L’IA capture les connaissances métier. Le pipeline les exécute.
12. IA comme collègue de programmation
Section intitulée « 12. IA comme collègue de programmation »Le codebase est AI-native.
13. Pas d’IA dans le chemin de données
Section intitulée « 13. Pas d’IA dans le chemin de données »Zéro appel LLM en production.
14. Confidentialité par conception
Section intitulée « 14. Confidentialité par conception »Tous les ID sont des tokens pseudonymisés.
15. Trilingue dès le premier jour
Section intitulée « 15. Trilingue dès le premier jour »Chaque chaîne destinée à l’utilisateur existe en DE/FR/EN.
16. Généralisation pragmatique
Section intitulée « 16. Généralisation pragmatique »80% générique, 20% spécifique au domaine. Garder ce ratio.
17. Calibré, pas juste testé
Section intitulée « 17. Calibré, pas juste testé »Les tenants synthétiques portent des défauts délibérément injectés.
18. Évolution parallèle (P/T-Worlds)
Section intitulée « 18. Évolution parallèle (P/T-Worlds) »Le pipeline et les instruments évoluent continuellement et indépendamment.
Le P-world (Pipeline) et le T-world (Talk) sont deux pistes d’évolution parallèles partageant une interface stable : Entity + Contract.
Pour le texte complet de chacun des 18 principes, voir la version anglaise.