Compare commits

..
Author SHA1 Message Date
jmartinandCursor 7d491d5072 docs: norme merge squash (feature→develop→master).
Met à jour la décision §26, le briefing front et l’API Gitea.
Les merges --no-ff déjà poussés (#167/#168) restent inchangés.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-24 00:55:55 +02:00
11 changed files with 183 additions and 300 deletions
@@ -1,88 +0,0 @@
import {
Column,
CreateDateColumn,
Entity,
JoinColumn,
ManyToOne,
PrimaryGeneratedColumn,
UpdateDateColumn,
} from 'typeorm';
import { AmChildren } from './am_children.entity';
import { Users } from './users.entity';
export enum TypeAbsenceGardeType {
ABSENCE_ENFANT = 'absence_enfant',
CONGE_AM = 'conge_am',
ARRET_MALADIE_AM = 'arret_maladie_am',
}
export enum StatutAbsenceGardeType {
EN_ATTENTE = 'en_attente',
ACCEPTE = 'accepte',
REFUSE = 'refuse',
}
/**
* Vérité métier des absences / congés / arrêts par couple AM↔enfant.
* Les cartes (module ultérieur) collectent ; cette table stocke.
* Ticket #193.
*/
@Entity('absences_garde', { schema: 'public' })
export class AbsencesGarde {
@PrimaryGeneratedColumn('uuid')
id: string;
@Column({ name: 'id_placement', type: 'uuid' })
id_placement: string;
@ManyToOne(() => AmChildren, { onDelete: 'CASCADE' })
@JoinColumn({ name: 'id_placement', referencedColumnName: 'id' })
placement: AmChildren;
@Column({
type: 'enum',
enum: TypeAbsenceGardeType,
enumName: 'type_absence_garde_type',
name: 'type',
})
type: TypeAbsenceGardeType;
@Column({ name: 'date_debut', type: 'date' })
date_debut: string;
@Column({ name: 'date_fin', type: 'date' })
date_fin: string;
@Column({
type: 'enum',
enum: StatutAbsenceGardeType,
enumName: 'statut_absence_garde_type',
name: 'statut',
default: StatutAbsenceGardeType.EN_ATTENTE,
})
statut: StatutAbsenceGardeType;
/** Purge auto pour en_attente/refuse ; accepte → infinity. */
@Column({ name: 'expire_at', type: 'timestamptz' })
expire_at: Date;
@Column({ name: 'cree_par', type: 'uuid', nullable: true })
cree_par?: string;
@ManyToOne(() => Users, { nullable: true, onDelete: 'SET NULL' })
@JoinColumn({ name: 'cree_par', referencedColumnName: 'id' })
createdBy?: Users;
/** Réf. carte de collecte (FK quand module Cartes existera). */
@Column({ name: 'id_card_instance', type: 'uuid', nullable: true })
id_card_instance?: string;
@Column({ name: 'motif', type: 'text', nullable: true })
motif?: string;
@CreateDateColumn({ name: 'cree_le', type: 'timestamptz' })
cree_le: Date;
@UpdateDateColumn({ name: 'modifie_le', type: 'timestamptz' })
modifie_le: Date;
}
+79
View File
@@ -0,0 +1,79 @@
import { Column, CreateDateColumn, Entity, JoinColumn, ManyToOne, PrimaryGeneratedColumn, UpdateDateColumn } from "typeorm";
import { Children } from "./children.entity";
import { Users } from "./users.entity";
import { Parents } from "./parents.entity";
export enum TypeEvenementType {
ABSENCE_ENFANT = 'absence_enfant',
CONGE_AM = 'conge_am',
CONGE_PARENT = 'conge_parent',
ARRET_MALADIE_AM = 'arret_maladie_am',
EVENEMENT_RPE = 'evenement_rpe',
}
export enum StatutEvenementType {
PROPOSE = 'propose',
VALIDE = 'valide',
REFUSE = 'refuse',
}
@Entity('evenements')
export class Evenement {
// Define your columns and relationships here
@PrimaryGeneratedColumn('uuid')
id: string;
@Column({
type: 'enum',
enum: TypeEvenementType,
enumName: 'type_evenement_type',
name: 'type'
})
type: TypeEvenementType;
@ManyToOne(() => Children, { onDelete: 'CASCADE', nullable: true })
@JoinColumn({ name: 'id_enfant', referencedColumnName: 'id' })
child?: Children;
@ManyToOne(() => Users, { nullable: true })
@JoinColumn({ name: 'id_am', referencedColumnName: 'id' })
assistanteMaternelle?: Users;
@ManyToOne(() => Parents, { nullable: true })
@JoinColumn({ name: 'id_parent', referencedColumnName: 'user_id' })
parent?: Parents;
@ManyToOne(() => Users, { nullable: true })
@JoinColumn({ name: 'cree_par', referencedColumnName: 'id' })
created_by?: Users;
@Column({ type: 'timestamptz', nullable: true, name: 'date_debut' })
start_date?: Date;
@Column({ type: 'timestamptz', nullable: true, name: 'date_fin' })
end_date?: Date;
@Column({ type: 'text', nullable: true, name: 'commentaires' })
comments?: string;
@Column({
type: 'enum',
enum: StatutEvenementType,
enumName: 'statut_evenement_type',
name: 'statut',
default: StatutEvenementType.PROPOSE
})
status: StatutEvenementType;
@Column({type: 'timestamptz', nullable: true, name: 'delai_grace'})
grace_deadline?: Date;
@Column({type: 'boolean', default: false, name: 'urgent'})
urgent: boolean;
@CreateDateColumn({ name: 'cree_le', type: 'timestamptz' })
created_at: Date;
@UpdateDateColumn({ name: 'modifie_le', type: 'timestamptz' })
updated_at: Date;
}
+20 -31
View File
@@ -35,15 +35,13 @@ DO $$ BEGIN
IF NOT EXISTS (SELECT 1 FROM pg_type WHERE typname = 'statut_avenant_type') THEN IF NOT EXISTS (SELECT 1 FROM pg_type WHERE typname = 'statut_avenant_type') THEN
CREATE TYPE statut_avenant_type AS ENUM ('propose', 'accepte', 'refuse'); CREATE TYPE statut_avenant_type AS ENUM ('propose', 'accepte', 'refuse');
END IF; END IF;
IF NOT EXISTS (SELECT 1 FROM pg_type WHERE typname = 'type_absence_garde_type') THEN IF NOT EXISTS (SELECT 1 FROM pg_type WHERE typname = 'type_evenement_type') THEN
CREATE TYPE type_absence_garde_type AS ENUM ( CREATE TYPE type_evenement_type AS ENUM (
'absence_enfant', 'conge_am', 'arret_maladie_am' 'absence_enfant', 'conge_am', 'conge_parent', 'arret_maladie_am', 'evenement_rpe'
); );
END IF; END IF;
IF NOT EXISTS (SELECT 1 FROM pg_type WHERE typname = 'statut_absence_garde_type') THEN IF NOT EXISTS (SELECT 1 FROM pg_type WHERE typname = 'statut_evenement_type') THEN
CREATE TYPE statut_absence_garde_type AS ENUM ( CREATE TYPE statut_evenement_type AS ENUM ('propose', 'valide', 'refuse');
'en_attente', 'accepte', 'refuse'
);
END IF; END IF;
IF NOT EXISTS (SELECT 1 FROM pg_type WHERE typname = 'statut_validation_type') THEN IF NOT EXISTS (SELECT 1 FROM pg_type WHERE typname = 'statut_validation_type') THEN
CREATE TYPE statut_validation_type AS ENUM ('en_attente', 'valide', 'refuse'); CREATE TYPE statut_validation_type AS ENUM ('en_attente', 'valide', 'refuse');
@@ -309,34 +307,25 @@ CREATE TABLE avenants_contrats (
); );
-- ========================================================== -- ==========================================================
-- Table : absences_garde (vérité métier absences/congés/arrêt) -- Table : evenements
-- 1 ligne = 1 période ; rattachement = placement AM↔enfant (#193)
-- ========================================================== -- ==========================================================
CREATE TABLE absences_garde ( CREATE TABLE evenements (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(), id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
id_placement UUID NOT NULL type type_evenement_type,
REFERENCES enfants_assistantes_maternelles(id) ON DELETE CASCADE, id_enfant UUID REFERENCES enfants(id) ON DELETE CASCADE,
type type_absence_garde_type NOT NULL, id_am UUID REFERENCES utilisateurs(id),
date_debut DATE NOT NULL, id_parent UUID REFERENCES parents(id_utilisateur),
date_fin DATE NOT NULL, cree_par UUID REFERENCES utilisateurs(id),
statut statut_absence_garde_type NOT NULL DEFAULT 'en_attente', date_debut TIMESTAMPTZ,
expire_at TIMESTAMPTZ NOT NULL, date_fin TIMESTAMPTZ,
cree_par UUID REFERENCES utilisateurs(id) ON DELETE SET NULL, commentaires TEXT,
id_card_instance UUID, statut statut_evenement_type DEFAULT 'propose',
motif TEXT, delai_grace TIMESTAMPTZ,
cree_le TIMESTAMPTZ NOT NULL DEFAULT now(), urgent BOOLEAN DEFAULT false,
modifie_le TIMESTAMPTZ NOT NULL DEFAULT now(), cree_le TIMESTAMPTZ DEFAULT now(),
CONSTRAINT chk_absences_garde_dates CHECK (date_fin >= date_debut) modifie_le TIMESTAMPTZ DEFAULT now()
); );
CREATE INDEX idx_absences_garde_placement_dates
ON absences_garde (id_placement, date_debut, date_fin);
CREATE INDEX idx_absences_garde_placement_type_statut
ON absences_garde (id_placement, type, statut);
CREATE INDEX idx_absences_garde_expire_at
ON absences_garde (expire_at)
WHERE statut IN ('en_attente', 'refuse');
-- ========================================================== -- ==========================================================
-- Table : signalements_bugs -- Table : signalements_bugs
-- ========================================================== -- ==========================================================
+10 -10
View File
@@ -104,31 +104,31 @@ Ce document recense **toutes les valeurs énumérées** utilisées dans la base
--- ---
## 7) Type dabsence de garde — `type` ## 7) Type dévénement — `type`
**Tables/colonnes** : `absences_garde.type` **Tables/colonnes** : `evenements.type`
**Valeurs autorisées** : **Valeurs autorisées** :
| Valeur | Description | | Valeur | Description |
|---|---| |---|---|
| `absence_enfant` | Absence déclarée par un parent | | `absence_enfant` | Enfant absent |
| `conge_am` | Congé de lassistante maternelle | | `conge_am` | Congé de lassistante maternelle |
| `conge_parent` | Congé du parent |
| `arret_maladie_am` | Arrêt maladie AM | | `arret_maladie_am` | Arrêt maladie AM |
| `evenement_rpe` | Événement RPE |
> Remplace lancien enum `type_evenement_type` / table `evenements` (supprimés ticket #193).
--- ---
## 8) Statut dabsence de garde — `statut` ## 8) Statut dévénement — `statut`
**Tables/colonnes** : `absences_garde.statut` **Tables/colonnes** : `evenements.statut`
**Valeurs autorisées** : **Valeurs autorisées** :
| Valeur | Description | | Valeur | Description |
|---|---| |---|---|
| `en_attente` | En attente de validation / ack | | `propose` | Événement proposé |
| `accepte` | Accepté / acté (conservé en historique métier) | | `valide` | Événement validé |
| `refuse` | Refusé (temporaire ; purge TTL) | | `rejete` | Événement refusé |
--- ---
+10 -6
View File
@@ -42,8 +42,10 @@ Documenter, de façon unique et partagée, les règles de suppression/mise à jo
| **contrats(id_dossier)**`dossiers(id)` | **CASCADE** | 1:1, contrat détruit si dossier supprimé | | **contrats(id_dossier)**`dossiers(id)` | **CASCADE** | 1:1, contrat détruit si dossier supprimé |
| **avenants_contrats(id_contrat)**`contrats(id)` | **CASCADE** | Avenants détruits avec le contrat | | **avenants_contrats(id_contrat)**`contrats(id)` | **CASCADE** | Avenants détruits avec le contrat |
| **avenants_contrats(initie_par)**`utilisateurs(id)` | **SET NULL** | Historiser lavenant sans bloquer | | **avenants_contrats(initie_par)**`utilisateurs(id)` | **SET NULL** | Historiser lavenant sans bloquer |
| **absences_garde(id_placement)**`enfants_assistantes_maternelles(id)` | **CASCADE** | Plus de couple = plus dabsences | | **evenements(id_enfant)**`enfants(id)` | **CASCADE** | Événements nont plus de sens |
| **absences_garde(cree_par)**`utilisateurs(id)` | **SET NULL** | Conserver la période si user supprimé | | **evenements(id_am)**`utilisateurs(id)` | **SET NULL** | Garder la trace même si AM supprimée |
| **evenements(id_parent)**`parents(id_utilisateur)` | **SET NULL** | Garder la trace si parent supprimé |
| **evenements(cree_par)**`utilisateurs(id)` | **SET NULL** | Conserver lhistorique de création |
| **signalements_bugs(id_utilisateur)**`utilisateurs(id)` | **SET NULL** | Conserver le ticket même si compte supprimé | | **signalements_bugs(id_utilisateur)**`utilisateurs(id)` | **SET NULL** | Conserver le ticket même si compte supprimé |
| **uploads(id_utilisateur)**`utilisateurs(id)` | **SET NULL** | Fichier reste référencé sans lauteur | | **uploads(id_utilisateur)**`utilisateurs(id)` | **SET NULL** | Fichier reste référencé sans lauteur |
| **notifications(id_utilisateur)**`utilisateurs(id)` | **CASCADE** | Notifications propres à lutilisateur | | **notifications(id_utilisateur)**`utilisateurs(id)` | **CASCADE** | Notifications propres à lutilisateur |
@@ -77,8 +79,10 @@ Documenter, de façon unique et partagée, les règles de suppression/mise à jo
- `avenants_contrats.initie_par`**SET NULL** - `avenants_contrats.initie_par`**SET NULL**
### Événements ### Événements
- `absences_garde.id_placement`**CASCADE** - `evenements.id_enfant`**CASCADE**
- `absences_garde.cree_par`**SET NULL** - `evenements.id_am`**SET NULL**
- `evenements.id_parent`**SET NULL**
- `evenements.cree_par`**SET NULL**
### Divers ### Divers
- `signalements_bugs.id_utilisateur`**SET NULL** - `signalements_bugs.id_utilisateur`**SET NULL**
@@ -105,11 +109,11 @@ Documenter, de façon unique et partagée, les règles de suppression/mise à jo
4. **Suppression dun enfant** 4. **Suppression dun enfant**
- Supprimer `enfants(id=childA)` - Supprimer `enfants(id=childA)`
- Attendu : `enfants_parents` (CASCADE), `dossiers` du childA (CASCADE), `absences_garde` des placements du childA (CASCADE via EAM). - Attendu : `enfants_parents` (CASCADE), `dossiers` du childA (CASCADE), `evenements` du childA (CASCADE).
5. **Suppression dun utilisateur AM** 5. **Suppression dun utilisateur AM**
- Supprimer `utilisateurs(id=amB)` - Supprimer `utilisateurs(id=amB)`
- Attendu : absences liées via placement AM (CASCADE si le lien EAM est retiré). - Attendu : `evenements.id_am` devient **NULL** (historique conservé).
--- ---
@@ -1,85 +0,0 @@
-- Ticket #193 — Back métier absences / congés / arrêt (périodes par placement)
-- Idempotent : safe à rejouer.
-- Remplace la table legacy `evenements` (mal conçue, non utilisée en API).
-- ---------------------------------------------------------------------------
-- Enums
-- ---------------------------------------------------------------------------
DO $$
BEGIN
IF NOT EXISTS (SELECT 1 FROM pg_type WHERE typname = 'type_absence_garde_type') THEN
CREATE TYPE type_absence_garde_type AS ENUM (
'absence_enfant',
'conge_am',
'arret_maladie_am'
);
END IF;
IF NOT EXISTS (SELECT 1 FROM pg_type WHERE typname = 'statut_absence_garde_type') THEN
CREATE TYPE statut_absence_garde_type AS ENUM (
'en_attente',
'accepte',
'refuse'
);
END IF;
END $$;
-- ---------------------------------------------------------------------------
-- Table absences_garde (1 ligne = 1 période)
-- ---------------------------------------------------------------------------
CREATE TABLE IF NOT EXISTS absences_garde (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
id_placement UUID NOT NULL
REFERENCES enfants_assistantes_maternelles(id) ON DELETE CASCADE,
type type_absence_garde_type NOT NULL,
date_debut DATE NOT NULL,
date_fin DATE NOT NULL,
statut statut_absence_garde_type NOT NULL DEFAULT 'en_attente',
-- TTL purge : obligatoire ; pour statut=accepte utiliser 'infinity' (pas de purge métier)
expire_at TIMESTAMPTZ NOT NULL,
cree_par UUID REFERENCES utilisateurs(id) ON DELETE SET NULL,
id_card_instance UUID NULL,
motif TEXT,
cree_le TIMESTAMPTZ NOT NULL DEFAULT now(),
modifie_le TIMESTAMPTZ NOT NULL DEFAULT now(),
CONSTRAINT chk_absences_garde_dates CHECK (date_fin >= date_debut)
);
CREATE INDEX IF NOT EXISTS idx_absences_garde_placement_dates
ON absences_garde (id_placement, date_debut, date_fin);
CREATE INDEX IF NOT EXISTS idx_absences_garde_placement_type_statut
ON absences_garde (id_placement, type, statut);
CREATE INDEX IF NOT EXISTS idx_absences_garde_expire_at
ON absences_garde (expire_at)
WHERE statut IN ('en_attente', 'refuse');
COMMENT ON TABLE absences_garde IS
'Vérité métier des absences/congés/arrêts par couple AM↔enfant (placement). Les cartes collectent ; cette table stocke.';
COMMENT ON COLUMN absences_garde.expire_at IS
'Purge auto (job ultérieur) pour en_attente/refuse. accepte → infinity.';
COMMENT ON COLUMN absences_garde.id_card_instance IS
'Réf. carte de collecte (FK cards quand le module Cartes existera).';
-- ---------------------------------------------------------------------------
-- Drop legacy evenements (+ enums si plus référencés)
-- ---------------------------------------------------------------------------
DROP TABLE IF EXISTS evenements CASCADE;
DO $$
BEGIN
IF EXISTS (SELECT 1 FROM pg_type WHERE typname = 'type_evenement_type')
AND NOT EXISTS (
SELECT 1 FROM information_schema.columns
WHERE udt_name = 'type_evenement_type'
) THEN
DROP TYPE type_evenement_type;
END IF;
IF EXISTS (SELECT 1 FROM pg_type WHERE typname = 'statut_evenement_type')
AND NOT EXISTS (
SELECT 1 FROM information_schema.columns
WHERE udt_name = 'statut_evenement_type'
) THEN
DROP TYPE statut_evenement_type;
END IF;
END $$;
+16 -2
View File
@@ -161,9 +161,23 @@ VALUES (
ON CONFLICT (id) DO NOTHING; ON CONFLICT (id) DO NOTHING;
-- ------------------------------------------------------------ -- ------------------------------------------------------------
-- Absences_garde : seeds quand placements EAM présents (API / ticket peuplement) -- Événement (absence enfant)
-- Legacy evenements supprimée (#193).
-- ------------------------------------------------------------ -- ------------------------------------------------------------
INSERT INTO evenements (id, type, id_enfant, id_am, id_parent, cree_par, date_debut, date_fin, commentaires, statut, urgence)
VALUES (
'e0000000-0000-0000-0000-000000000001',
'absence_enfant',
'aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa',
'66666666-6666-6666-6666-666666666666',
'33333333-3333-3333-3333-333333333333',
'33333333-3333-3333-3333-333333333333',
'2025-09-12',
'2025-09-12',
'Enfant malade (rhume).',
'propose',
false
)
ON CONFLICT (id) DO NOTHING;
-- ------------------------------------------------------------ -- ------------------------------------------------------------
-- Upload (justificatif lié au dossier) -- Upload (justificatif lié au dossier)
+17 -16
View File
@@ -79,11 +79,12 @@ LEFT JOIN avenants_contrats a ON a.id_contrat = c.id
GROUP BY c.id, c.id_dossier, c.statut GROUP BY c.id, c.id_dossier, c.statut
ORDER BY c.cree_le DESC; ORDER BY c.cree_le DESC;
\echo '=== 9) Absences_garde (30 derniers jours) =====================' \echo '=== 9) Evénements par enfant (30 derniers jours) =============='
SELECT ag.id, ag.type, ag.id_placement, ag.date_debut, ag.date_fin, ag.statut, ag.expire_at SELECT ev.id, ev.type, ev.id_enfant, e.prenom AS enfant, ev.date_debut, ev.date_fin, ev.statut
FROM absences_garde ag FROM evenements ev
WHERE ag.date_debut >= (NOW()::date - INTERVAL '30 days') JOIN enfants e ON e.id = ev.id_enfant
ORDER BY ag.date_debut DESC; WHERE ev.date_debut >= (NOW()::date - INTERVAL '30 days')
ORDER BY ev.date_debut DESC;
\echo '=== 10) Uploads & notifications récentes =======================' \echo '=== 10) Uploads & notifications récentes ======================='
SELECT u.courriel, up.fichier_url, up.type_fichier, up.cree_le SELECT u.courriel, up.fichier_url, up.type_fichier, up.cree_le
@@ -134,11 +135,11 @@ FROM avenants_contrats a
LEFT JOIN contrats c ON c.id = a.id_contrat LEFT JOIN contrats c ON c.id = a.id_contrat
WHERE c.id IS NULL; WHERE c.id IS NULL;
-- Absences sans placement -- Evénements sans enfant
SELECT ag.* SELECT ev.*
FROM absences_garde ag FROM evenements ev
LEFT JOIN enfants_assistantes_maternelles eam ON eam.id = ag.id_placement LEFT JOIN enfants e ON e.id = ev.id_enfant
WHERE eam.id IS NULL; WHERE e.id IS NULL;
\echo '=== 13) Performance : EXPLAIN sur requêtes clés ===============' \echo '=== 13) Performance : EXPLAIN sur requêtes clés ==============='
@@ -150,12 +151,12 @@ WHERE m.id_dossier = 'dddddddd-dddd-dddd-dddd-dddddddddddd'
ORDER BY m.cree_le DESC ORDER BY m.cree_le DESC
LIMIT 20; LIMIT 20;
-- Absences par placement et période (idx_absences_garde_placement_dates) -- Evénements par enfant et période (idx_evenements_id_enfant_date_debut)
EXPLAIN ANALYZE EXPLAIN ANALYZE
SELECT ag.* SELECT ev.*
FROM absences_garde ag FROM evenements ev
WHERE ag.id_placement IS NOT NULL WHERE ev.id_enfant = 'aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa'
AND ag.date_debut >= '2025-01-01'; AND ev.date_debut >= '2025-01-01';
-- Notifications non lues (idx_notifications_user_lu_cree_le) -- Notifications non lues (idx_notifications_user_lu_cree_le)
EXPLAIN ANALYZE EXPLAIN ANALYZE
@@ -198,7 +199,7 @@ SELECT
(SELECT COUNT(*) FROM messages) AS nb_messages, (SELECT COUNT(*) FROM messages) AS nb_messages,
(SELECT COUNT(*) FROM contrats) AS nb_contrats, (SELECT COUNT(*) FROM contrats) AS nb_contrats,
(SELECT COUNT(*) FROM avenants_contrats) AS nb_avenants, (SELECT COUNT(*) FROM avenants_contrats) AS nb_avenants,
(SELECT COUNT(*) FROM absences_garde) AS nb_absences_garde, (SELECT COUNT(*) FROM evenements) AS nb_evenements,
(SELECT COUNT(*) FROM uploads) AS nb_uploads, (SELECT COUNT(*) FROM uploads) AS nb_uploads,
(SELECT COUNT(*) FROM notifications) AS nb_notifications, (SELECT COUNT(*) FROM notifications) AS nb_notifications,
(SELECT COUNT(*) FROM validations) AS nb_validations; (SELECT COUNT(*) FROM validations) AS nb_validations;
+4 -18
View File
@@ -1,6 +1,6 @@
# 📋 Décisions Projet - P'titsPas # 📋 Décisions Projet - P'titsPas
**Version** : 1.4 **Version** : 1.3
**Date** : 24 Septembre 2026 **Date** : 24 Septembre 2026
**Auteur** : Équipe PtitsPas **Auteur** : Équipe PtitsPas
@@ -570,19 +570,6 @@ POST /repos/jmartin/petitspas/pulls/{index}/merge
--- ---
### 32. Module Absences + Cartes (séparation back / collecte)
**Décision** : ✅ **Back `absences_garde` = vérité métier** ; **Cartes = file dattention / collecte** (plugin isolé). Types SYSTEM (absence, congé, arrêt) indéboulonnables ; types OPTIONNELS (sondages…) plus tard. Annulation = DELETE. `expire_at` dès V1.
**Justification** :
- Premier vrai module dinteraction multi-acteurs
- Évite de stocker lhistorique congés dans des bulles éphémères
- Portabilité / généricité des cartes sans coupler le métier garde
**Flux V1** : BDD absences → API liste/CRUD → module Cartes SYSTEM → front bulles (séparé).
---
## 📋 Résumé des décisions critiques ## 📋 Résumé des décisions critiques
| # | Décision | Statut | Impact | | # | Décision | Statut | Impact |
@@ -603,7 +590,6 @@ POST /repos/jmartin/petitspas/pulls/{index}/merge
| 14 | Migration données | ❌ Rejeté | N/A | | 14 | Migration données | ❌ Rejeté | N/A |
| 15 | Doc utilisateur | ⏸️ Phase 2 | Formation | | 15 | Doc utilisateur | ⏸️ Phase 2 | Formation |
| 31 | Logs Winston | ✅ Phase 1 | Monitoring | | 31 | Logs Winston | ✅ Phase 1 | Monitoring |
| 32 | Absences back + Cartes collecte | ✅ 0.2.0 | Métier / archi |
| 5bis | Familles recomposées — 2ᵉ compte v1.0.0 | ✅ v1.0.0 | Métier / dossier | | 5bis | Familles recomposées — 2ᵉ compte v1.0.0 | ✅ v1.0.0 | Métier / dossier |
--- ---
@@ -615,11 +601,11 @@ POST /repos/jmartin/petitspas/pulls/{index}/merge
| 25/11/2025 | 1.0 | Création du document - Toutes les décisions initiales | | 25/11/2025 | 1.0 | Création du document - Toutes les décisions initiales |
| 09/02/2026 | 1.1 | Configuration initiale : un seul panneau Paramètres (3 sections) dans le dashboard, plus de Setup Wizard dédié ; navigation bloquée jusqu'à sauvegarde | | 09/02/2026 | 1.1 | Configuration initiale : un seul panneau Paramètres (3 sections) dans le dashboard, plus de Setup Wizard dédié ; navigation bloquée jusqu'à sauvegarde |
| 16/06/2026 | 1.2 | Décision 5bis — familles recomposées, contournement v1.0.0 ; lien doc [28](./28_EVOLUTION-FAMILLE-ET-RESPONSABLES.md) | | 16/06/2026 | 1.2 | Décision 5bis — familles recomposées, contournement v1.0.0 ; lien doc [28](./28_EVOLUTION-FAMILLE-ET-RESPONSABLES.md) |
| 24/09/2026 | 1.4 | Décision 32 — Absences (`absences_garde`) ≠ Cartes ; Epic C recentré ; drop `evenements` | | 16/06/2026 | 1.3 | Précision 5bis — cible post-1.0.0 : parcours gestionnaire § 7.5 (#139), visibilité par enfant |
--- ---
**Dernière mise à jour** : 24 Septembre 2026 **Dernière mise à jour** : 16 Juin 2026
**Version** : 1.4 **Version** : 1.2
**Statut** : ✅ Document validé **Statut** : ✅ Document validé
+20 -31
View File
@@ -1,9 +1,9 @@
# Découpage tickets — Quotidien parent / AM # Découpage tickets — Quotidien parent / AM
> **Statut :** backlog Gitea **0.2.0** / épic [#165](https://git.ptits-pas.fr/jmartin/petitspas/issues/165) — architecture absences + cartes recentrée (sept. 2026). > **Statut :** backlog Gitea créé (**milestone `0.2.0`**, **#165#189**) — *création anticipée avant validation PO* ; **descriptions enrichies** ensuite à partir de la mini-spec / découpage.
> **Réf. visuelle :** [maquettes/courantes/maquette-dashboard-parent-quotidien-v4.png](./maquettes/courantes/maquette-dashboard-parent-quotidien-v4.png) > **Réf. visuelle :** [maquettes/courantes/maquette-dashboard-parent-quotidien-v4.png](./maquettes/courantes/maquette-dashboard-parent-quotidien-v4.png)
> **Mini-spec :** [31_MINI-SPEC-QUOTIDIEN-PARENT-AM.md](./31_MINI-SPEC-QUOTIDIEN-PARENT-AM.md) > **Mini-spec :** [31_MINI-SPEC-QUOTIDIEN-PARENT-AM.md](./31_MINI-SPEC-QUOTIDIEN-PARENT-AM.md)
> **Décision :** [24_DECISIONS-PROJET.md](./24_DECISIONS-PROJET.md) §32 (Cartes ≠ back Absences). > **Règle :** tickets **front** / **back** séparés · widgets partagés parent↔AM · **pas dimplé code** tant que le PO na pas validé le backlog.
## Intention produit (rappel) ## Intention produit (rappel)
@@ -96,31 +96,22 @@ Liste des enfants / foyers pour lAM + contexte courant (symétrique A3).
--- ---
## Epic C — Absences + Cartes (file dattention) ## Epic C — Cartes (file du quotidien)
**Séparation :** back **`absences_garde`** = vérité métier (périodes / placement) ; module **Cartes** = collecte / bulles / workflow. Annulation = DELETE. `expire_at`s le modèle. ### C1 — [Back] Modèle + API cartes / événements de garde
Types V1 : absence enfant, congé AM, maladie AM (« arrêt »), sortie à valider. CRUD / transitions de statut ; liaison couple / agenda (hook minimal). Règles : absence enfant sans veto AM ; congé AM accepter/refuser (**1 parent suffit**) ; maladie AM accusé parent ; sortie **1 parent suffit**. Aucun doc médical stocké.
### Back (ordre) ### C2 — [Front] Flux de cartes colonne gauche (parent)
Liste scroll pastel (palette `assets/cards/` — 7 couleurs) ; ouverture détail ; actions valider / refuser / accusé selon type. Bouton **Déclarer une absence** (+ autres actions TBD plus tard).
| Étape | Contenu | ### C3 — [Front] Flux de cartes colonne gauche (AM)
|-------|---------| Miroir : création congé / maladie / sortie ; lecture absences enfants du jour / à venir.
| BDD | Table `absences_garde` + drop `evenements` |
| API | CRUD + **GET liste** (`placementId` \| tous les placements du user) |
| Cartes SYSTEM | Module `cards/` types S1S3 (sans sondages V1) |
| Realtime | WS/SSE bulles |
| Purge TTL | Job `expire_at` / `purge_at` |
### Front (après API — hors chantier back immédiat) ### C4 — [Front] Formulaire déclarer une absence (parent)
Saisie période (+ motif léger si besoin) → crée une carte côté AM.
| Ticket | Contenu | ### C5 — [Front] Formulaires AM congé / maladie / sortie
|--------|---------| Création des cartes correspondantes + ciblage enfants si sortie.
| Feed parent / AM | File dattention bulles (widget partagé) |
| Modale « Ajouter une bulle » | Générique + absence parent / congé·arrêt AM |
| Agenda | Consommer GET liste (lignes) |
### Hors V1 cartes
Sondages / catalogue admin OPTIONNEL / sortie riche / desktop 2 panneaux (évolution séparée).
--- ---
@@ -194,15 +185,13 @@ Scripts / seeds : foyer 2 parents, AM, enfant(s), quelques cartes, posts blog, f
## Ordre de réalisation suggéré ## Ordre de réalisation suggéré
1. **A1 → A2 → A3** (coquille + contexte parent)*fait* 1. **A1 → A2 → A3** (coquille + contexte parent)
2. **BDD absences → API absences** puis **Cartes SYSTEM** (congés/absences/arrêt) 2. **C1 → C2 / C4** (premières cartes utiles)
3. **Feed / modale bulles** (front) + agenda lignes 3. **D1 → D2 / D3** (blog central)
4. **D1 → D2 / D3** (blog) 4. **E1 → E2 → E4** (messagerie AM)
5. **E1 → E2 → E4** (messagerie AM) 5. **B1 → B2 → B3** + miroirs C3/C5/D3/E5 (AM)
6. **B1 → B2 → B3** + miroirs AM 6. **E3 / E5 / E6 / D4** (RPE)
7. Realtime / purge TTL / RPE / F/G 7. **F1 → F2** + **G1** (nav, mobile, seeds)
Desktop 2 panneaux (cartes prioritaires sur blog) = **évolution hors 0.2.0**.
--- ---
+7 -13
View File
@@ -61,20 +61,14 @@ Bandeau : **TdB** · **Agenda** · **Contrat** · menu user (recherche AM, param
| **Mess. AM** | Chat foyer ↔ AM (style WhatsApp : texte, emoji, images) | | **Mess. AM** | Chat foyer ↔ AM (style WhatsApp : texte, emoji, images) |
| **Mess. RPE** | Privée par défaut ; ajout de participants pour médiation / conflit | | **Mess. RPE** | Privée par défaut ; ajout de participants pour médiation / conflit |
## 5. Règles métier V1 (absences / congés) ## 5. Règles métier V1
| Type | Qui initie | Validation / effet | | Type | Qui initie | Validation |
|------|------------|-------------------| |------|------------|------------|
| Absence enfant | Parent | Pas de veto AM ; période **acceptée** tout de suite ; bulle info AM | | Absence enfant | Parent | Pas de veto AM |
| Congé AM | AM | **1 parent** accepte **ou** refuse (+ motivation) → bounce AM (modif/renvoi ou DELETE) | | Congé AM | AM | **1 parent** accepte ou refuse |
| Modification congé AM déjà accepté | AM | Même `id` absence ; re-validation parents ; dates actives = anciennes tant quen attente | | Maladie AM | AM | Parent accuse réception (pas de doc médical in-app) |
| Modification absence enfant | Parent | Update immédiat + bulle **ack** AM (OK) | | Sortie | AM / RPE | **1 parent** suffit (présence / absence) ; explication aussi via blog |
| Maladie AM | AM | Parent **ack** (« bien reçu ») ; **aucun** doc médical |
| Sortie / sondage | — | **Plus tard** (types optionnels) |
**Stockage :** table `absences_garde` (1 ligne = période, `id_placement`, `expire_at`). Les **cartes** collectent ; elles ne sont pas la source de vérité. Annulation = DELETE.
**Péremption cartes :** mémoire courte (`retention_days` / `purge_at`) — pas un historique de vie (≠ messagerie).
- Mess. AM : les **2 parents** voient le **même** fil — **pas** de masquage V1 - Mess. AM : les **2 parents** voient le **même** fil — **pas** de masquage V1
- Blog auteurs V1 : **AM** + **gestionnaire (RPE)** — parent auteur = plus tard - Blog auteurs V1 : **AM** + **gestionnaire (RPE)** — parent auteur = plus tard