UTCats — Gestion des CATs

Application web de gestion des CATs (Centres d'Aide aux Tutorés) développée pour le SiMDE (Service Informatique de la Maison des Étudiants) à l'UTC.

L'application fournit un panel d'administration Filament permettant aux responsables de gérer les CATs et leurs membres, avec authentification via le SSO étudiant UTC.

Stack

• Framework : Laravel 11 + Filament 3
• Langage : PHP 8.3
• Base de données : SQLite (dev) / MySQL (production)
• Auth : OAuth 2.0 via auth.assos.utc.fr
• Frontend : Vite + TailwindCSS

Lancer le projet

Avec Docker

make docker-build
make docker-run

L'app est disponible sur http://localhost:8000

Sans Docker

composer install
npm install && npm run build
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
php artisan serve

Avec Make

make install    # installe les dépendances Composer + npm
make dev        # démarrage en mode développement (avec Vite)
make test       # lance les tests PHPUnit

Configuration

Copier .env.example en .env et renseigner :

Variable	Description
APP_KEY	Généré via php artisan key:generate
OAUTH_URL	URL du serveur OAuth (ex: https://auth.assos.utc.fr)
OAUTH_CLIENT_ID	Client ID OAuth
OAUTH_CLIENT_SECRET	Client Secret OAuth
DB_CONNECTION	sqlite ou mysql
APP_NO_LOGIN	true pour bypasser l'auth en développement

Structure

├── app/
│   ├── Filament/           # Resources, Pages et Widgets Filament
│   ├── Http/Controllers/   # AuthController (OAuth callback)
│   └── Models/             # Modèles Eloquent
├── database/
│   ├── migrations/         # Migrations Laravel
│   └── seeders/            # Données de test
├── resources/views/        # Vues Blade
├── routes/web.php          # Routes de l'application
└── k8s/                    # Chart Helm pour déploiement Kubernetes