Démarrage rapide

Ce guide vous aidera à configurer et lancer le projet sur votre machine locale.

💡 Solution de secours : Si vous n’avez pas accès à un poste local fonctionnel (poste universitaire en panne, etc.), vous pouvez utiliser CodeSandbox pour travailler directement dans votre navigateur.

Prérequis

Avant de commencer, assurez-vous d’avoir installé :

Node.js version 20 ou supérieure
pnpm version 10.4.1 ou supérieure

Vérification des versions


node --version  # Doit afficher v20.x.x ou plus
pnpm --version  # Doit afficher 10.4.x ou plus

Installation de pnpm

Si vous n’avez pas pnpm installé :


npm install -g pnpm@10.4.1

Installation

1. Cloner le repository


git clone https://github.com/micmc422/TP-Nextjs-tw3.git
cd TP-Nextjs-tw3

2. Installer les dépendances


pnpm install

Cette commande installe toutes les dépendances pour tous les packages et applications du monorepo.

3. Configurer les variables d’environnement

Copiez le fichier .env.example pour créer votre configuration locale :


cp .env.example .env.local

Éditez .env.local et configurez les variables nécessaires :


# MongoDB Configuration
MONGODB_URI=mongodb://localhost:27017
MONGODB_DB_NAME=tp-nextjs

# JWT Secret (IMPORTANT: Change this in production!)
JWT_SECRET=your-super-secret-jwt-key-change-in-production

# Development URLs
NEXT_PUBLIC_API_URL=http://localhost:3000
NEXT_PUBLIC_DOC_URL=http://localhost:3001

4. Démarrer MongoDB avec Docker

Le projet utilise MongoDB pour la persistance des données. Lancez MongoDB avec Docker Compose :


docker-compose up -d

Vérifiez que MongoDB est bien démarré :


docker-compose ps

Vous devriez voir le service mongodb en état Up.

Lancement du développement

Lancer tous les projets


pnpm dev

Cette commande lance simultanément :

L’application web sur http://localhost:3000
La documentation sur http://localhost:3001

Lancer un projet spécifique


# Lancer uniquement l'application web
pnpm --filter web dev
 
# Lancer uniquement la documentation
pnpm --filter doc dev

Build de production

Builder tous les projets


pnpm build

Builder un projet spécifique


pnpm --filter web build

Structure des commandes

Commande	Description
`pnpm dev`	Lancer le développement
`pnpm build`	Builder tous les projets
`pnpm lint`	Linter tous les projets
`pnpm format`	Formater le code avec Prettier

Prochaines étapes

Explorez l’architecture du projet
Découvrez le système d’authentification
Apprenez à utiliser le package database
Apprenez comment fonctionne Turborepo
Découvrez le Next.js App Router