76 lines
3.3 KiB
Markdown
76 lines
3.3 KiB
Markdown
# ProserveReport - Mémoire Projet (locale au repo)
|
|
|
|
Ce fichier sert de référence pour Claude Code entre sessions et postes de travail.
|
|
|
|
## Contexte
|
|
- **Projet** : Simulateur VR d'entraînement pour forces de police (Proserve)
|
|
- **API** : PHP, consommée par Unreal Engine en lecture/écriture
|
|
- **Objectif** : Créer une interface web locale pour visualiser sessions et statistiques
|
|
- **Serveur** : WAMP (Apache + MariaDB), installé localement
|
|
|
|
## Base de données
|
|
- **Nom** : `ProserveAPI`
|
|
- **SGBD** : MariaDB 10.4.27
|
|
- **Connexion** : `localhost`, user `root`, pas de mot de passe
|
|
- **Schema SQL** : `proserveapi.sql` à la racine
|
|
|
|
## Structure API
|
|
```
|
|
ProserveAPI/htdocs/proserve/
|
|
├── config/ → database.php, constants.php, init.php, error.php
|
|
├── objects/ → 18 modèles PHP (User, GameSession, TriggerEvent, ReactEvent, etc.)
|
|
├── events/ → storetriggerevent.php, storereactevent.php
|
|
├── session/ → start, stop, registeruser, userleave, getobjectives, updateobjectives, debrief, get
|
|
├── user/ → signup, login, get, update, resetpassword
|
|
├── stats/ → get, userhistory
|
|
├── lists/ → sessions_for_user, users_in_session
|
|
├── score/ → score_algo1.php, score.php
|
|
└── debug/ → test.php
|
|
```
|
|
|
|
## Tables principales
|
|
| Table | Clé | Description |
|
|
|-------|-----|-------------|
|
|
| users | id | Comptes (username, password base64, stats moyennes avgPrecision/avgReaction/avgFault/avgRapidity) |
|
|
| sessions | id | Sessions (sessionType, mapName, scenarioName, score, timeToFinish, success) |
|
|
| participates | userId+sessionId | Relation user-session (score, firePrecision, reactionTime, rôle, endStatus, results JSON) |
|
|
| triggerevents | sessionId+indexCount | Tirs (srcUserId, type, timestamp, successful) |
|
|
| reactevents | id | Impacts (reactType, hitBoneName, damage, hitPrecision, distance, reactTime, reactMode) |
|
|
|
|
## Types de session
|
|
0:FireRange, 1:Challenge, 2:Protect, 3:De-Escalation, 4:Terrorism, 5:FireExtinction, 6:Recovering
|
|
|
|
## Types de réaction (impacts)
|
|
0:EnemyHit, 1:CivilianHit, 2:PoliceHit, 3:ObjectHit, 4:PaperTargetHit, 5:TargetHit, 6:DeadBodyHit
|
|
|
|
## Rôles utilisateur
|
|
0:Police, 1:Enemy, 2:Civil, 3:IA
|
|
|
|
## Scoring
|
|
- FireRange : precision * 10
|
|
- Autres modes : (precisionOnEnemies * 100) - (nbCivils * 200)
|
|
- Succès si score >= 70
|
|
- Sessions "Calibration" exclues des stats
|
|
|
|
## Objectifs JSON (par user par session)
|
|
9 catégories : civilian, time, enemy, health, precision, reactTime, ammoLimit, target, overall
|
|
|
|
## Endpoints API (tous POST, JSON)
|
|
- User : signup, login, get, update, resetpassword
|
|
- Session : start, stop, registeruser, userleave, getobjectives, updateobjectives, debrief, get
|
|
- Events : storetriggerevent, storereactevent
|
|
- Stats : get, userhistory
|
|
- Listes : sessions_for_user, users_in_session
|
|
|
|
## Environnement serveur
|
|
- **XAMPP** (C:\xampp) - pas WAMP
|
|
- **PAS D'INTERNET** sur le PC cible : tout CSS/JS/fonts inclus localement (pas de CDN)
|
|
|
|
## Interface Web (en cours)
|
|
- Objectif : reproduire la consultation depuis Unreal en version web
|
|
- Hébergée sur XAMPP local
|
|
- Git : `C:\ASTERION\GIT\ProserveReport\PS_Report`
|
|
- Test : `C:\xampp\htdocs\ProserveReport`
|
|
- Accès data : via l'API PHP existante
|
|
- Pages prévues : dashboard, liste sessions, détail session/debrief, profil utilisateur, stats
|