Wiki/docs/08-merise-mct.md

MCT — Modele Conceptuel de Traitements

Vue dynamique des operations metier. Complete le MCD (statique) et les state diagrams (cycles de vie). Methodologie : Merise. Chaque operation = evenement declencheur + regle de synchronisation + actions + evenement resultat.

1. Conventions

• Evenement : un fait survenant dans le systeme, declenche une operation. Note EV-XX.
• Operation : traitement metier qui transforme un etat. Note OP-XX.
• Regle de synchronisation : condition logique sur les evenements entrants (AND/OR).
• Regle d'emission : condition sur les evenements de sortie selon le resultat.

2. Liste des evenements

Code	Evenement	Origine
EV-01	Demande creation formation	Admin
EV-02	Specs blocs renseignees	Admin
EV-03	Specs modules renseignees	Admin
EV-04	Demande attribution module	Admin
EV-05	Formateur dispo (capacite >= heures requises)	System (calcul)
EV-06	Date debut module atteinte	System (cron)
EV-07	Saisie heures realisees	Formateur
EV-08	Date fin module atteinte	System (cron)
EV-09	Demande annulation attribution	Admin
EV-10	Rollup recalcule	System (auto)
EV-11	Capacite formateur depassee	System (calcul)
EV-12	Demande archivage formation	Admin
EV-13	Tous modules d'une formation realises	System (calcul)
EV-14	Demande edition page wiki	Admin / Formateur
EV-15	Lien partage cree	Admin

3. Liste des operations

Code	Operation	Acteur principal
OP-01	Creer une formation	Admin
OP-02	Decomposer en blocs et modules	Admin
OP-03	Attribuer un module a un formateur	Admin
OP-04	Saisir heures realisees	Formateur
OP-05	Annuler une attribution	Admin
OP-06	Cloturer un module	System / Admin
OP-07	Cloturer une formation	System / Admin
OP-08	Recalculer rollups	System (auto)
OP-09	Notifier depassement capacite	System (auto)
OP-10	Archiver une formation	Admin
OP-11	Generer rapport formation	Admin
OP-12	Generer rapport formateur	Admin
OP-13	Inviter client par lien partage	Admin
OP-14	Backup quotidien	System (cron)

4. Operations detaillees

OP-01 — Creer une formation

flowchart TD
    EV01([EV-01 Demande creation formation]) --> SYNC1{Regle sync:<br/>EV-01 saisi}
    SYNC1 --> OP01[OP-01 Creer formation]
    OP01 -->|Validation OK| EV_OUT_OK([EV: Formation creee statut=draft])
    OP01 -->|Nom deja existant| EV_OUT_ERR([EV: Erreur saisie])

• Entrants : EV-01
• Synchro : EV-01 saisi
• Actions :
  1. Valider unicite du nom
  2. Valider heures_totales > 0
  3. INSERT formation avec statut = draft, timestamps auto
• Sortants :
  • Si OK → "Formation creee" (statut = draft)
  • Si erreur → "Erreur saisie"

OP-03 — Attribuer un module a un formateur

flowchart TD
    EV04([EV-04 Demande attribution]) --> SYNC2{AND}
    EV05([EV-05 Formateur dispo]) --> SYNC2
    SYNC2 --> OP03[OP-03 Creer attribution]
    OP03 -->|RG-01 OK| EV_ATTR([EV: Attribution creee statut=planifie])
    OP03 -->|RG-01 KO| EV_BLOCK([EV: Erreur depassement heures module])
    EV_ATTR --> OP08_TRIG[Trigger OP-08 Recalculer rollups]

• Entrants : EV-04 AND EV-05
• Synchro : les deux evenements presents (formateur dispo verifie avant ouverture du formulaire)
• Actions :
  1. Valider RG-01 : SUM(attributions.heures) + nouvelle_attribution.heures <= module.heures_prevues
  2. Valider RG-02 : warning si formateur.heures_attribuees + nouvelle.heures > formateur.capacite (mais pas blocage)
  3. INSERT attribution avec statut = planifie
  4. Declenche EV-10 (rollup recalcule)
• Sortants :
  • Si OK → "Attribution creee" + EV-10
  • Si RG-01 KO → "Erreur depassement"
  • Si RG-02 warning → "Attribution creee" + "Warning capacite"

OP-04 — Saisir heures realisees

• Entrants : EV-07 (saisie formateur)
• Synchro : EV-07 ET attribution.statut IN (planifie, en_cours)
• Actions :
  1. Valider RG-05 : heures_realisees <= heures_attribuees + tolerance
  2. UPDATE attribution.heures_realisees
  3. Si heures_realisees == heures_attribuees → attribution.statut = realise
  4. Declenche EV-10 (rollup recalcule)
• Sortants : "Heures saisies" + EV-10. Si RG-05 KO → "Erreur depassement heures"

OP-06 — Cloturer un module

• Entrants : EV-08 OR EV-13
• Synchro :
  • EV-08 (date fin atteinte) ET module.statut = en_cours
  • OU manuel admin via bouton "Marquer realise"
• Actions :
  1. Verifier : toutes attributions du module en realise ou annule
  2. UPDATE module.statut = realise
  3. Si tous les modules de la formation = realise → declenche EV-13
• Sortants : "Module cloture"

OP-07 — Cloturer une formation

• Entrants : EV-13 (tous modules realises) ET formation.date_fin atteinte
• Synchro : AND des deux
• Actions : UPDATE formation.statut = termine
• Sortants : "Formation terminee"

OP-08 — Recalculer rollups

• Entrants : EV-10 (toute modification de attribution, module, bloc, formation)
• Actions :
  1. Recalcul cascadant : attribution → module → bloc → formation
  2. Recalcul formateur.heures_attribuees / heures_restantes
  3. Si formateur.heures_restantes < 0 → declenche EV-11
• Sortants : "Rollups a jour" + EV-11 si depassement

OP-09 — Notifier depassement capacite

• Entrants : EV-11
• Actions :
  1. Identifier admins du workspace
  2. Envoyer notification (email + dans-app) avec details
• Sortants : "Notification envoyee"

5. Diagramme global du flux

flowchart TD
    EV01([EV-01]) --> OP01[OP-01 Creer formation]
    OP01 --> EV02_PRE([Formation creee])
    
    EV02_PRE --> OP02[OP-02 Decomposer en blocs/modules]
    OP02 --> EV_MOD([Modules crees a_attribuer])
    
    EV_MOD --> OP03[OP-03 Attribuer module]
    OP03 --> EV_ATTR_OK([Attribution planifie])
    EV_ATTR_OK --> OP08[OP-08 Recalcul rollups]
    
    EV06([EV-06 Date debut]) --> EV_EN_COURS([Module en_cours])
    EV_EN_COURS --> OP04[OP-04 Saisie heures realisees]
    OP04 --> OP08
    
    OP04 --> EV_REAL([Module realise])
    EV_REAL --> OP06[OP-06 Cloturer module]
    
    OP06 --> EV13([EV-13 Tous modules realises])
    EV13 --> OP07[OP-07 Cloturer formation]
    OP07 --> EV_TERM([Formation terminee])
    
    OP08 --> EV11{Capacite<br/>depassee?}
    EV11 -->|Oui| OP09[OP-09 Notifier admin]

6. Operations secondaires

Operation	Trigger	Frequence
OP-11 Generer rapport formation	Demande admin	A la demande
OP-12 Generer rapport formateur	Demande admin	A la demande
OP-13 Inviter client	Demande admin	A la demande
OP-14 Backup	Cron quotidien	1x/jour

7. Operations Agence (extension scope B)

Code	Operation	Acteur principal	Trigger
OPA-01	Creer client	Admin	Manuel
OPA-02	Creer projet	Admin	Devis signe
OPA-03	Decomposer projet en taches	Admin	Apres creation projet
OPA-04	Attribuer tache a un developpeur	Admin	Manuel
OPA-05	Saisir intervention	Developpeur	Apres travail effectue
OPA-06	Marquer tache done	Developpeur ou Admin	Validation
OPA-07	Cloturer projet	Admin	Toutes taches done + livraison validee
OPA-08	Recalculer rollups Agence	System	Sur evenement (intervention modifiee)
OPA-09	Lier projet a formation pedagogique	Admin	Optionnel, sur fiche projet
OPA-10	Recalculer capacite Personne (formation + agence)	System	Sur evenement (attribution OU intervention modifiee)

OPA-05 — Saisir intervention (developpeur)

• Entrants : Developpeur ouvre l'app + selectionne tache
• Synchro : Personne.roles contient developpeur ET tache.statut != abandoned/done
• Actions :
  1. Valider intervention_heures > 0
  2. INSERT intervention statut realise
  3. Declenche OPA-08 + OPA-10 (recalcul rollups)
• Sortants : "Intervention saisie" + "Rollups a jour"

OPA-10 — Recalculer capacite Personne unifiee

C'est une evolution de l'OP-08 du MCT initial. Maintenant que Personne pivot existe :

Personne.heures_attribuees_formation = SUM(ATTRIBUTION.heures_attribuees) WHERE personne ET statut != annule
Personne.heures_attribuees_agence    = SUM(INTERVENTION.heures)            WHERE personne ET statut != annule
Personne.heures_restantes_total      = capacite_annuelle - heures_attribuees_formation - heures_attribuees_agence

Si heures_restantes_total < 0 → declenche notification depassement (OP-09 etendu pour capacite totale).

8. Questions ouvertes (a valider en MOT)

• OP-04 (saisie heures) : declenchee quand par le formateur ? En fin de session ? En fin de mois ?
• OP-06/OP-07 : cloture automatique a la date fin OU manuelle apres validation admin ?
• OP-09 (notification depassement) : warning soft ou blocage dur ? Email + Slack/Teams ?
• OP-11/OP-12 (rapports) : format PDF, CSV, Excel ? Push vers comptabilite ?
• OP-08 (rollups) : tolerance de delai acceptable ? Eventual consistency OK ou TR strict ?