Wiki/docs/02-scope-etendu-cfa-agence.md

# Scope etendu — CFA + Agence + Internes

> **APPROVED le 2026-05-07 par Corentin** — Option B retenue (CFA + Agence via PERSONNE pivot).
> **Etudiants : non modelises en Baserow**, juste users Docmost avec spaces libres (heritent des templates et integrations qu'on construit).
> Refacto des docs Merise effectue dans la foulee.
> Date : 2026-05-07.
> Source : Document Fondateur Acadenice (KxvipVcxNV) lu sur le wiki.

## 1. Constat

Mon modele initial couvre uniquement le **CFA** (formations / blocs / modules / formateurs / heures). C'est partiel.

Acadenice est en realite **trois activites coordonnees** :

| Activite | Description | Entites cles |
|----------|-------------|--------------|
| **CFA** (Centre de Formation des Apprentis) | Formation : dev, graphisme, marketing, IoT, cybersec. Max 15 etudiants/classe. | FORMATION, BLOC, MODULE, FORMATEUR, ETUDIANT, INSCRIPTION |
| **AGENCE dev** | Developpement de projets pour clients reels. Les formateurs y bossent en parallele de leurs cours. | CLIENT, PROJET, TACHE, SITE_WEB, SERVEUR, INTERVENTION |
| **OPERATIONS internes** | RH, comm, batiment, evenements, vision strategique. | SALARIE, EVENEMENT, COMMUNICATION |

**Le lien clef** : un FORMATEUR est souvent aussi DEVELOPPEUR sur projets agence. Sa capacite annuelle se split entre les deux activites.

C'est ce qui fait l'ADN d'Acadenice (cf doc fondateur) — pas un detail qu'on peut ignorer.

## 2. Question structurante

**Le projet "formation-hub" doit-il modeliser :**

- **Option A — CFA only** (mon modele actuel) : on reste sur formation/heures formateurs. L'Agence et les Operations ont leurs propres outils (Linear/Notion/etc) ou ne sont pas modelises.
- **Option B — CFA + Agence unifies** : on ajoute le suivi projets clients. La capacite Formateur-Dev est tracee unifiee. Vue 360 d'une personne (cours + projets).
- **Option C — Toute l'organisation** : CFA + Agence + Internes. Outil ERP-leger complet.

Mon vote : **Option B**. Justification :
- Le lien CFA-Agence est central a la vision Acadenice (cf doc fondateur, section "Le lien agence-formation"). Le modeliser = capter la vraie valeur.
- L'Option C ajoute beaucoup de scope (RH, batiment, comm) qui ne tirent pas le projet vers ses objectifs immediats.
- L'Option A laisse de la valeur sur la table — la capacite Formateur-Dev est un differentiateur metier reel.

## 3. Extension du modele propose (Option B)

### 3.1 Nouvelle entite pivot : PERSONNE

```mermaid
classDiagram
    class Personne {
        +int id
        +string nom
        +string prenom
        +Email email
        +decimal capacite_annuelle_totale
        +decimal split_formation_pct
        +decimal split_agence_pct
        +Statut statut
    }
    class RoleFormateur {
        +decimal heures_attribuees_formation
        +decimal heures_restantes_formation
    }
    class RoleDeveloppeur {
        +decimal heures_attribuees_agence
        +decimal heures_restantes_agence
    }
    class RoleAdmin {
        +permissions[]
    }
    class RoleEtudiant {
        +Date date_inscription
        +Formation formation_courante
    }

    Personne "1" --> "0..*" RoleFormateur
    Personne "1" --> "0..*" RoleDeveloppeur
    Personne "1" --> "0..*" RoleAdmin
    Personne "1" --> "0..*" RoleEtudiant
```

Une PERSONNE peut cumuler plusieurs roles. La capacite annuelle est splittee entre formation et agence selon un pourcentage configurable.

### 3.2 Nouvelles entites Agence

```mermaid
erDiagram
    CLIENT ||--o{ PROJET : "1,N a"
    PROJET ||--o{ TACHE : "1,N comporte"
    TACHE ||--o{ INTERVENTION : "0,N realisee via"
    PERSONNE ||--o{ INTERVENTION : "0,N realise"
    PROJET }o--o{ SITE_WEB : "0,N livre"
    PROJET }o--o{ SERVEUR : "0,N deploie"

    CLIENT {
        int client_id PK
        string client_nom UNIQUE
        string client_contact_email
        string client_telephone
        text client_notes
        enum client_statut "prospect|actif|inactif|archive"
    }
    PROJET {
        int projet_id PK
        int projet_client_id FK
        string projet_nom
        decimal projet_charge_heures
        decimal projet_heures_realisees "rollup"
        date projet_date_debut
        date projet_date_fin_prevue
        enum projet_statut "devis|en_cours|livre|cloture|abandonne"
    }
    TACHE {
        int tache_id PK
        int tache_projet_id FK
        string tache_titre
        decimal tache_charge_heures
        decimal tache_heures_realisees "rollup"
        enum tache_statut "todo|in_progress|done|abandoned"
    }
    INTERVENTION {
        int intervention_id PK
        int intervention_tache_id FK
        int intervention_personne_id FK
        decimal intervention_heures
        date intervention_date
        text intervention_notes
    }
```

### 3.3 Modele global combine (CFA + Agence + Personne pivot)

```mermaid
erDiagram
    PERSONNE ||--o{ ATTRIBUTION : "FORMATEUR : enseigne"
    PERSONNE ||--o{ INTERVENTION : "DEVELOPPEUR : realise"
    PERSONNE ||--o{ INSCRIPTION : "ETUDIANT : suit"
    
    FORMATION ||--o{ BLOC : "contient"
    BLOC ||--o{ MODULE : "comprend"
    MODULE ||--o{ ATTRIBUTION : "attribue"
    
    CLIENT ||--o{ PROJET : "a"
    PROJET ||--o{ TACHE : "comporte"
    TACHE ||--o{ INTERVENTION : "realisee"
    
    FORMATION ||--o{ INSCRIPTION : "regroupe etudiants"
    
    PROJET }o--o{ FORMATION : "lien optionnel : projet pedagogique"
```

Le **lien optionnel PROJET ↔ FORMATION** capte le cas Acadenice ou des etudiants travaillent sur de vrais projets clients comme exercice pedagogique.

### 3.4 Capacite cumulee Personne

Pour une PERSONNE qui a plusieurs roles :

```
Personne.heures_attribuees_total = 
    SUM(ATTRIBUTION.heures_attribuees) WHERE attribution_personne_id = personne_id
  + SUM(INTERVENTION.heures) WHERE intervention_personne_id = personne_id

Personne.heures_restantes = 
    Personne.capacite_annuelle_totale - Personne.heures_attribuees_total
```

L'admin voit en un coup d'oeil sur la fiche d'un formateur-dev :
- Cours attribues : 400h
- Projets attribues : 600h
- Capacite totale : 1500h
- Restant : 500h

## 4. Impact sur les docs existants

| Doc | Impact | Effort refacto |
|-----|--------|---------------|
| 01 - Discovery | Mise a jour scope | 15 min |
| 02 - Decision Records | Ajouter ADR-006 sur l'extension scope | 15 min |
| 03 - Data Dictionary | Ajouter PERSONNE, CLIENT, PROJET, TACHE, INTERVENTION, ETUDIANT, INSCRIPTION | 1h |
| 04 - MCD | Etendre ER diagram, ajouter cardinalites | 30 min |
| 05 - MLD | Ajouter tables + FK | 30 min |
| 06 - UML Use Cases | Ajouter acteurs Developpeur, Client, et leurs UC | 30 min |
| 07 - State Diagrams | Ajouter cycle CLIENT, PROJET, TACHE | 30 min |
| 08 - MCT | Ajouter operations Agence | 1h |
| 09 - MOT | Ajouter ligne pour les ops Agence | 30 min |
| 10 - Class Diagram | Ajouter classes Personne, Client, Projet, Tache, Intervention | 30 min |
| 11 - Activity Diagrams | Detailler AD-04 et AD-05 | 30 min |

**Effort refacto total : ~6-7h** si Option B validee.

## 5. Impact sur l'implementation

Stack reste identique (Docmost + Baserow + bridge). Mais :

- Plus de tables Baserow (12 au lieu de 5)
- Bridge service plus important (gere la vue unifiee Personne)
- UI : tableaux de bord par personne (cours + projets en parallele)

Capacite estime ajout dev sur Phase 2 : **+2-3 semaines** par rapport au scope CFA-only.

## 6. Question pour validation

**Tu confirmes Option B ?**

- [ ] Option A — CFA only (mon modele actuel reste)
- [ ] **Option B — CFA + Agence (extension via PERSONNE pivot)** — ma recommandation
- [ ] Option C — Tout (CFA + Agence + Operations)
- [ ] Autre — tu precises

Si **Option B** : je refacto les docs (effort ~6-7h sur 1 session) et on continue sur le scope etendu.
Si **Option A** : on reste sur le CFA, et tu modelises l'Agence dans un autre projet plus tard.

Une autre validation a faire : **les "Etudiants" doivent-ils avoir leur propre entite dans Baserow** (avec inscription a une formation, suivi pedagogique, etc.) **ou rester juste des spaces Docmost** sans modelisation structuree ? C'est independant de A/B/C — choix metier orthogonal.