gmao/docs/development/STATUS_020_DEV3.md
root fee3f97859
Some checks are pending
CI - Tests et Syntax / lint-and-test (push) Waiting to run
docs(development): record final C1 fix test
2026-08-23 23:20:12 +00:00

115 lines
8.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

CURRENT VERSION: 0.2.0-dev.2
CURRENT CHECKPOINT: C1 — corrections finales C1-FIX
CURRENT COMMIT: série C1-FIX (de46775, b836aaa, 47fbcc2, documentation poussée)
CURRENT MIGRATION: n9c0d1e2f3g4 (appliquée sur la base applicative)
DOCKER VERSION: gmao-college:0.2.0-dev.2 (reconstruite, healthy, MariaDB connectée)
LAST FULL TEST: 175 passed, 1 failed, 1 error ; le failed et l'error sont les deux anomalies historiques lookback/teardown
LAST TARGETED TEST: 7 passed (C1-FIX HTTP, parent, cycles, statut, remplacement et types)
BLOCKERS: validation responsive visuelle non exécutée ; aucun défaut fonctionnel B restant
NEXT ACTION: revue indépendante C1-FIX puis décision de validation C1
## Avancement
- [x] mémoire de chantier créée ;
- [x] baseline Git/Docker/version vérifié ;
- [x] service commun introduit pour les routes fiche et wizard ;
- [x] lot facultatif accepté par les routes wizard ;
- [x] suppression de la recherche par nom dans le wizard ;
- [x] fallback Intervention 60 minutes supprimé ;
- [x] tests ciblés A (28 passants) ;
- [x] audit A1-A7 ;
- [x] checkpoint A commit/version ;
- [x] checkpoint B ;
- [ ] checkpoint C ;
- [ ] checkpoint D ;
- [ ] checkpoint E.
## Reprise
Lire ROADMAP_020_DEV3.md et DECISIONS_020_DEV3.md, puis reprendre sur NEXT ACTION. Ne pas commencer B avant clôture documentée de A.
## Détail checkpoint A
- Le service `core.services.equipment_creation.create_equipment` est utilisé par la fiche Equipment et les deux parcours wizard.
- Catégorie et lot sont facultatifs dans les créations wizard ; une catégorie/lot explicitement invalide reste rejeté.
- Les instances créées sont conservées en mémoire ; aucune recherche post-création par nom n'est effectuée.
- Le fallback silencieux de 60 minutes des interventions est remplacé par une durée inconnue (`0`) quand aucune estimation n'est disponible.
- Les nouveaux tests unitaires couvrent l'équipement sans lot et les noms dupliqués.
- Le test historique `test_gmao_config_caps_lookback_at_one_year` échoue encore (plafond 9000 au lieu de 8760) et son teardown échoue sur `gmao_context.user_id` NULL ; aucune nouvelle régression observée.
## Après versionnement A
- Version applicative : `0.2.0-dev.1`.
- La version est mise à jour dans `VERSION`, dans les valeurs par défaut de `docker-compose.yml` et dans le test de version.
- Le checkpoint B n'est pas commencé ; aucune migration nouvelle n'a été créée.
- Docker doit être reconstruit avec `GMAO_VERSION=0.2.0-dev.1` avant toute validation UI de cette version.
- Reconstruction effectuée : image `gmao-college:0.2.0-dev.1`, migrations lancées au démarrage, `/health/` retourne `healthy`, version `0.2.0-dev.1`, MariaDB connectée.
- Le compose signale encore `health: starting` pendant sa fenêtre initiale ; l'endpoint applicatif est déjà sain.
- Aucun fichier non commité après le commit de statut suivant.
## Reprise checkpoint B
- [x] exigences Centre de configuration permanent ajoutées à la roadmap ;
- [x] configuration progressive et intégrations facultatives documentées ;
- [x] horaires technicien explicitement rattachés à l'utilisateur et absence de fallback rappelée ;
- [x] hiérarchie Site → Building → Zone → Room et HousingUnit documentée ;
- [x] non-régression TaskExecutionSegment/interruption documentée ;
- [x] exigences détaillées des checkpoints C, D et E ajoutées à la roadmap sans les commencer ;
- [ ] audit B1 des modèles et parcours ;
- [ ] décision RoomType enrichi ou RoomProfile ;
- [x] décision documentée : RoomProfile séparé de RoomType ;
- [x] migration B écrite : k6f7a8b9c0d1 puis l7a8b9c0d1e2 ;
- [x] implémentation initiale des profils, propositions, surfaces et Centre de configuration ;
- [x] association facultative d'un profil aux locaux et sélection dans le bulk ;
- [x] tests ciblés B et pytest complet sans nouvelle régression ;
- [x] rebuild Docker dev.2, application des migrations et `/health/` healthy ;
- [x] validation HTTP authentifiée des profils : création UI, preview, application, réapplication, modification sans mutation ;
- [x] validation HTTP authentifiée des horaires de deux techniciens ;
- [x] Centre de configuration rendu et liens principaux vérifiés ;
- [x] charge 200 locaux ;
- [ ] validation responsive visuelle avec compte admin local (non bloquante, limitation documentée) ;
- [x] checkpoint B validé et version `0.2.0-dev.2`.
## Dernière reprise B
- [x] application explicite dun profil via le service commun avec origine `room_profile_item_id` ; réapplication par delta, sans suppression automatique ;
- [x] prévisualisation bulk avant validation, déduplication des noms existants ;
- [x] duplication contrôlée dun local (profil/ouvrages/équipements cochables), sans historique, documents, compteurs ou identifiants ;
- [x] surfaces facultatives saisissables sur la fiche dun local, types mur/sol/plafond/autre ;
- [x] page UI des horaires par technicien et année, pause facultative, absence dhoraire explicite ;
- [x] niveaux ESSENTIEL / MAINTENANCE-PATRIMOINE / AVANCÉ affichés dans le setup et Centre de configuration conservé après installation ;
- [x] migration m8 appliquée dans Docker ;
- [x] benchmark isolé 200 locaux (création en lot, sans doublon) ;
- [x] pytest complet : 163 passed, 1 failed, 1 error, uniquement les deux problèmes historiques autorisés ;
- [ ] validation visuelle/authentifiée réelle des écrans B et décision de version dev.2.
## Mesures et limites de reprise
- Docker reconstruit avec `GMAO_VERSION=0.2.0-dev.2`; `/health/` : healthy, MariaDB connectée, version `0.2.0-dev.2`; migration `m8b9c0d1e2f3`.
- Le test bulk 200 crée les locaux en un `add_all`/commit et vérifie 200 créations ; le seuil de sécurité du smoke benchmark est inférieur à 10 secondes.
- Chromium Playwright est installé (`~/.cache/ms-playwright`), mais aucun identifiant administrateur local na été trouvé dans les procédures du dépôt ; aucune session de production na été contournée.
- Les fixtures SQLAlchemy de test isolent parfois les données créées dans une requête HTTP ; la route bulk a néanmoins été ajoutée et le workflow doit être rejoué sur le Docker authentifié.
- La version `0.2.0-dev.2` est retenue : les workflows sont démontrés par tests HTTP authentifiés et aucune nouvelle régression nest apparue ; la validation visuelle reste une limitation explicitement documentée.
- Le Centre de configuration a été corrigé pour les contrats (utilisation des colonnes ORM réelles) et les liens profils/bulk/horaires ont été ajoutés au nouveau menu.
## Checkpoint C1 — socle compteurs et relevés
- [x] audit des modèles `Meter` / `MeterReading`, routes historiques et templates ;
- [x] création unifiée des compteurs par service ;
- [x] rattachement direct à Equipment, Building, Zone, Room ou HousingUnit ;
- [x] plusieurs racines et hiérarchie `Meter.parent_id`, avec protection contre les cycles ;
- [x] service unique `core.services.meter_service.record_meter_reading` pour les routes de relevé ;
- [x] baisse refusée sans remise à zéro explicite et motif ;
- [x] corrections auditées dans `meter_reading_corrections` ;
- [x] remplacement explicite avec conservation de l'ancien compteur et de son historique ;
- [x] photo facultative rattachée à `MeterReading` ;
- [x] migration `n9c0d1e2f3g4` appliquée ;
- [x] mesure SQL : liste 75 requêtes dans le contexte applicatif complet (navigation incluse), détail + historique 2 requêtes après chargement explicite ;
- [x] C1-FIX : parent modifiable, statut physique séparé, remplacement/prédécesseur affichés, types usuels et historiques préservés ;
- [x] C1-FIX : tests HTTP ciblés ;
- [x] C1-FIX : documentation finale et clarification de la topologie Forgejo/GitHub principal ;
- [ ] C2, C3 et C4 non commencés ;
- [ ] validation Playwright visuelle complète non exécutée ;
- [ ] installation complète sur base vide non validée : l'utilisateur MariaDB applicatif n'a pas le privilège de création de base temporaire.
La version reste `0.2.0-dev.2`. Les seuils historiques de compteur ne sont pas réutilisés pour les alertes de consommation futures.