Lancer en local

Prérequis

Assurez-vous d’avoir complété :

Démarrage rapide

Avec Laravel Herd (Recommandé)

Si vous utilisez Laravel Herd, le backend est automatiquement accessible sur https://xetasuite-core.test.

Démarrer les services backend
Terminal window
```
cd XetaSuite-core
composer run dev
```
Cette commande lance :
- Le serveur Laravel
- Le worker de queue
Démarrer le frontend
Terminal window
```
cd XetaSuite-React
npm run dev
```
Accéder à l’application

Ouvrez http://localhost:5173 dans votre navigateur.

Sans Herd

cd XetaSuite-core
php artisan serve

cd XetaSuite-core
php artisan queue:work

cd XetaSuite-React
npm run dev

Compte de démonstration

Après avoir exécuté les seeders, vous pouvez vous connecter avec :

Email	Mot de passe	Rôle
`admin@xetasuite.test`	`password`	Admin HQ
`manager@xetasuite.test`	`password`	Manager Site 1
`user@xetasuite.test`	`password`	Utilisateur Site 1

Commandes utiles

Backend

# Lancer les tests
php artisan test

# Lancer un test spécifique
php artisan test --filter=CompanyController

# Rafraîchir la base de données
php artisan migrate:fresh --seed

# Formater le code
vendor/bin/pint --dirty

Frontend

# Serveur de développement
npm run dev

# Build de production
npm run build

# Lancer le linter
npm run lint

Résolution de problèmes

Erreurs CORS

Vérifiez que SPA_URL dans .env correspond à l’URL de votre frontend :

SPA_URL=http://localhost:5173

419 CSRF token mismatch

Assurez-vous d’appeler /sanctum/csrf-cookie avant la connexion :

await axios.get('/sanctum/csrf-cookie');
await axios.post('/api/v1/auth/login', credentials);

Session non persistante

Vérifiez ces paramètres :

SANCTUM_STATEFUL_DOMAINS=localhost:5173,xetasuite.test
SESSION_DOMAIN=localhost