[Backend][BDD] Renommer absences_garde → evenements_agenda #205

New Issue

2026-10-01T15:01:43Z

jmartin commented

2026-10-01 15:01:43 +00:00

Contexte

Epic #165 · décision §32 / mini-spec bulles.

La table absences_garde porte aujourd’hui absences / congés / arrêt. Le fil de bulles = événements d’agenda (≠ blog). On y ajoutera bientôt soins enfant, école, mairie, sorties, etc. Le nom « absence » devient trop étroit.

Cible de naming : evenements_agenda.

Réf. : docs/32_MINI-SPEC-BULLES-CARTES.md, docs/24_DECISIONS-PROJET.md §32.

Objectif

Renommer / généraliser le back métier absences → agenda d’événements, sans perdre les données existantes.

Deux livrables obligatoires :

Migration de la base actuelle (dev / deploy) : rename + FKs + données intactes.
Scripts from-scratch à jour : database/BDD.sql (et seeds / docs schéma) doivent créer directement evenements_agenda — pas seulement un patch « ALTER » oublié pour les installs neuves.

Périmètre technique (indicatif)

BDD

RENAME TABLE absences_garde → evenements_agenda
Renommer enums / types SQL si besoin (type_absence_garde_type → type_evenement_agenda_type, etc.) — ou élargir l’enum existant
Index, contraintes, commentaires
FK card_instances.id_absence → id_evenement (ou équivalent) pointant vers evenements_agenda
Colonne id_card_instance inchangée fonctionnellement

Scripts from-scratch

Réécrire le bloc CREATE TABLE dans database/BDD.sql sous le nouveau nom
Aligner seeds / verify / éventuels dumps de référence
Vérifier qu’une install vierge (sans rejouer les vieilles migrations absences) produit le bon schéma

Backend Nest

Entité TypeORM + module (rename fichiers / symboles)
Routes API : soit /evenements-agenda (propre) + dépréciation éventuelle de /absences-garde, soit alias temporaire — à trancher dans le ticket
Module Cartes : hooks vers le nouvel id

Docs

Mini-specs 30 / 31 / 32, 10_DATABASE.md, contrats API

Hors scope de ce ticket

Nouveaux types métier (soin enfant, école, mairie, sortie) — tickets suivants une fois la table renommée
Refonte UI agenda riche
Suppression du champ couleur API (autre chantier / déjà prévu côté spec bulles)

Done when

Base live migrée : données absences/congés/arrêt toujours accessibles sous evenements_agenda
database/BDD.sql (from scratch) crée evenements_agenda (plus de CREATE absences_garde)
Backend + cartes branchés ; tests verts
Docs à jour
Install neuve testée (compose / psql BDD.sql) OK

Dépendances

Module absences (#172 / #193) et cartes (#194) déjà en place
À faire avant d’empiler trop de nouveaux types (soins, école…) sur l’ancien nom

## Contexte Epic [#165](https://git.ptits-pas.fr/jmartin/petitspas/issues/165) · décision §32 / mini-spec bulles. La table `absences_garde` porte aujourd’hui absences / congés / arrêt. Le fil de bulles = **événements d’agenda** (≠ blog). On y ajoutera bientôt soins enfant, école, mairie, sorties, etc. Le nom « absence » devient trop étroit. **Cible de naming :** `evenements_agenda`. Réf. : `docs/32_MINI-SPEC-BULLES-CARTES.md`, `docs/24_DECISIONS-PROJET.md` §32. --- ## Objectif Renommer / généraliser le back métier absences → **agenda d’événements**, sans perdre les données existantes. Deux livrables **obligatoires** : 1. **Migration** de la base **actuelle** (dev / deploy) : rename + FKs + données intactes. 2. **Scripts from-scratch** à jour : `database/BDD.sql` (et seeds / docs schéma) doivent créer directement `evenements_agenda` — **pas** seulement un patch « ALTER » oublié pour les installs neuves. --- ## Périmètre technique (indicatif) ### BDD - `RENAME TABLE absences_garde → evenements_agenda` - Renommer enums / types SQL si besoin (`type_absence_garde_type` → `type_evenement_agenda_type`, etc.) — ou élargir l’enum existant - Index, contraintes, commentaires - FK `card_instances.id_absence` → `id_evenement` (ou équivalent) pointant vers `evenements_agenda` - Colonne `id_card_instance` inchangée fonctionnellement ### Scripts from-scratch - Réécrire le bloc `CREATE TABLE` dans `database/BDD.sql` sous le nouveau nom - Aligner seeds / verify / éventuels dumps de référence - Vérifier qu’une install **vierge** (sans rejouer les vieilles migrations absences) produit le bon schéma ### Backend Nest - Entité TypeORM + module (rename fichiers / symboles) - Routes API : soit `/evenements-agenda` (propre) + dépréciation éventuelle de `/absences-garde`, soit alias temporaire — à trancher dans le ticket - Module Cartes : hooks vers le nouvel id ### Docs - Mini-specs 30 / 31 / 32, `10_DATABASE.md`, contrats API --- ## Hors scope de ce ticket - Nouveaux types métier (soin enfant, école, mairie, sortie) — tickets suivants une fois la table renommée - Refonte UI agenda riche - Suppression du champ `couleur` API (autre chantier / déjà prévu côté spec bulles) --- ## Done when - [ ] Base live migrée : données absences/congés/arrêt toujours accessibles sous `evenements_agenda` - [ ] `database/BDD.sql` (from scratch) crée `evenements_agenda` (plus de `CREATE absences_garde`) - [ ] Backend + cartes branchés ; tests verts - [ ] Docs à jour - [ ] Install neuve testée (compose / psql BDD.sql) OK --- ## Dépendances - Module absences (#172 / #193) et cartes (#194) déjà en place - À faire **avant** d’empiler trop de nouveaux types (soins, école…) sur l’ancien nom

jmartin added this to the 0.2.0 milestone 2026-10-01 15:01:43 +00:00