forked from Ynov/ptitspas-ynov-back
- docker-compose.dev.yml : Stack complète (Postgres + Backend + PgAdmin) - .env.example : Variables pour développement local - README-DEV.md : Guide développeur complet - Dockerfile : Configuration Docker backend - Correction dependencies package.json (typeorm, class-validator) - Hot reload configuré pour développement
64 lines
1.5 KiB
Markdown
64 lines
1.5 KiB
Markdown
# 🚀 Guide de développement local
|
|
|
|
## Prérequis
|
|
- Docker et Docker Compose installés
|
|
- Git
|
|
|
|
## 🏃♂️ Démarrage rapide
|
|
|
|
### 1. Cloner le projet
|
|
```bash
|
|
git clone <url-du-depot-backend>
|
|
cd ptitspas-backend
|
|
```
|
|
|
|
### 2. Configuration de l'environnement
|
|
```bash
|
|
# Copier le fichier d'exemple
|
|
cp .env.example .env
|
|
|
|
# Optionnel : adapter les valeurs dans .env selon vos besoins
|
|
```
|
|
|
|
### 3. Lancer l'application
|
|
```bash
|
|
# Démarrer tous les services (PostgreSQL + PgAdmin + Backend)
|
|
docker compose -f docker-compose.dev.yml up -d
|
|
|
|
# Voir les logs
|
|
docker compose -f docker-compose.dev.yml logs -f
|
|
```
|
|
|
|
## 🌐 Accès aux services
|
|
|
|
- **Backend API** : http://localhost:3000
|
|
- **PgAdmin** : http://localhost:8080
|
|
- Email : admin@localhost
|
|
- Mot de passe : admin123
|
|
- **PostgreSQL** : localhost:5432
|
|
- Utilisateur : admin
|
|
- Mot de passe : admin123
|
|
- Base : ptitpas_db
|
|
|
|
## 🛠️ Commandes utiles
|
|
|
|
```bash
|
|
# Arrêter les services
|
|
docker compose -f docker-compose.dev.yml down
|
|
|
|
# Rebuild le backend après modification du Dockerfile
|
|
docker compose -f docker-compose.dev.yml up --build backend
|
|
|
|
# Voir l'état des services
|
|
docker compose -f docker-compose.dev.yml ps
|
|
|
|
# Accéder au container backend
|
|
docker exec -it ptitspas-backend-dev sh
|
|
```
|
|
|
|
## 📝 Notes de développement
|
|
|
|
- Les modifications du code source sont automatiquement prises en compte (hot reload)
|
|
- Les données PostgreSQL sont persistantes via le volume `postgres_dev_data`
|
|
- Le fichier `.env` n'est pas versionné pour des raisons de sécurité
|