Backend¶
⬇️ Télécharger cette page en Markdown
Introduction¶
Documentation du backend PHP : API REST, services métier, files de jobs.
Contenu¶
API REST¶
Endpoints publics pour application mobile : get_types, get_incidents, submit_incident, authentification, format JSON.
Services métier¶
Services réutilisables : IncidentService, TypeService, UploadService, MairieService, FaceBlurringService.
Files de jobs¶
Jobs asynchrones : BlurFacesJob, CalculatePhashJob, SendEmailNotificationJob, configuration workers Supervisord.
Gestion des emails invalides¶
Système de détection et gestion des emails rejetés (bounces) par les serveurs SMTP, avec dashboard super-administrateur.
Logs de Debug¶
Journalisation complète des requêtes HTTP et SQL, activable à la volée via l'interface superadmin pour les investigations de bugs.
Gestion des Agents Backoffice¶
API d'administration pour la création et la gestion des comptes agents de l'application mobile. Voir Documentation Agents.
Endpoints :
GET /api/admin/agents/list.php- Liste des agentsPOST /api/admin/agents/create.php- Créer un agent (génère aussi un QR code d'appairage)PUT /api/admin/agents/update.php- Modifier un agentPOST /api/admin/agents/disable.php- Activer/Désactiver un agentPOST /api/admin/agents/pairing_generate.php- Générer/régénérer un QR code d'appairagePOST /api/admin/agents/pairing_revoke.php- Révoquer l'appareil apparié d'un agent
Architecture Backend¶
Stack Technique¶
| Composant | Technologie |
|---|---|
| Language | PHP 8.2 |
| Database | PDO + MariaDB |
| Cache | Redis (optionnel) |
| Queue | Redis List (optionnel) |
| Storage | Filesystem / S3 |
| Images | GD / Imagick |
Navigation Rapide¶
| Document | Description |
|---|---|
| API REST | Endpoints publics |
| Services | Logique métier |
| Jobs | Traitements asynchrones |
| Emails invalides | Détection bounces SMTP + dashboard superadmin |
| Logs de Debug | Logging HTTP/SQL activable via superadmin |
| Gestion Agents | API d'administration des comptes agents |