feat : notification de fin de contrat (veille ouvrée du dernier jour) #35

2026-06-24T13:51:12Z

tristan commented

2026-06-24 13:51:12 +00:00

Objectif

Prévenir automatiquement les administrateurs, sur le dernier jour ouvré précédant la fin d'un contrat, qu'un salarié arrive au terme de son emploi.

Fonctionnement

Commande quotidienne app:contract:end-notifications (à brancher sur le crontab prod, ~6h ; option --date=YYYY-MM-DD pour test/rattrapage).
Cible la dernière période de contrat d'un employé (un changement de contrat enchaîné, ex. CDD→CDI, ne notifie pas).
Notifie sur le dernier jour ouvré strictement avant endDate (inclusif). Week-ends et fériés sautés → une fin de contrat le lundi est signalée dès le vendredi. Le Lundi de Pentecôte reste un jour ouvré (cohérent avec le reste de l'app).
Une notification par admin : message « Fin de {nature} de {Nom} le {date} », catégorie Contrat, lien /employees/{id}, sans acteur.
Idempotent : déduplication par (recipient, category, target, message).
Front : la cloche (déjà admin-only) affiche proprement les notifs sans acteur.
Aucune migration (réutilise la table notifications).

Architecture

Logique pure isolée et testée : WorkingDayCalculator (week-end + férié) + ContractEndNotificationPlanner (fenêtre + message). Persistance dans ContractEndNotificationService, exposée par ContractEndNotificationCommand. Méthodes repo findLatestPeriodsForAllEmployees + existsForRecipientCategoryTargetMessage.

Tests & vérification

11 tests unitaires ajoutés ; suite complète verte (264 tests, 564 assertions).
Vérif e2e manuelle : run du vendredi → 6 notifs/1 contrat finissant le lundi (saut de week-end OK), relance idempotente (0), contenu BDD correct.

Documentation

doc/contract-end-notifications.md, doc/functional-rules.md (§15), doc in-app (documentation-content.ts), CLAUDE.md.

⚠️ Tâche infra

Ajouter la ligne crontab prod : 0 6 * * * … bin/console app:contract:end-notifications

🤖 Generated with Claude Code

## Objectif Prévenir automatiquement les administrateurs, sur le **dernier jour ouvré précédant la fin d'un contrat**, qu'un salarié arrive au terme de son emploi. ## Fonctionnement - Commande quotidienne `app:contract:end-notifications` (à brancher sur le crontab prod, ~6h ; option `--date=YYYY-MM-DD` pour test/rattrapage). - Cible **la dernière période de contrat** d'un employé (un changement de contrat enchaîné, ex. CDD→CDI, ne notifie pas). - Notifie sur le **dernier jour ouvré strictement avant** `endDate` (inclusif). Week-ends **et fériés** sautés → une fin de contrat le lundi est signalée dès le vendredi. Le Lundi de Pentecôte reste un jour ouvré (cohérent avec le reste de l'app). - Une notification par admin : message « Fin de {nature} de {Nom} le {date} », catégorie `Contrat`, lien `/employees/{id}`, sans acteur. - **Idempotent** : déduplication par `(recipient, category, target, message)`. - Front : la cloche (déjà admin-only) affiche proprement les notifs sans acteur. - **Aucune migration** (réutilise la table `notifications`). ## Architecture Logique pure isolée et testée : `WorkingDayCalculator` (week-end + férié) + `ContractEndNotificationPlanner` (fenêtre + message). Persistance dans `ContractEndNotificationService`, exposée par `ContractEndNotificationCommand`. Méthodes repo `findLatestPeriodsForAllEmployees` + `existsForRecipientCategoryTargetMessage`. ## Tests & vérification - 11 tests unitaires ajoutés ; suite complète verte (264 tests, 564 assertions). - Vérif e2e manuelle : run du vendredi → 6 notifs/1 contrat finissant le lundi (saut de week-end OK), relance idempotente (0), contenu BDD correct. ## Documentation `doc/contract-end-notifications.md`, `doc/functional-rules.md` (§15), doc in-app (`documentation-content.ts`), `CLAUDE.md`. ## ⚠️ Tâche infra Ajouter la ligne crontab prod : `0 6 * * * … bin/console app:contract:end-notifications` 🤖 Generated with [Claude Code](https://claude.com/claude-code)

tristan added 10 commits 2026-06-24 13:51:12 +00:00

docs : design notification fin de contrat (veille du dernier jour) 0bdc639f01

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs : plan d'implémentation notification fin de contrat 7e943a44e6

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat : add working day calculator (weekend + holiday aware) a479236489

feat : add contract end notice DTO 3b63817348

feat : add contract end notification planner 75c3438ea9

feat : add repository queries for contract end notifications d5cf7c7058

feat : add contract end notification service and command baa824d2d2

feat : render actorless notifications without empty bold span 87444965be

docs : document contract end notification feature 5e2c6c219b

docs : note Lundi de Pentecôte traité comme jour ouvré (choix délibéré) d201489bcb

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

tristan merged commit 029a09dc09 into develop

2026-06-24 14:04:54 +00:00

tristan deleted branch feature/SIRH-43-ajouter-une-notif-la-veille-d-un-contrat-qui-se-te

2026-06-24 14:04:55 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: MALIO-DEV/SIRH#35