# Passation RH Connect

Version documentaire : 31 août 2026  
Source analysée : archive de la branche `dev` après intégration de `feature/etats-rh`  
Application : RH Connect — Envie 2E Nord

Ce dossier est la documentation de référence pour reprendre, exploiter et faire évoluer RH Connect. Il complète les fichiers historiques du dépôt sans les remplacer.

Le fichier `Manuel-de-passation-RH-Connect.docx` rassemble les quinze chapitres dans une version Word mise en page et imprimable. Les fichiers Markdown restent la version la plus pratique à maintenir dans Git.

## Parcours conseillé

| Besoin | Document |
|---|---|
| Comprendre l’application en 15 minutes | `docs/passation/01-vue-ensemble.md` |
| Comprendre les composants et les flux | `docs/passation/02-architecture-et-flux.md` |
| Installer ou reconstituer un environnement | `docs/passation/03-installation-et-configuration.md` |
| Comprendre la base et Prisma | `docs/passation/04-base-de-donnees-et-migrations.md` |
| Gérer SSO, utilisateurs et droits | `docs/passation/05-authentification-et-habilitations.md` |
| Comprendre les règles RH | `docs/passation/06-modules-et-regles-metier.md` |
| Maintenir documents, états et paies | `docs/passation/07-documents-et-fiches-de-paie.md` |
| Exploiter mails, alertes et procédures | `docs/passation/08-mails-alertes-et-procedures.md` |
| Modifier et tester l’application | `docs/passation/09-guide-developpement.md` |
| Déployer, sauvegarder, superviser | `docs/passation/10-exploitation-et-deploiement.md` |
| Diagnostiquer un incident | `docs/passation/11-depannage.md` |
| Réaliser la passation | `docs/passation/12-checklists.md` |
| Connaître l’inventaire et les dettes | `docs/passation/13-inventaire-technique.md` |
| Reprendre les demandes de fin de stage | `docs/passation/14-evolutions-et-backlog.md` |
| Créer un nouveau modèle DOCX | `docs/passation/15-guide-champs-modeles-documents.md` |
| Mettre en production la base préparée | `exploitation/guide-mise-en-production-linux.txt` |

## Sources de vérité

1. Le code et le schéma Prisma de la branche déployée.
2. Les variables effectives de l’environnement cible.
3. La base MySQL et les volumes réellement montés.
4. Cette documentation.
5. Les anciens rapports de migration, uniquement comme historique.

Ne jamais considérer `docs/RAPPORT_CLOTURE.md` comme l’état courant de la base : il décrit une étape de migration antérieure.

## Règles absolues d’exploitation

- Sauvegarder MySQL et les deux stockages de fichiers avant toute opération risquée.
- Ne jamais exécuter `docker compose down -v` sur un environnement contenant des données utiles.
- Ne jamais committer `.env`, `.env.production`, les dumps SQL, les bulletins de paie ou les modèles DOCX réels.
- Ne jamais lancer `prisma migrate deploy` à l’aveugle sur une base historique non baselinée : l’erreur Prisma `P3005` signifie que le schéma est déjà rempli mais que l’historique Prisma n’est pas initialisé.
- Tester une restauration, pas seulement la création d’une sauvegarde.
- Le backend est l’autorité de sécurité ; masquer un bouton dans le frontend ne protège pas une API.