# MPD — Modele Physique de Donnees (Baserow)

> Implementation concrete dans Baserow : 9 tables avec types exacts, formules, vues, permissions.
> Ce doc est **actionnable** : Corentin l'ouvre cote a cote avec Baserow et cree les tables une par une.
> Source : `07-merise-mld.md` (MLD relationnel) + `05-data-dictionary.md`.

## 1. Setup initial

### 1.1 Hierarchie Baserow

```
Workspace : Acadenice formation-hub
└── Database : formation-hub
    ├── Tables CFA : formation, bloc, module, attribution
    ├── Tables Agence : client, projet, tache, intervention
    └── Table pivot : personne
```

### 1.2 Order de creation (dependances FK)

Creer les tables dans cet ordre — chaque table dependant des precedentes via FK :

1. **personne** (aucune dep)
2. **client** (aucune dep)
3. **formation** (aucune dep)
4. **bloc** (FK → formation)
5. **projet** (FK → client, optionnel FK → formation)
6. **module** (FK → bloc)
7. **tache** (FK → projet)
8. **attribution** (FK → module + personne)
9. **intervention** (FK → tache + personne)

### 1.3 Conventions Baserow

| Concept | Implementation Baserow |
|---------|------------------------|
| ID auto-increment (PK) | Baserow `id` natif (genere auto) |
| Nom du field | `snake_case`, prefixes par mnemonique d'entite (ex `formation_nom`, `personne_email`) |
| Field "Primary" | Baserow oblige a avoir un Primary field — choisir le nom le plus explicite (ex `formation_nom`) |
| Foreign Key | Field type `Link to table` |
| ENUM | Field type `Single select` avec options exactes |
| MULTI ENUM | Field type `Multiple select` |
| Champ calcule (formula) | Field type `Formula` |
| Champ derive d'une relation | Field type `Lookup` ou `Count` |
| Audit timestamps | Fields `Created on` + `Last modified time` natifs |
| Audit acteur | Fields `Created by` + `Last modified by` natifs |

### 1.4 API token

Apres creation des tables :
- Settings → API tokens → Create token
- Permissions : `read`/`create`/`update`/`delete` sur la database `formation-hub`
- Stocker dans `.env` cote bridge : `BASEROW_API_TOKEN=...`

---

## 2. Table `personne`

**Primary field** : `personne_nom` (texte affiche par defaut dans les links)

| # | Field | Type Baserow | Parametres | Description |
|---|-------|-------------|------------|-------------|
| 1 | `personne_nom` | Text | — | Nom de famille (Primary) |
| 2 | `personne_prenom` | Text | — | Prenom |
| 3 | `personne_email` | Email | — | Email pro (unique recommande, validation cote bridge) |
| 4 | `personne_telephone` | Phone number | — | Telephone (optionnel) |
| 5 | `personne_capacite_annuelle` | Number | Decimal places: 2 | Heures totales/an |
| 6 | `personne_split_formation_pct` | Number | Decimal places: 1, default 50 | % capacite alloue formation |
| 7 | `personne_split_agence_pct` | Number | Decimal places: 1, default 50 | % capacite alloue agence |
| 8 | `personne_roles` | Multiple select | Options: `formateur`, `developpeur`, `admin`, `direction`, `support` | Roles cumules |
| 9 | `personne_statut` | Single select | Options: `actif` (default), `inactif` | Statut |
| 10 | `personne_attributions` | Link to table | Lien vers `attribution` (champ inverse auto-cree apres creation de attribution) | Toutes les attributions de cette personne |
| 11 | `personne_interventions` | Link to table | Lien vers `intervention` (apres creation) | Toutes les interventions |
| 12 | `personne_heures_attribuees_formation` | Formula | `sum(lookup('personne_attributions', 'attribution_heures_attribuees_active'))` | Rollup des attributions actives |
| 13 | `personne_heures_attribuees_agence` | Formula | `sum(lookup('personne_interventions', 'intervention_heures_active'))` | Rollup des interventions actives |
| 14 | `personne_heures_restantes_formation` | Formula | `(field('personne_capacite_annuelle') * field('personne_split_formation_pct') / 100) - field('personne_heures_attribuees_formation')` | Capacite formation restante |
| 15 | `personne_heures_restantes_agence` | Formula | `(field('personne_capacite_annuelle') * field('personne_split_agence_pct') / 100) - field('personne_heures_attribuees_agence')` | Capacite agence restante |
| 16 | `personne_heures_restantes_total` | Formula | `field('personne_capacite_annuelle') - field('personne_heures_attribuees_formation') - field('personne_heures_attribuees_agence')` | Capacite totale restante |

**Vues recommandees** :
- `Tous` (grid, default) — tableau complet
- `Actifs` (grid, filtre `personne_statut = actif`)
- `Formateurs` (grid, filtre `personne_roles contient formateur`)
- `Developpeurs` (grid, filtre `personne_roles contient developpeur`)
- `Capacite restante` (grid, sort `personne_heures_restantes_total ascending`)

---

## 3. Table `formation`

**Primary field** : `formation_nom`

| # | Field | Type Baserow | Parametres | Description |
|---|-------|-------------|------------|-------------|
| 1 | `formation_nom` | Text | — | Nom (Primary, unique conseille) |
| 2 | `formation_description` | Long text | rich text autorise | Description longue |
| 3 | `formation_filiere` | Single select | `dev`, `graphisme`, `marketing`, `iot`, `cybersec` | Filiere |
| 4 | `formation_heures_totales` | Number | Decimal places: 2 | Heures totales prevues |
| 5 | `formation_statut` | Single select | `draft` (default), `actif`, `termine`, `archive` | Cycle de vie |
| 6 | `formation_date_debut` | Date | format `YYYY-MM-DD` | Date debut |
| 7 | `formation_date_fin` | Date | — | Date fin |
| 8 | `formation_blocs` | Link to table | Lien vers `bloc` (apres creation bloc) | Blocs de la formation |
| 9 | `formation_projets_pedagogiques` | Link to table | Lien vers `projet` (optionnel) | Projets agence lies en pedagogique |
| 10 | `formation_heures_attribuees` | Formula | `sum(lookup('formation_blocs', 'bloc_heures_prevues'))` | Rollup heures des blocs |
| 11 | `formation_heures_restantes` | Formula | `field('formation_heures_totales') - field('formation_heures_attribuees')` | Reste a attribuer |
| 12 | `formation_created_at` | Created on | — | Audit |
| 13 | `formation_updated_at` | Last modified time | — | Audit |

**Vues** :
- `Tous` (grid)
- `Actives` (grid, filtre `formation_statut = actif`)
- `Par filiere` (grid, group by `formation_filiere`)
- `Calendrier` (calendar view, sur `formation_date_debut`)
- `Capacite restante` (grid, sort `formation_heures_restantes ascending`)

---

## 4. Table `bloc`

**Primary field** : `bloc_nom`

| # | Field | Type Baserow | Parametres | Description |
|---|-------|-------------|------------|-------------|
| 1 | `bloc_nom` | Text | — | Nom du bloc (Primary) |
| 2 | `bloc_description` | Long text | — | Description |
| 3 | `bloc_formation` | Link to table | Lien vers `formation` (single) | Formation parente |
| 4 | `bloc_heures_prevues` | Number | Decimal places: 2 | Heures du bloc |
| 5 | `bloc_ordre` | Number | Decimal places: 0 | Ordre dans la formation |
| 6 | `bloc_modules` | Link to table | Lien vers `module` (apres creation) | Modules du bloc |
| 7 | `bloc_heures_attribuees` | Formula | `sum(lookup('bloc_modules', 'module_heures_prevues_active'))` | Rollup heures modules actifs |
| 8 | `bloc_heures_restantes` | Formula | `field('bloc_heures_prevues') - field('bloc_heures_attribuees')` | Reste a decomposer |

**Note** : la regle metier "un bloc a un nom unique par formation" se valide **cote bridge** ou via une vue filtree de duplication.

**Vues** :
- `Tous` (grid)
- `Par formation` (grid, group by `bloc_formation`)

---

## 5. Table `module`

**Primary field** : `module_nom`

| # | Field | Type Baserow | Parametres | Description |
|---|-------|-------------|------------|-------------|
| 1 | `module_nom` | Text | — | Nom du module (Primary) |
| 2 | `module_description` | Long text | — | Description |
| 3 | `module_bloc` | Link to table | Lien vers `bloc` (single) | Bloc parent |
| 4 | `module_heures_prevues` | Number | Decimal places: 2 | Heures du module |
| 5 | `module_statut` | Single select | `a_attribuer` (default), `attribue`, `en_cours`, `realise`, `annule` | Cycle de vie |
| 6 | `module_attributions` | Link to table | Lien vers `attribution` (apres creation) | Attributions du module |
| 7 | `module_heures_prevues_active` | Formula | `if(field('module_statut') = 'annule', 0, field('module_heures_prevues'))` | Pour rollup bloc (exclut annule) |
| 8 | `module_heures_attribuees` | Formula | `sum(lookup('module_attributions', 'attribution_heures_attribuees_active'))` | Rollup |
| 9 | `module_heures_realisees` | Formula | `sum(lookup('module_attributions', 'attribution_heures_realisees'))` | Rollup |

**Vues** :
- `Tous` (grid)
- **`A attribuer`** (kanban, group by `module_statut`) — vue principale pour l'admin
- `Par bloc` (grid, group by `module_bloc`)
- `Realises` (grid, filtre `module_statut = realise`)

---

## 6. Table `attribution`

**Primary field** : `attribution_titre` (formula : nom_module + " → " + nom_personne)

| # | Field | Type Baserow | Parametres | Description |
|---|-------|-------------|------------|-------------|
| 1 | `attribution_titre` | Formula | `concat(lookup('attribution_module', 'module_nom'), ' → ', lookup('attribution_personne', 'personne_prenom'), ' ', lookup('attribution_personne', 'personne_nom'))` | Titre auto (Primary) |
| 2 | `attribution_module` | Link to table | Lien vers `module` (single) | Module attribue |
| 3 | `attribution_personne` | Link to table | Lien vers `personne` (single) | Formateur (role formateur requis) |
| 4 | `attribution_heures_attribuees` | Number | Decimal places: 2 | Heures planifiees |
| 5 | `attribution_heures_realisees` | Number | Decimal places: 2, default 0 | Heures effectuees |
| 6 | `attribution_date_debut` | Date | — | Debut periode |
| 7 | `attribution_date_fin` | Date | — | Fin periode |
| 8 | `attribution_statut` | Single select | `planifie` (default), `en_cours`, `realise`, `annule` | Statut |
| 9 | `attribution_heures_attribuees_active` | Formula | `if(field('attribution_statut') = 'annule', 0, field('attribution_heures_attribuees'))` | Pour rollup module/personne |

**Validation cote bridge** :
- `attribution_personne.personne_roles` doit contenir `formateur`
- `sum(attribution_heures_attribuees) for module <= module_heures_prevues` (RG-01)

**Vues** :
- `Tous` (grid)
- **`Mes attributions`** (grid, filtre `attribution_personne = current user`) — vue formateur
- `En cours` (grid, filtre `attribution_statut = en_cours`)
- `Calendrier` (calendar view sur `attribution_date_debut` ou `attribution_date_fin`)
- `Form public` (form view) — formateur saisit ses heures realisees rapide

---

## 7. Table `client`

**Primary field** : `client_nom`

| # | Field | Type Baserow | Parametres | Description |
|---|-------|-------------|------------|-------------|
| 1 | `client_nom` | Text | — | Nom (Primary) |
| 2 | `client_contact_principal` | Text | — | Nom + role du contact |
| 3 | `client_contact_email` | Email | — | Email contact |
| 4 | `client_contact_telephone` | Phone number | — | Telephone |
| 5 | `client_secteur` | Text | — | Secteur d'activite |
| 6 | `client_notes` | Long text | — | Notes libres |
| 7 | `client_statut` | Single select | `prospect` (default), `actif`, `inactif`, `archive` | Statut |
| 8 | `client_projets` | Link to table | Lien vers `projet` | Projets du client |
| 9 | `client_created_at` | Created on | — | Audit |

**Vues** :
- `Tous` (grid)
- `Actifs` (grid, filtre `client_statut = actif`)
- **`Pipeline`** (kanban, group by `client_statut`) — vue commerciale

---

## 8. Table `projet`

**Primary field** : `projet_nom`

| # | Field | Type Baserow | Parametres | Description |
|---|-------|-------------|------------|-------------|
| 1 | `projet_nom` | Text | — | Nom (Primary) |
| 2 | `projet_description` | Long text | — | Description |
| 3 | `projet_client` | Link to table | Lien vers `client` (single) | Client |
| 4 | `projet_type` | Single select | `site_web`, `app_mobile`, `api`, `infra`, `audit`, `support`, `autre` | Type |
| 5 | `projet_charge_heures` | Number | Decimal places: 2 | Charge estimee |
| 6 | `projet_date_debut` | Date | — | Date debut |
| 7 | `projet_date_fin_prevue` | Date | — | Date fin prevue |
| 8 | `projet_date_livraison` | Date | — | Date livraison effective |
| 9 | `projet_statut` | Single select | `devis` (default), `en_cours`, `livre`, `cloture`, `abandonne` | Statut |
| 10 | `projet_formation_pedagogique` | Link to table | Lien vers `formation` (single, optionnel) | Lien pedagogique |
| 11 | `projet_url` | URL | — | Site livraison |
| 12 | `projet_repository` | URL | — | Repo Git |
| 13 | `projet_taches` | Link to table | Lien vers `tache` | Taches du projet |
| 14 | `projet_heures_attribuees` | Formula | `sum(lookup('projet_taches', 'tache_charge_heures'))` | Rollup taches |
| 15 | `projet_heures_realisees` | Formula | `sum(lookup('projet_taches', 'tache_heures_realisees'))` | Rollup |
| 16 | `projet_heures_restantes` | Formula | `field('projet_charge_heures') - field('projet_heures_realisees')` | Reste a faire |

**Vues** :
- `Tous` (grid)
- **`Pipeline`** (kanban, group by `projet_statut`) — vue principale
- `En cours` (grid, filtre `projet_statut = en_cours`)
- `Timeline` (timeline view sur date_debut → date_fin_prevue)
- `Par client` (grid, group by `projet_client`)

---

## 9. Table `tache`

**Primary field** : `tache_titre`

| # | Field | Type Baserow | Parametres | Description |
|---|-------|-------------|------------|-------------|
| 1 | `tache_titre` | Text | — | Titre (Primary) |
| 2 | `tache_description` | Long text | — | Description |
| 3 | `tache_projet` | Link to table | Lien vers `projet` (single) | Projet parent |
| 4 | `tache_charge_heures` | Number | Decimal places: 2 | Charge estimee |
| 5 | `tache_priorite` | Single select | `faible`, `normale`, `haute`, `critique` | Priorite |
| 6 | `tache_statut` | Single select | `todo` (default), `in_progress`, `review`, `done`, `abandoned` | Statut |
| 7 | `tache_date_debut` | Date | — | Debut prevu |
| 8 | `tache_date_fin_prevue` | Date | — | Fin prevue |
| 9 | `tache_assignee` | Link to table | Lien vers `personne` (single, optionnel) | Dev assignee informellement |
| 10 | `tache_interventions` | Link to table | Lien vers `intervention` | Interventions sur cette tache |
| 11 | `tache_heures_realisees` | Formula | `sum(lookup('tache_interventions', 'intervention_heures_active'))` | Rollup |

**Vues** :
- `Tous` (grid)
- **`Kanban`** (kanban, group by `tache_statut`) — vue principale
- `Par priorite` (grid, group by `tache_priorite`, sort par priorite)
- `Mes taches` (grid, filtre `tache_assignee = current user`)
- `Done recentes` (grid, filtre `tache_statut = done`, sort par date desc)

---

## 10. Table `intervention`

**Primary field** : `intervention_titre` (formula auto)

| # | Field | Type Baserow | Parametres | Description |
|---|-------|-------------|------------|-------------|
| 1 | `intervention_titre` | Formula | `concat(lookup('intervention_tache', 'tache_titre'), ' - ', lookup('intervention_personne', 'personne_prenom'), ' (', totext(field('intervention_date')), ')')` | Titre auto (Primary) |
| 2 | `intervention_tache` | Link to table | Lien vers `tache` (single) | Tache concernee |
| 3 | `intervention_personne` | Link to table | Lien vers `personne` (single) | Developpeur (role developpeur requis) |
| 4 | `intervention_heures` | Number | Decimal places: 2 | Heures effectuees |
| 5 | `intervention_date` | Date | default today | Date intervention |
| 6 | `intervention_notes` | Long text | — | Notes / commit ref / lien PR |
| 7 | `intervention_statut` | Single select | `planifie`, `realise` (default), `annule` | Statut |
| 8 | `intervention_heures_active` | Formula | `if(field('intervention_statut') = 'annule', 0, field('intervention_heures'))` | Pour rollup tache/personne |

**Validation cote bridge** :
- `intervention_personne.personne_roles` doit contenir `developpeur`
- `intervention_heures > 0`

**Vues** :
- `Tous` (grid, sort `intervention_date desc`)
- **`Mes interventions`** (grid, filtre `intervention_personne = current user`) — vue dev
- **`Form rapide`** (form public) — saisie heures rapide mobile
- `Par projet` (grid, group by `intervention_tache.tache_projet`)
- `Cette semaine` (grid, filtre `intervention_date >= start_of_week`)

---

## 11. Permissions et sharing

### 11.1 Roles Baserow

| Role | Membres | Capacites |
|------|---------|-----------|
| Admin workspace | Corentin, Yan, Ludo | Plein controle |
| Editor | Sophie + autres admins | Read/write toutes tables |
| Builder | Formateurs / Devs | Read/write **leur ligne** via vues filtrees + form rapide |
| Viewer | Stakeholders ponctuels | Read seul |

**Limitation** : Baserow native permissions sont au niveau database/table, pas row-level. Pour limiter formateur/dev a leurs propres rows :
- Soit **vues filtrees partagees publiquement** (form pour saisie + grid filtree pour lecture)
- Soit **bridge service** qui filtre cote API selon `current_user_id`

### 11.2 Forms publics pour saisie rapide

Plus simple que de gerer les permissions row-level :
- Form public sur `attribution` — formateur saisit ses heures via lien sans compte Baserow
- Form public sur `intervention` — dev saisit son intervention idem

Le user qui saisit n'a pas besoin de voir le reste des donnees, juste son formulaire.

---

## 12. Webhooks (Phase 2 — bridge integration)

Configurer dans Baserow → Database Settings → Webhooks :

| Evenement | URL cible | Usage bridge |
|-----------|-----------|--------------|
| `row.created` sur `attribution` | `https://bridge.acadenice.fr/webhooks/attribution-created` | Notif formateur, recalcul cache mention |
| `row.updated` sur `attribution` | `https://bridge.acadenice.fr/webhooks/attribution-updated` | Recalcul cache, notif si statut change |
| `row.created` sur `intervention` | `https://bridge.acadenice.fr/webhooks/intervention-created` | Notif admin si depassement capacite |
| `row.updated` sur `module` (si `module_statut` change) | `https://bridge.acadenice.fr/webhooks/module-status-changed` | Trigger cloturer formation auto |

Authentification webhook : header `X-Bridge-Token` avec un secret partage (`.env`).

---

## 13. Seed data initial

Apres creation des 9 tables, seed avec :
- **personne** : equipe Acadenice (Yan, Corentin, Ludo, Sophie + formateurs intervenants)
- **client** : 1-2 clients existants (Centralis Europe + autre)
- **formation** : les 5 filieres en cours pour 2026-2027
- **bloc** : decoupage RNCP par filiere
- **module** : programme detaille
- **projet** : projets clients en cours
- Pas d'attribution / intervention seed — saisies par l'usage

Script de seed : `baserow/seed/seed.py` (a coder Phase 1).

---

## 14. Validation post-creation

Checklist apres creation des 9 tables :

- [ ] Les 9 tables existent dans la database `formation-hub`
- [ ] Toutes les FK sont liees correctement (verifier en cliquant sur un lien dans une row)
- [ ] Les rollups fonctionnent (creer une row test, verifier le calcul de `formation_heures_attribuees`)
- [ ] Les formulas s'evaluent sans erreur (regarder les rows test)
- [ ] Les Single Select / Multiple Select ont les bonnes options
- [ ] Au moins une vue par table est creee (grid `Tous` minimum)
- [ ] Les vues kanban (module, projet, tache, client) sont fonctionnelles
- [ ] Le form public pour saisie heures (attribution, intervention) marche
- [ ] L'API token est genere et fonctionne (test `curl`)

```bash
# Test API token
curl -H "Authorization: Token $BASEROW_API_TOKEN" \
     "$BASEROW_URL/api/database/rows/table/<TABLE_ID>/?user_field_names=true"
```

---

## 15. Notes d'implementation

### 15.1 Limitations Baserow connues

- **Pas de FK `ON DELETE` configurable** : c'est `SET NULL` par defaut quand le lien est rompu. Pour forcer un comportement CASCADE/RESTRICT, le bridge service doit l'implementer (ou un workflow Baserow).
- **Pas de CHECK constraint** : validation cote bridge ou cote UI.
- **Pas d'index custom** : Baserow indexe automatiquement les Link to table et les Primary fields.
- **Formules limitees** : pas de boucles ni de subqueries complexes. Pour calculs lourds, calcul cote bridge + ecriture en batch.

### 15.2 Alternatives si Baserow limite

Si une formule devient trop complexe ou si on a besoin de validation forte :
- Option A : **Bridge fait le calcul** et ecrit en Baserow via API
- Option B : **Vue filtree dediee** + formula simple
- Option C : **Migration vers Postgres direct** (futur — si on perd Baserow)

### 15.3 Migration data initiale

Si donnees existent dans Excel/Trello/autre :
1. Exporter en CSV
2. Mapper les colonnes vers les fields Baserow
3. Importer via Baserow UI (`Import data`)
4. Verifier les liens FK manuellement (Baserow ne mappe pas auto les liens via CSV)

---

## 16. Resume — checklist d'implementation Phase 1

```
[ ] 1. Setup workspace + database
[ ] 2. Creer table 'personne' (sans liens encore)
[ ] 3. Creer table 'client' (sans liens encore)
[ ] 4. Creer table 'formation' (sans liens encore)
[ ] 5. Creer table 'bloc' + lien vers formation
[ ] 6. Creer table 'projet' + lien vers client (+ optionnel formation)
[ ] 7. Creer table 'module' + lien vers bloc
[ ] 8. Creer table 'tache' + lien vers projet (+ optionnel personne assignee)
[ ] 9. Creer table 'attribution' + liens vers module + personne
[ ] 10. Creer table 'intervention' + liens vers tache + personne
[ ] 11. Ajouter formulas et lookups (apres tous les liens crees)
[ ] 12. Creer vues recommandees par table
[ ] 13. Configurer permissions roles + sharing
[ ] 14. Seed data initial
[ ] 15. Generer API token + verifier
[ ] 16. Documenter exports JSON dans `baserow/schemas/`
```

Apres ca : la base structurelle est en place. La saisie metier peut commencer **immediat** — sans attendre Phase 2 / bridge.