Tests backend
Statut
Document de cadrage backend — version initiale.
État actuel visible
Le dossier api/tests contient des tests feature par module :
- Actor ;
- Admin ;
- Analytics ;
- AssoSuite ;
- Auth ;
- Chat ;
- Community ;
- Mairie ;
- Middleware ;
- Monetization ;
- PlayLoop ;
- Publication ;
- Settings ;
- Territory.
Le script Composer test exécute php artisan test après config:clear.
Objectifs des tests
Les tests doivent protéger :
- contrats API ;
- règles d'autorisation ;
- validation ;
- services métier ;
- jobs ;
- modération ;
- monétisation ;
- scopes par application ;
- régressions sur modules partagés.
Types de tests
| Type | Usage |
|---|---|
| Feature API | Vérifier endpoints, statuts HTTP, payloads, droits. |
| Unit | Tester logique pure ou petits objets. |
| Services | Vérifier règles métier sans HTTP quand pertinent. |
| Jobs | Vérifier exécution, retry et effets attendus. |
| Middleware | Vérifier headers, auth, source app. |
| Policies | Vérifier autorisations fines. |
Conventions cible
- Un module important doit avoir ses tests Feature.
- Une règle métier critique doit avoir un test dédié.
- Les tests doivent couvrir succès et refus.
- Les statuts 401, 403, 422 et 404 doivent être vérifiés.
- Les payloads sensibles doivent être testés pour non-exposition.
Commande
cd api
composer test
ou :
php artisan test
Points à clarifier
- Couverture minimale attendue.
- Données de test par module.
- Tests d'intégration Supabase/Stripe.
- Tests de queues.
- Tests futurs de l'AI Gateway.