chore(doc): update doc for dev

Author: pYassine

README.md

@@ -5,7 +5,116 @@
 [![Build Status](https://gitlab.factory.social.gouv.fr/SocialGouv/domifa/badges/master/pipeline.svg)](https://gitlab.factory.social.gouv.fr/SocialGouv/domifa/-/commits/master)
 [![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2FSocialGouv%2Fdomifa.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2FSocialGouv%2Fdomifa?ref=badge_shield)
 
-> Faciliter l'accès aux droits pour les personnes sans domicile stable, en simplifiant la gestion de la domiciliation
+> DomiFa est une plateforme numérique qui facilite la gestion de la domiciliation pour les organismes agréés et permet aux personnes sans domicile stable d'accéder à leurs droits.
+
+🌐 **Homepage** : https://domifa.fabrique.social.gouv.fr
+
+## 🚀 Démarrage rapide
+
+### Prérequis
+
+- Node.js (version LTS recommandée)
+- Yarn (gestionnaire de packages)
+- Docker et Docker Compose
+- PostgreSQL (ou via Docker)
+
+### Installation rapide
+
+```bash
+# 1. Cloner le projet
+git clone https://github.com/SocialGouv/domifa.git
+cd domifa
+
+# 2. Lancer l'environnement de développement
+docker-compose up -d
+
+# 3. Installer les dépendances
+yarn install
+
+# 4. Démarrer le projet en mode développement
+yarn dev
+```
+
+L'application sera accessible sur :
+
+- Frontend structures : http://localhost:4200
+- Portail domiciliés : http://localhost:4201
+- Interface admin : http://localhost:4202
+- Backend API : http://localhost:3000
+
+## 📁 Architecture du projet
+
+DomiFa utilise une architecture **monorepo** avec plusieurs packages :
+
+```
+domifa/
+├── packages/
+│   ├── backend/              # API NestJS + PostgreSQL
+│   ├── frontend/             # Interface structures (Angular)
+│   ├── portail-frontend/     # Portail domiciliés (Angular)
+│   ├── portail-admins/       # Interface admin (Angular)
+│   └── common/               # Types et interfaces partagés
+├── _docs/                   # Documentation technique et guides
+├── docker/                  # Configurations Docker
+└── scripts/                 # Scripts de gestion de la DB
+```
+
+## 🛠️ Développement
+
+### Commands principales
+
+```bash
+# Développement complet
+yarn dev
+
+# Services individuels
+yarn dev:backend          # Backend seul
+yarn dev:frontend         # Interface structures
+yarn dev:portail-frontend # Portail domiciliés
+yarn dev:portail-admins   # Interface admin
+
+# Tests et qualité
+yarn test
+yarn lint
+yarn build
+```
+
+### Base de données
+
+Le projet utilise PostgreSQL avec TypeORM pour les migrations :
+
+## 🔧 Stack technique
+
+### Technologies principales
+
+- **Langage** : TypeScript
+- **Frontend** : Angular 17
+- **Backend** : NestJS v11 + PostgreSQL
+- **Déploiement** : Docker Compose
+
+### Tests disponibles
+
+- **Frontend** : Tests unitaires
+- **Portail usagers** : Tests unitaires
+- **Backend** : Tests unitaires + tests d'intégration
+
+## 🔗 Liens utiles
+
+### Documentation
+
+- **Documentation technique** : [\_docs/](https://github.com/SocialGouv/domifa/tree/master/_docs)
+
+### Outils de monitoring
+
+- **Sentry Backend** : https://sentry.fabrique.social.gouv.fr/incubateur/domifa-backend
+- **Sentry Frontend** : https://sentry.fabrique.social.gouv.fr/incubateur/domifa-frontend
+- **Sentry Portail** : https://sentry.fabrique.social.gouv.fr/incubateur/domifa-portail-usagers
+- **Matomo** : https://matomo.fabrique.social.gouv.fr
+
+### Services
+
+- **Mails (prod+dev)** : https://app.tipimail.com/
+- **Mails (dev)** : https://mailtrap.io/
 
 ## Développement
 
@@ -15,6 +124,4 @@ Voir [./\_docs/dev](./_docs/dev).
 
 Voir [./\_docs/ops.md](./_docs/ops.md).
 
-## License
-
 [![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2FSocialGouv%2Fdomifa.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2FSocialGouv%2Fdomifa?ref=badge_large)

_docs/dev/0.run-local-env.md

@@ -0,0 +1,179 @@
+# Installation Backend + PostgreSQL
+
+## 🎯 Objectif
+
+Démarrer un environnement de développement avec PostgreSQL en Docker et le backend DomiFa.
+
+## 🐳 Modes de développement
+
+### Mode hybride (recommandé)
+
+PostgreSQL en Docker + Backend en local avec yarn workspaces - permet un meilleur contrôle du développement.
+
+### Mode Docker complet
+
+Tous les services dans Docker - utile pour la reproductibilité mais moins flexible pour le développement.
+
+## ⚙️ Configuration des variables d'environnement
+
+### Fichiers requis (obligatoires)
+
+```bash
+# 1. Configuration racine
+cp .env.dev.example.env .env
+
+# 2. Configuration backend
+cp packages/backend/.env.backend.dev.example.env packages/backend/.env
+
+# 3. Configuration tests (optionnel)
+cp packages/backend/.env.backend.test.local.example.env packages/backend/.env.backend.test.local.env
+```
+
+### Configuration de la connexion PostgreSQL
+
+**Mode Docker complet** (Backend aussi en Docker) :
+
+```env
+# Dans packages/backend/.env
+POSTGRES_HOST=postgres
+# OU utiliser le preset
+DOMIFA_ENV_PRESET=local-dev-docker.preset.env
+```
+
+**Mode hybride** (Backend en local, PostgreSQL en Docker) :
+
+```env
+# Dans packages/backend/.env
+POSTGRES_HOST=localhost
+# OU utiliser le preset
+DOMIFA_ENV_PRESET=local-dev.preset.env
+```
+
+## 🐳 Lancement de l'environnement Docker
+
+### Démarrage des services
+
+```bash
+# PostgreSQL uniquement (recommandé avec yarn workspaces)
+./docker-compose.local.run.sh
+
+# PostgreSQL + Backend en Docker (mode conteneurisé)
+./docker-compose.local.run.sh --with-dev-containers
+```
+
+### Gestion des containers
+
+```bash
+# Arrêter les services
+./docker-compose.local.run.sh --stop
+
+# Supprimer les containers
+./docker-compose.local.run.sh --stop --remove
+
+# Reset complet (⚠️ SUPPRIME TOUTES LES DONNÉES DOMIFA)
+./docker-compose.local.run.sh --stop --remove --drop-domifa-volumes
+```
+
+## 🗄️ Base de données PostgreSQL
+
+### Initialisation automatique
+
+Les bases de données sont créées automatiquement au premier démarrage avec des données de test.
+
+> 📖 Voir [./20.databases-dumps.md](./20.databases-dumps.md) pour plus de détails
+
+### Vérification
+
+```bash
+# Vérifier que PostgreSQL fonctionne
+docker ps | grep postgres
+docker logs domifa-postgres
+```
+
+## 🚀 Démarrage du Backend
+
+### Mode hybride avec yarn workspaces (recommandé)
+
+```bash
+# À la racine du projet - démarre le backend via workspace
+yarn workspace @domifa/backend start:dev
+
+# OU directement dans le dossier backend
+cd packages/backend
+yarn start:dev
+```
+
+### Mode Docker complet
+
+```bash
+# Entrer dans le container backend
+docker exec -it domifa-backend bash
+
+# Dans le container
+yarn start:dev
+```
+
+## 🔧 Commandes utiles
+
+```bash
+# Voir les logs PostgreSQL
+docker logs domifa-postgres -f
+
+# Voir les logs Backend (si en Docker)
+docker logs domifa-backend -f
+
+# Reset uniquement la base de données
+docker volume rm domifa_postgres_data
+
+# Migrations manuelles
+yarn workspace @domifa/backend db:dev:migrate-up
+yarn workspace @domifa/backend db:dev:create -- NomDeLaMigration
+```
+
+## 🚨 Dépannage
+
+### PostgreSQL ne démarre pas
+
+```bash
+# Vérifier les logs
+docker logs domifa-postgres
+
+# Vérifier l'espace disque
+df -h
+
+# Nettoyer les volumes orphelins
+docker volume prune
+```
+
+### Backend ne se connecte pas à PostgreSQL
+
+```bash
+# Vérifier la configuration
+cat packages/backend/.env | grep POSTGRES
+
+# Vérifier que PostgreSQL accepte les connexions
+telnet localhost 5432
+```
+
+### Port 3000 déjà utilisé
+
+```bash
+# Identifier le processus
+lsof -i :3000
+kill -9 <PID>
+```
+
+### Modules manquants
+
+```bash
+# Réinstaller les dépendances backend
+cd packages/backend
+yarn install
+```
+
+## 🎯 Résultat attendu
+
+À la fin de cette installation, vous devez avoir :
+
+- ✅ PostgreSQL accessible sur `localhost:5432`
+- ✅ Backend API accessible sur `http://localhost:3000`