diff --git a/backend/src/modules/cards/cards.service.spec.ts b/backend/src/modules/cards/cards.service.spec.ts index 31260a2..5df3eb6 100644 --- a/backend/src/modules/cards/cards.service.spec.ts +++ b/backend/src/modules/cards/cards.service.spec.ts @@ -80,7 +80,6 @@ describe('CardsService (#194)', () => { audience_resolver: 'couple_parents', response_mode: CardResponseModeType.ACCEPT_REFUSE, retention_days: 14, - couleur: 'lavender', }); amChildrenRepo.findOne.mockResolvedValue({ id: 'pl-1', diff --git a/backend/src/modules/cards/cards.service.ts b/backend/src/modules/cards/cards.service.ts index 7630e74..9d25769 100644 --- a/backend/src/modules/cards/cards.service.ts +++ b/backend/src/modules/cards/cards.service.ts @@ -53,9 +53,32 @@ export class CardsService { private readonly realtime: CardsRealtimeService, ) {} - async listerTypes(role: RoleType): Promise { + async listerTypes(role: RoleType): Promise< + Pick< + CardType, + | 'code' + | 'system' + | 'titre' + | 'emitter_roles' + | 'recipient_roles' + | 'audience_resolver' + | 'response_mode' + | 'retention_days' + >[] + > { const all = await this.typesRepo.find({ where: { system: true } }); - return all.filter((t) => t.emitter_roles.includes(role)); + return all + .filter((t) => t.emitter_roles.includes(role)) + .map((t) => ({ + code: t.code, + system: t.system, + titre: t.titre, + emitter_roles: t.emitter_roles, + recipient_roles: t.recipient_roles, + audience_resolver: t.audience_resolver, + response_mode: t.response_mode, + retention_days: t.retention_days, + })); } async lister( @@ -469,7 +492,6 @@ export class CardsService { id: card.id, type_code: card.type_code, titre: card.type?.titre ?? card.type_code, - couleur: card.type?.couleur ?? null, id_placement: card.id_placement, id_evenement: card.id_evenement ?? null, operation: card.operation, diff --git a/backend/src/modules/cards/dto/cards.dto.ts b/backend/src/modules/cards/dto/cards.dto.ts index 01474e0..d086dd5 100644 --- a/backend/src/modules/cards/dto/cards.dto.ts +++ b/backend/src/modules/cards/dto/cards.dto.ts @@ -91,9 +91,6 @@ export class CarteDto { @ApiProperty() titre: string; - @ApiPropertyOptional() - couleur?: string | null; - @ApiProperty() id_placement: string; diff --git a/docs/24_DECISIONS-PROJET.md b/docs/24_DECISIONS-PROJET.md index b1451d5..44d5bbf 100644 --- a/docs/24_DECISIONS-PROJET.md +++ b/docs/24_DECISIONS-PROJET.md @@ -572,14 +572,22 @@ POST /repos/jmartin/petitspas/pulls/{index}/merge ### 32. Module Absences + Cartes (séparation back / collecte) -**Décision** : ✅ **Back `evenements_agenda` = vérité métier** ; **Cartes = file d’attention / collecte** (plugin isolé). Types SYSTEM (absence, congé, arrêt) indéboulonnables ; types OPTIONNELS (sondages…) plus tard. Annulation = DELETE. `expire_at` dès V1. +**Décision** : ✅ **Back `evenements_agenda` = vérité métier / agenda** ; **Cartes = file d’attention** (plugin isolé). Types SYSTEM (absence, congé, arrêt) indéboulonnables ; types OPTIONNELS (sondages, soins enfant, école, mairie, sorties…) plus tard. Annulation = DELETE. `expire_at` dès V1. **Justification** : - Premier vrai module d’interaction multi-acteurs -- Évite de stocker l’historique congés dans des bulles éphémères -- Portabilité / généricité des cartes sans coupler le métier garde +- Évite de stocker l’historique dans des bulles éphémères +- Portabilité / généricité des cartes sans coupler le métier +- **Différence avec le blog** : les cartes du fil = **événements d’agenda** (période + placement + historique) ; le blog = récit narratif du jour -**Flux V1** : BDD absences → API liste/CRUD → module Cartes SYSTEM → front bulles (séparé). +**Modèle données** : +- Table **`evenements_agenda`** (ex-`absences_garde`, rename [#205](https://git.ptits-pas.fr/jmartin/petitspas/issues/205)) — nom volontairement ouvert + +**UI** : la **couleur** des bulles est un mapping **front** (`type_code` → teinte). L’API n’expose pas `couleur`. + +**Flux V1** : BDD agenda → API liste/CRUD → module Cartes SYSTEM → front bulles (séparé). + +**Réf. détail** : `docs/32_MINI-SPEC-BULLES-CARTES.md` --- diff --git a/docs/32_MINI-SPEC-BULLES-CARTES.md b/docs/32_MINI-SPEC-BULLES-CARTES.md index 058dde0..4179d49 100644 --- a/docs/32_MINI-SPEC-BULLES-CARTES.md +++ b/docs/32_MINI-SPEC-BULLES-CARTES.md @@ -1,44 +1,53 @@ # Mini-spec · Bulles / file d’attention (#173) -*Front · octobre 2026 — pour alignement backend (garant de la spec API).* +*Front · octobre 2026 — alignement product / API.* --- ## 1. Contexte / objectif -Les bulles (cartes) sont la **file d’attention** du quotidien parent / AM : décisions et infos proches (congés, arrêt maladie, absences, plus tard soins / admin). +Les bulles (cartes) sont la **file d’attention** du quotidien parent / AM : décisions et infos proches (congés, arrêt maladie AM, absences, soins / bobos enfant…). + +**Différence fondamentale avec le blog :** +les cartes de ce fil sont des **événements d’agenda** (période, placement, historique métier loggé). +Le **blog** = récit / mémoire narrative du jour (photos, texte) — pas une ligne d’agenda. + +Les cartes restent une **mémoire courte** de file (`purge_at` sur la bulle) ; la **source de vérité agenda** reste le back métier. + +Table agenda : **`evenements_agenda`** (ex-`absences_garde`, [#205](https://git.ptits-pas.fr/jmartin/petitspas/issues/205) fait) — conteneur ouvert (absences, congés, soins, école, mairie, sorties…). Les bulles notifient ; l’agenda historise. + +Voir aussi `31_MINI-SPEC-QUOTIDIEN-PARENT-AM.md`. Cette note formalise : -1. **Ce qui est déjà en place côté front** (branche `feature/173-feed-bulles-parent`). -2. La **palette sémantique** retenue (couleur = famille). -3. Les **évolutions API** souhaitées pour que le back pousse les bonnes `couleur` / types. -4. Les **idées de bulles futures** (non branchées). - -Les cartes restent une **mémoire courte** (`purge_at`) ; la source de vérité absences / congés reste `absences_garde` (voir `31_MINI-SPEC-QUOTIDIEN-PARENT-AM.md`). +1. Ce qui est en place côté front (#173). +2. Le contrat API (sans couleur). +3. La **palette UI** (front only, dérivée du `type_code`). +4. La nouvelle famille **soins / bobo enfant** (rose) — AM → parents. +5. Idées futures. --- -## 2. Contrat API actuel (rappel) +## 2. Contrat API Endpoint principal : `GET /api/v1/cards` (filtre couple / placement). -Champs utiles côté UI : - | Champ | Rôle UI | |-------|---------| -| `type_code` | Layout + libellé sémantique + icône | -| `couleur` | Teinte du fond pastel (`assets/cards/card_*_h.png`) | +| `type_code` | Layout + libellé + **couleur / icône (mapping front)** | | `titre` | Fallback si `type_code` inconnu | | `statut` | `ouverte` · `refusee` · `traitee` | | `response_mode` | `none` · `ack` · `accept_refuse` | | `is_creator` | Masque les boutons réponse pour le créateur | -| `payload.date_debut` / `date_fin` | Période affichée | -| `payload.motif` | Non affiché sur la maquette congés actuelle | -| `last_refuse_comment` | Affiché si `refusee` | -| `id_absence` | Lien métier absence / congé | -| `purge_at` | Péremption file | +| `payload.date_debut` / `date_fin` | Période (agenda) | +| `payload.motif` | Texte libre / détail | +| `last_refuse_comment` | Si `refusee` | +| `id_absence` | Lien métier agenda (si applicable) | +| `purge_at` | Péremption de la bulle dans la file | -**Règle front actuelle :** le destinataire peut répondre si `!is_creator && statut == ouverte && response_mode != none`. +**Pas de champ `couleur` dans l’API.** +La teinte pastel est **100 % front** : table de mapping `type_code` → asset (`card_*_h.png`). Le back ne gère pas la charte graphique. + +**Règle front :** le destinataire peut répondre si `!is_creator && statut == ouverte && response_mode != none`. --- @@ -47,113 +56,129 @@ Champs utiles côté UI : ### 3.1 Feed - Widget partagé `CartesFeed` (parent + AM). -- Fond carte via widget `Carte` (bandeau / 9-slice horizontal). -- Dégradés haut / bas sur la liste scrollable. -- Plus de libellés « À traiter / Traité » : actions via **modales** accepter / refuser / ack. -- Libellés UI sémantiques (indépendants du `titre` API brut) : +- Fond via widget `Carte` (9-slice horizontal) selon mapping local. +- Actions via **modales** accepter / refuser / ack. +- Libellés UI : - `conge_am` → « Demande de congés » - `arret_maladie_am` → « Arrêt maladie » - `absence_enfant` (+ `_modif`) → « Notification d’absence » -### 3.2 Carte **congés** (`conge_am`) — maquette validée +### 3.2 Carte **congés** (`conge_am`) | Élément | Comportement | |---------|----------------| -| Fond | **Aqua** forcé côté front (même si l’API envoie encore `lavender`) | -| Encre | Pétrole désaturé `#315F63` (titre) ; date un peu plus claire `#4A7276` ; lien `#2B5868` | -| Icône | Valise `assets/images/valise.png` | -| Période | Une ligne type « Du 04 au 06 novembre 2026 » + petite icône calendrier | -| Actions | Pilules peintes ✓ vert / ✕ corail (`btn_coche_pilule` / `btn_croix_pilule`) si `accept_refuse` | -| Lien | « Ouvrir dans l’agenda ↗ » (stub UI pour l’instant) | -| Opacité | Carte atténuée si `traitee` (sauf règle arrêt maladie ci-dessous) | +| Fond | **Aqua** (mapping front) | +| Encre | Pétrole `#315F63` / dates `#4A7276` | +| Icône | Valise | +| Période | « Du … au … » + calendrier | +| Actions | Pilules ✓ / ✕ si `accept_refuse` | +| Lien | « Ouvrir dans l’agenda ↗ » | +| Opacité | Atténuée si `traitee` (sauf règle arrêt ci-dessous) | -### 3.3 Arrêt maladie (`arret_maladie_am`) +### 3.3 Arrêt maladie AM (`arret_maladie_am`) -- Reste **visible / opaque** tant que la période n’est pas finie (`date_fin` jour inclus), même si `statut == traitee`. -- Icône thermomètre (asset dédié). Fond encore piloté par `couleur` API (cible produit : **bleu** — voir §4). +- Reste **visible / opaque** tant que `date_fin` (jour inclus) n’est pas passée, même si `traitee`. +- Fond **bleu** (mapping front). -### 3.4 Assets couleurs horizontales +### 3.4 Assets -Teintes dispo dans `frontend/assets/cards/` (V + H), dont **`aqua`** ajouté pour les congés. - -Clés API reconnues côté front : `red` · `pink` · `peach` · `lime` · `lavender` · `green` · `blue` · **`aqua`**. Défaut UI si inconnu : `peach`. +Teintes UI : `red` · `pink` · `peach` · `lime` · `lavender` · `green` · `blue` · `aqua`. +Clé = **choix front**, pas une valeur API. --- -## 4. Palette sémantique (alignement demandé) +## 4. Palette UI (front only — dérivée du `type_code`) -| Couleur API (`couleur`) | Famille | Types / exemples | -|-------------------------|---------|------------------| -| **`aqua`** | Congés | `conge_am` | -| **`blue`** | Arrêt maladie | `arret_maladie_am` | -| **`pink`** | Soins du quotidien | médicament, température, bobo, crème… (futur) | -| **`peach`** | Absence / info pratique | `absence_enfant`, `absence_enfant_modif` | -| **`lavender`** | Administratif / autre | infos admin, divers (à utiliser avec parcimonie) | +| Couleur UI | Famille | Types | +|------------|---------|--------| +| **`aqua`** | Congés AM | `conge_am` | +| **`blue`** | Arrêt maladie AM | `arret_maladie_am` | +| **`peach`** | Absence enfant / info pratique | `absence_enfant`, `absence_enfant_modif` | +| **`pink`** | Soins / bobo / problème **enfant** (AM → parents) | `soin_enfant` *(nouveau — voir §5)* | +| **`lavender`** | Admin / divers | futurs types admin | **Principes** -- La **couleur** = famille (lisible sans lire tout le texte). -- L’**icône** précise l’action (surtout sur fond rose : thermomètre, flacon, pansement, croix de soin…). +- Couleur = famille visuelle (lisible sans tout lire). +- Icône précise l’événement (surtout sur rose : thermomètre, pansement, flacon…). - Rose = doux / rassurant, **pas** une alerte médicale forte. -- Éviter le lavande pour les congés (trop « admin », dissonant avec valise / aqua). - -### Demande backend (prioritaire) - -1. Seeds / création de cartes : `conge_am` → `couleur: "aqua"` (le front force déjà ; l’API devrait être source de vérité). -2. `arret_maladie_am` → `couleur: "blue"`. -3. `absence_enfant*` → `couleur: "peach"`. -4. Documenter les valeurs autorisées de `couleur` (enum / check) pour inclure `aqua`. -5. Ne plus mapper les congés sur `lavender`. +- Congés ≠ lavande (trop « admin »). --- -## 5. Idées de bulles futures (hors scope #173) +## 5. Nouvelle bulle rose — soins / bobo enfant (AM → parents) -Non implémentées ; pour anticipation contrat types + couleurs. +### Intention produit -| Famille | Couleur | Exemples de `type_code` (propositions) | `response_mode` typique | Icônes (ex.) | -|---------|---------|----------------------------------------|-------------------------|--------------| -| Soins | `pink` | `soin_temperature`, `soin_medicament`, `soin_bobo`, `soin_creme` | `ack` (parent) | thermomètre, flacon, pansement, tube | -| Sortie / autorisation | `peach` ou `lavender` | `sortie_a_valider` | `accept_refuse` | à définir | -| Admin | `lavender` | `info_admin`, `document_a_fournir` | `ack` / `none` | classeur, tampon | -| Congé / maladie (évol.) | `aqua` / `blue` | modif période, annulation | selon métier | valise / thermomètre | +La nounou signale un **événement concernant l’enfant** (maladie légère, bobo, crème, température, souci du jour…) **vers les parents**. -**Variante soins :** un seul fond rose ; l’icône change selon l’événement — la famille « santé/soin » reste immédiate. +Pourquoi **pas seulement la messagerie** ? +- C’est **loggé** dans la file d’attention. +- C’est un **événement d’agenda** (période / jour, placement, historique). +- Les parents peuvent **acquitter** (`ack`) sans noyer le chat. + +### Proposition V1 (à brancher ultérieurement) + +| | | +|--|--| +| `type_code` | `soin_enfant` (nom exact à figer) | +| Émetteur | AM | +| Destinataires | parents du couple / placement | +| `response_mode` | `ack` | +| Couleur UI | `pink` | +| Back métier | ligne agenda liée (même esprit que `absences_garde` : période + placement + motif) ; la bulle = collecte / notification | +| Payload | `date_debut` / `date_fin` (+ motif / sous-type optionnel : temperature, bobo, medicament…) | + +**Hors scope immédiat #173** : implémentation complète ; cette section fige l’intention pour le contrat types + UI. --- -## 6. Comportements métier à ne pas casser +## 6. Idées futures (hors scope) -- Créateur : pas de boutons réponse ; éventuel libellé « En attente de réponse ». -- Refus : afficher `last_refuse_comment` si présent. +| Famille | Couleur UI | Exemples | `response_mode` | +|---------|------------|----------|-----------------| +| Soins (détail) | `pink` | `soin_temperature`, `soin_medicament`, `soin_bobo` — ou sous-types dans payload | `ack` | +| Sortie | `peach` / `lavender` | `sortie_a_valider` | `accept_refuse` | +| Admin | `lavender` | `info_admin`, `document_a_fournir` | `ack` / `none` | + +Variante soins : un seul fond rose ; l’icône / sous-type change. + +--- + +## 7. Comportements métier à ne pas casser + +- Créateur : pas de boutons réponse ; éventuel « En attente de réponse ». +- Refus : afficher `last_refuse_comment`. - Congé : `accept_refuse` côté destinataire. -- Absence enfant : souvent info / ack (pas de veto AM en V1 — voir mini-spec quotidien). -- Péremption : respecter `purge_at` / retention ; pas un historique long. +- Absence enfant : info / ack — pas de veto AM en V1. +- File courte : `purge_at` ; l’**agenda** conserve l’historique métier. --- -## 7. Fichiers front de référence +## 8. Fichiers front de référence - `frontend/lib/models/carte_bulle.dart` — mapping type → libellé / icône / fond -- `frontend/lib/widgets/quotidien/cartes_feed.dart` — layout feed + carte congés -- `frontend/lib/models/card_assets.dart` — enum teintes dont `aqua` -- Assets : `frontend/assets/cards/card_aqua(_h).png`, `frontend/assets/images/valise.png`, `frontend/assets/images/cartes/btn_*_pilule.png` +- `frontend/lib/widgets/quotidien/cartes_feed.dart` +- `frontend/lib/models/card_assets.dart` +- Assets : `frontend/assets/cards/`, `valise.png`, `btn_*_pilule.png` --- -## 8. Non-régression / recettes suggérées (back + front) +## 9. Recettes -- [ ] Carte `conge_am` créée avec `couleur=aqua` (et lisible si encore lavande côté vieux seeds grâce au forçage front). -- [ ] Accept / refuse congé → statut + commentaire refus. -- [ ] Arrêt maladie traité mais période en cours → reste visible côté destinataire. -- [ ] Filtre couple / placement : une seule file pour le couple actif. -- [ ] Aucune régression sur `absence_enfant` (création parent → bulle AM). +- [ ] API cartes **sans** champ `couleur` (ni feed ni `/types`). +- [ ] Front mappe `conge_am` → aqua, `arret_maladie_am` → blue, `absence_*` → peach. +- [ ] Accept / refuse congé OK. +- [ ] Arrêt traité + période en cours → reste visible. +- [ ] Filtre couple / placement. +- [ ] (Plus tard) `soin_enfant` rose AM → parents + ligne agenda. --- -## 9. Références +## 10. Références - Ticket front : **#173** -- Contrat cartes / réponses : **#194** (si applicable) -- Quotidien parent–AM : `docs/31_MINI-SPEC-QUOTIDIEN-PARENT-AM.md` +- Module cartes : **#194** +- Quotidien : `docs/31_MINI-SPEC-QUOTIDIEN-PARENT-AM.md` +- Décision projet : `docs/24_DECISIONS-PROJET.md` §32 - Maquette congés : `ressources/bulle_congés.jpg`