#Documentation Gazette

Ce projet est un monorepo TypeScript comprenant :

• Backend : API NestJS (CommonJS) avec MikroORM et PostgreSQL
• Frontend : Application React (Next)
• Shared : Code partagé entre le front et le back

Prérequis

• Node.js 20+
• pnpm (gestionnaire de paquets recommandé)
• Docker et Docker Compose

Clonage du projet

git clone  https://github.com/adatechschool/gazette
cd gazette

Installation des dépendances

pnpm i

Installer les DTOs partagés

cd packages/shared
pnpm build

Lancer le projet en local (hors Docker)

Backend

cd apps/backend
pnpm build
pnpm start

Frontend

cd apps/web
pnpm start

Commandes de migration (depuis apps/backend)

# Créer une migration
pnpm db:migration:create

# Appliquer les migrations
pnpm db:migration:up

# Revenir en arrière
pnpm db:migration:down

---

Utilisation avec Docker

1. Lancer tous les services (backend, frontend, base de données)

À la racine du projet :

Windows : docker-compose up --build
Mac : docker compose up --build

• Le backend sera accessible sur http://localhost:3000
• Le frontend sur http://localhost:5173
• La base de données Postgres sur le port 5432

2. Arrêter les services

docker-compose down

3. Voir les logs d'un service

docker-compose logs backend

4. Appliquer les migrations dans le conteneur backend

Ouvre un shell dans le conteneur backend :

docker-compose exec backend sh
# Puis dans le shell :
pnpm db:migration:up

---

Variables d'environnement

Crée un fichier .env dans apps/backend/ avec :

DB_NAME=gazette_db
DB_HOST=db
DB_PORT=5432
DB_USER=postgres
DB_PASSWORD=motdepasse

Crée un fichier .env dans apps/frontend/ avec :

NEXT_PUBLIC_API_URL=http://localhost:${BACKEND_PORT}
NODE_ENV=development

Crée un fichier .env dans apps avec :

# Database
DB_USER=postgres
DB_PASSWORD=postgres
DB_NAME=gazette_db

# Environment
NODE_ENV=development

# Ports
FRONTEND_PORT=5173
BACKEND_PORT=3000

---

Structure du projet

apps/
  backend/    # API NestJS
  frontend/   # Frontend React (NextJS)
packages/
  shared/     # Code partagé

---

Notes

• Pour le développement avec hot reload dans Docker, une configuration supplémentaire est nécessaire.
• Les migrations MikroORM doivent être lancées dans le conteneur backend si tu utilises Docker.

---

Pour toute question, ouvre une issue ou contacte l'équipe !