Tests¶
El proyecto usa PHPUnit. La suite vive en tests/Feature y tests/Unit.
Configuración¶
Los tests usan una base PostgreSQL separada (vortex-play-test). Configura .env.testing y
ejecuta:
composer test
phpunit.xml fija APP_ENV=testing, SESSION_DRIVER=array, CACHE_STORE=array y
QUEUE_CONNECTION=sync, para no depender de Redis, SQS ni sesiones reales.
Convenciones¶
- Features con
DatabaseTransactions: cada test hace rollback. - Usa factories cuando existan; no crees modelos a mano si hay factory.
- No uses
RefreshDatabasesobre el esquema de dominio. - Para alertas, usa
Http::fake()y las utilidades detests/Concerns.
Grupos relevantes¶
| Área | Tests |
|---|---|
| Alertas | tests/Feature/Alerts/*, tests/Unit/Alerts/* |
| Cabeceras | tests/Feature/SecurityHeadersTest.php |
| Usuarios | tests/Feature/Users/* |
| Banners | tests/Feature/Banners/* |
| Menús y categorías | tests/Feature/Menus/*, tests/Feature/LobbyCategories/* |
| Usuarios temporales | tests/Feature/TemporaryUsers/* |
Comandos¶
php artisan test --compact
vendor/bin/phpunit tests/Feature/Alerts
vendor/bin/phpunit --filter=LoginLockoutTest
Cobertura de documentación¶
php scripts/docs-inventory.php --check
php scripts/docs-coverage.php
El primero verifica que el inventario de clases esté actualizado; el segundo falla si una clase documentable no aparece en la documentación.