mirror of
https://github.com/siop-spelev/siop2.git
synced 2026-08-08 12:41:54 +00:00
76c2ccdfb1
Demande du référent : la génération opt-in devient réellement configurable. AI_GENERATION=off|api, AI_API_KEY (exigée en mode api — le boot refuse sinon, jamais loguée, /healthz n'expose que le mode), AI_MODEL (défaut claude-opus-4-8). generation.py : interface Generateur — GenerateurExtractif (contrat de base sans LLM) et GenerateurAPI (SDK officiel anthropic, dépendance optionnelle --extra generation, absente des tests/CI). Consigne : citations [n] obligatoires depuis les extraits anonymisés, jamais d'invention, rappel de validation humaine. Tout échec (refus du modèle, quota, réseau) retombe silencieusement sur l'extractif. 5 tests ajoutés (19 pytest) + .env.example. Vérifié en réel : boot refusé api-sans-clé, générateur construit, healthz sans secret. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
SIOP V2 — GMAO pour la maintenance d'ascenseurs
SIOP (Système Intégré d'Opérations de maintenance Préventive) est une GMAO complète dédiée à la maintenance d'ascenseurs, inspirée fonctionnellement d'Atlas CMMS et adaptée au métier (carnet d'intervention, périodicités réglementaires, PV signés, urgence « personne bloquée »), avec une couche IA différenciante.
Ce dépôt poursuit deux objectifs jumeaux :
- Le produit — une application web + mobile + IA complètement fonctionnelle, déployée en production (Dokploy).
- Le playbook — la documentation pédagogique de toutes les phases du cycle de vie logiciel (cadrage → design → architecture → développement → tests → production → formation), réutilisable comme support de cours et comme méthode d'entreprise.
V2 : refondation design-first du projet siop (v1, gelée — elle sert de référence de lecture). 100 % nouveau code.
Le playbook
| Phase | Dossier | Contenu |
|---|---|---|
| Vision | docs/00-vision | Charte projet, personas, benchmark Atlas |
| Cadrage | docs/01-cadrage | Releases, user-story map, exigences, risques |
| Design | docs/02-design | Charte graphique, design tokens, maquettes HD |
| Architecture | docs/03-architecture | ADRs, C4, modèle de données, contrat d'API |
| Développement | docs/04-developpement | Conventions, déroulé d'un sprint |
| Tests | docs/05-tests | Stratégie, plans, recettes par release |
| Production | docs/06-production | Runbook Dokploy, sauvegardes, sécurité |
| Formation | docs/07-formation | Manuels, supports, exercices étudiants |
Releases
R0 Fondations → R1 Référentiel → R2 Exploitation → R3 Gestion → R4 Mobile → R5 IA.
Règle : une release n'ouvre pas tant que la précédente n'est pas recettée et déployée.
Démarrage (à partir de R0)
nvm use && pnpm install
pnpm infra:up # PostgreSQL + Redis + MinIO (Docker)
pnpm dev
Projet mené par le Pr. Daaif (ENSET Mohammedia) avec ses étudiants, en partenariat avec SPELEV.