Démarrage rapide¶

Installer et lancer Primatch en 5 minutes.

Prérequis¶

Docker Desktop ou Docker Engine + Compose v2
Git
Pour les tests E2E : Node.js 20+ sur l'hôte (Playwright)

Installation¶

# 1. Cloner le projet
git clone <repo-url>
cd primatch

# 2. Builder les images Docker
make build

# 3. Installer les dépendances (composer + npm)
make install

# 4. Lancer les services
make dev

# 5. Initialiser la base de données
make migrate
make seed

Vérification¶

Après installation, les URLs suivantes doivent être accessibles :

URL	Attendu
http://localhost:3010	Frontend React (page d'accueil)
http://localhost:8010/api/v1/health	`{"status": "ok"}`
http://localhost:8010/api/documentation	Swagger UI
http://localhost:8020	Cette documentation

Compte de test (seedé)¶

Email : admin@primatch.com
Rôle : admin

Authentification par OTP

L'application utilise l'authentification par code OTP (envoyé par email). En développement, le code OTP est log dans Laravel (storage/logs/laravel.log) ou visible dans Telescope.

Commandes du quotidien¶

make dev          # Démarrer
make stop         # Arrêter
make test         # Tests backend
make test-frontend # Tests frontend
make quality      # Pipeline qualité complet
make swagger-generate  # Régénérer la doc API
make docs         # Voir l'URL de la doc

Prochaine étape

Une fois l'environnement lancé, consultez la section Fonctionnel pour comprendre les domaines métier, puis Contribuer pour les conventions de développement.