Architecture Mairie

Statut

Document de cadrage Mairie — version initiale.

Vue d'ensemble

L'architecture Mairie visible repose sur un module Laravel dans l'API centrale DMV.

La cible est une interface mairie simple, appuyée sur le backend commun pour les droits, contenus, communes, alertes, services, publications et future IA Gateway.

État actuel visible

Élément	État
Module backend	api/app/Modules/Mairie.
Routes	Alertes, services, publications mairie.
Lecture publique	Alertes et services par commune.
Écriture protégée	identify.app, auth:sanctum, mairie.access.
Middleware	Vérifie acteur kind='mairie' et rattachement utilisateur.
Alertes	Modèle, DTO, validations et expiration horaire.
Services	Modèle, DTO, création, mise à jour, réordonnancement.
Publications	Scope mairie forcé.

Schéma logique

DMV public / future interface Mairie
  ├─ lecture alertes et services
  ├─ gestion mairie protégée
  └─ publications mairie

API Laravel
  ├─ Mairie routes
  ├─ MairieReadService
  ├─ MairieWriteService
  ├─ Publication services
  ├─ EnsureMairieAccess
  └─ ExpireAlertes job

Données principales

Table	Rôle
mairie_alertes	Alertes citoyennes liées à commune et acteur mairie.
mairie_services	Services municipaux actifs et ordonnés.
publications	Publications avec scope mairie.
acteurs	Acteur de type mairie.
communes	Périmètre territorial.
commune_infos / commune_collectes	Informations communales visibles historiquement ou en parallèle.

Sécurité

• Écriture réservée à un utilisateur authentifié.
• Vérification de l'acteur mairie.
• Vérification du rattachement utilisateur-acteur.
• Admin DMV autorisé.
• Publications mairie forcées au scope mairie.
• Modération locale limitée par commune pour non-admin.

Vision cible frontend

Le repo ne confirme pas d'application frontend mairie dédiée.

La cible peut être :

• espace dédié dans le backoffice ;
• application Mairie séparée ;
• interface intégrée à DMV public pour certains rôles ;
• PWA mairie légère.

Le choix doit privilégier simplicité, maintenance et sécurité.

Points à clarifier

• Interface mairie cible.
• Contrats API complets.
• Source canonique entre services mairie, commune infos et collectes.
• Audit logs mairie.
• Notifications.
• Intégration PlayLoop et IA Gateway.