# Audit Backend SaaS Premium v3

## Vision conservée
- SaaS location de voitures multi-agences.
- Super admin global, agency_manager/admin par agence, agent limité à son agence.
- Dashboard configurable comme la maquette.
- Backend prêt pour dashboard, frontend client, Android client et Android employé.

## Corrections incluses
1. Anti-doublon webhook payment gateways
   - Ajout findByGatewayTransaction() dans PaymentsService.
   - Le webhook ne crée plus plusieurs paiements pour la même gatewayTransactionId.
   - Si paymentId existe déjà, le webhook retourne already_processed.

2. Agences configurables dashboard
   - Ajout endpoint PATCH /agencies/:id/dashboard-settings.
   - Logo base64 ou logoUrl.
   - Couleurs, langue, devise.
   - Settings paiement par agence.
   - Settings email / WhatsApp par agence.
   - Settings documents / impression par agence.
   - Lieux départ / retour / parcs.

3. Logo agence
   - Sauvegarde logo base64 dans /storage/agencies/{id}/logo.ext.
   - logoUrl exploitable par PDF et verify HTML.

4. Verify HTML premium
   - Affichage logo agence.
   - Statuts traduits FR.
   - Design verify amélioré.

5. Email réel prêt
   - Resend via fetch.
   - SendGrid via fetch.
   - SMTP laissé en fallback log/simulated sans dépendance externe.
   - Configurable par agence via notificationSettings.email.

6. WhatsApp réel prêt
   - Meta WhatsApp Cloud API via fetch.
   - Twilio WhatsApp via fetch.
   - Configurable par agence via notificationSettings.whatsapp.

7. Comptabilité premium initiale
   - Nouveau module src/modules/accounting.
   - Dashboard comptable.
   - Entries.
   - Journaux vente/caisse/banque/TVA.
   - Tax report.
   - Cash / bank.
   - Customer balance.
   - Export CSV.
   - Respect agence/super_admin.

8. IA backend préparée
   - Nouveau module src/modules/ai.
   - Endpoints:
     POST /ai/damage-detection
     POST /ai/pricing-suggestion
     POST /ai/dashboard-summary
     POST /ai/chat
     POST /ai/maintenance-prediction
   - Mode simulated si AI_ENABLED=false.

9. Recherche globale dashboard
   - GET /dashboard/global-search?q=
   - Recherche véhicules, réservations, paiements.
   - Respect agence/super_admin.

## Ce qui reste pour dashboard/frontend
- Interface React selon maquette.
- Éditeur visuel templates documents.
- Signature tactile frontend.
- OCR réel documents.
- OpenAI Vision réel pour dégâts/fraude.
- App Android client et agent.