mirror of
https://github.com/siop-spelev/siop2.git
synced 2026-08-08 12:41:54 +00:00
docs(r0): kickoff SIOP V2 — vision, cadrage, charte graphique, maquettes HD
Refondation design-first du projet SIOP (v1 gelée) : - Playbook 00-vision (charte projet, personas, benchmark Atlas) - Playbook 01-cadrage (releases R0→R5 + DoD, user-story map, exigences, risques) - Playbook 02-design : charte graphique, tokens.css bi-thème (palettes analytics validées CVD/contraste par script), maquettes HD navigables (7 écrans dont démo-login DEMO_MODE, bilan codé, portail QR, mobile) Prochaine étape : validation des maquettes par le référent avant tout code. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
46
README.md
Normal file
46
README.md
Normal file
@@ -0,0 +1,46 @@
|
||||
# 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](https://github.com/grashjs/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** :
|
||||
|
||||
1. **Le produit** — une application web + mobile + IA complètement fonctionnelle,
|
||||
déployée en production (Dokploy).
|
||||
2. **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](https://github.com/siop-spelev/siop)
|
||||
> (v1, gelée — elle sert de référence de lecture). 100 % nouveau code.
|
||||
|
||||
## Le playbook
|
||||
|
||||
| Phase | Dossier | Contenu |
|
||||
| --- | --- | --- |
|
||||
| Vision | [docs/00-vision](docs/00-vision/) | Charte projet, personas, benchmark Atlas |
|
||||
| Cadrage | [docs/01-cadrage](docs/01-cadrage/) | Releases, user-story map, exigences, risques |
|
||||
| Design | [docs/02-design](docs/02-design/) | Charte graphique, design tokens, maquettes HD |
|
||||
| Architecture | [docs/03-architecture](docs/03-architecture/) | ADRs, C4, modèle de données, contrat d'API |
|
||||
| Développement | [docs/04-developpement](docs/04-developpement/) | Conventions, déroulé d'un sprint |
|
||||
| Tests | [docs/05-tests](docs/05-tests/) | Stratégie, plans, recettes par release |
|
||||
| Production | [docs/06-production](docs/06-production/) | Runbook Dokploy, sauvegardes, sécurité |
|
||||
| Formation | [docs/07-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)
|
||||
|
||||
```bash
|
||||
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.
|
||||
Reference in New Issue
Block a user