docs: améliorer rendu markdown et navigation mkdocs

- Ajouter ADR-018 (librairies Go) dans TECHNICAL.md
- Transformer Shared en menu dépliable dans mkdocs (cohérence avec autres domaines)
- Corriger listes markdown (ajout lignes vides avant listes)
- Corriger line breaks dans génération BDD (étapes "Et" sur nouvelles lignes)
- Ajouter script fix-markdown-lists.sh pour corrections futures

Impacte 86 fichiers de documentation et 164 fichiers BDD générés.

docs/domains/moderation/README.md

@@ -35,6 +35,7 @@ Le domaine **Moderation** gère la modération des contenus et des utilisateurs,
 ## Ubiquitous Language
 
 **Termes métier du domaine** :
+
 - **Report** : Signalement d'un contenu ou utilisateur problématique
 - **Strike** : Avertissement comptabilisé (3 strikes = ban)
 - **Sanction** : Mesure disciplinaire (warning, suspension, ban)

docs/domains/moderation/flows/moderation-signalement.md

@@ -67,6 +67,7 @@ flowchart TD
 ## Légende
 
 **Priorités de traitement** :
+
 - 🔴 **CRITIQUE** (score ≥90) : <2h - Violence, suicide, danger immédiat
 - 🟠 **HAUTE** (70-89) : <24h - Haine, harcèlement
 - 🟡 **MOYENNE** (40-69) : <24h - Spam, contenu inapproprié

docs/domains/moderation/rules/autres-comportements.md

@@ -9,6 +9,7 @@
 **Disponibilité** : Partout dans l'application
 
 **Emplacements** :
+
 - Player en lecture (bouton dans contrôles)
 - Page profil créateur (sur chaque contenu)
 - Liste de recherche (menu contextuel)
@@ -17,6 +18,7 @@
 **Icône** : ⬆️ (universelle iOS/Android)
 
 **Menu options** :
+
 - Copier le lien
 - WhatsApp
 - Email
@@ -24,6 +26,7 @@
 - Plus... (sheet natif OS)
 
 **Justification** :
+
 - Viralité = croissance organique gratuite
 - Aucune friction, partage universel
 
@@ -93,11 +96,13 @@ Page web responsive
 ```
 
 **Deep linking** :
+
 - iOS : Universal Links (configuration `apple-app-site-association`)
 - Android : App Links (configuration `assetlinks.json`)
 - URL scheme : `roadwave://content/[content_id]`
 
 **Justification** :
+
 - Meilleure viralité (partage social optimisé)
 - SEO (contenus indexés Google)
 - UX optimale (web + app)
@@ -137,10 +142,12 @@ Page web responsive
    - Rejouer les 30 premières secondes (illimité)
 
 **Tracking** :
+
 - Métriques créateur : "Partages Premium" + "Conversions Premium"
 - Créateur touche sa part si conversion (70%)
 
 **Justification** :
+
 - Équilibre viralité / monétisation
 - 30s = assez pour donner envie, pas assez pour satisfaire
 - Protège revenus créateurs
@@ -219,10 +226,12 @@ Page web responsive
 | **Par tag** | Filtre multi-sélection tags |
 
 **Recherche locale** :
+
 - Barre recherche dans profil : "Rechercher dans les contenus de @pseudo"
 - Recherche full-text sur titres + descriptions
 
 **Actions menu [•••]** :
+
 - Partager profil
 - Signaler profil (spam, usurpation)
 - Bloquer créateur (masque tous ses contenus)
@@ -254,6 +263,7 @@ Page web responsive
 | **Démographie** | Âge / zone géo (agrégée, anonymisée) |
 
 **Justification** :
+
 - Arrondi = évite comparaisons anxiogènes
 - Preuve sociale pour nouveaux auditeurs (trust)
 - Gamification douce (motivation créateurs)
@@ -272,6 +282,7 @@ Page web responsive
 3. **Communauté significative** : ≥10K abonnés + compte actif >6 mois
 
 **Affichage** :
+
 - Badge bleu **✓** accolé au pseudo (partout : profil, player, recherche)
 - Tooltip au survol/appui long : "Compte vérifié"
 
@@ -284,11 +295,13 @@ Page web responsive
 | **Automatique (10K)** | Badge attribué automatiquement à 10K abonnés si compte >6 mois |
 
 **Retrait du badge** :
+
 - Suspension monétisation → badge retiré temporairement
 - Strikes multiples → badge retiré définitivement
 - Usurpation identité détectée → ban + retrait
 
 **Justification** :
+
 - Combat usurpations d'identité
 - Trust auditeurs (surtout pour médias/personnalités)
 - Simplicité (1 seul badge, pas de gamification excessive)
@@ -332,6 +345,7 @@ LIMIT 20;
 ```
 
 **Champs indexés** :
+
 - Titre du contenu (poids × 3)
 - Description (poids × 1)
 - Pseudo créateur (poids × 2)
@@ -350,10 +364,12 @@ LIMIT 20;
 **Coût** : 0€ (PostgreSQL natif)
 
 **Migration future** :
+
 - Si >100K contenus : Meilisearch (typo-tolerance avancée, ~20-50€/mois)
 - Si >1M contenus : Elasticsearch cluster
 
 **Justification** :
+
 - PostgreSQL full-text = performant jusqu'à 500K contenus
 - Stemming français natif
 - 0€, aucune dépendance externe
@@ -411,15 +427,18 @@ ORDER BY distance ASC;
 ```
 
 **Affichage résultats** :
+
 - Tri par défaut : distance croissante
 - Indication distance : "À 2.3 km" / "À 15 km" / "À 142 km"
 - Option carte : markers cliquables (clustering si >50 résultats)
 
 **Coût** :
+
 - MVP : 0€ (Nominatim public)
 - Scale : 20-50€/mois (Nominatim self-hosted Docker)
 
 **Justification** :
+
 - Essentiel pour tourisme / planification trajet
 - OpenStreetMap = pas de dépendance Google
 - PostGIS = performant (index GIST natif)
@@ -520,6 +539,7 @@ CREATE INDEX idx_content_tags ON contents USING GIN(tags);
 **Coût** : 0€ (PostgreSQL + index standards)
 
 **Justification** :
+
 - Filtres essentiels pour découvrabilité
 - Combinables = puissance maximale
 - Sauvegarde = gain temps utilisateurs réguliers
@@ -575,17 +595,20 @@ CREATE INDEX idx_content_tags ON contents USING GIN(tags);
 | **Distance** | Si recherche géo : "À 2.3 km" |
 
 **Actions contextuelles [⋮]** :
+
 - Partager
 - Ajouter à une playlist (future feature)
 - Télécharger (offline)
 - Signaler
 
 **Pagination** :
+
 - **20 résultats** par page
 - Infinite scroll (charger automatiquement si scroll >80%)
 - Bouton "Charger 20 suivants" en bas (fallback si scroll auto désactivé)
 
 **Vue carte (alternative)** :
+
 - Bouton toggle "Liste / Carte"
 - Map Leaflet (OpenStreetMap)
 - Markers cliquables → popup avec preview
@@ -594,6 +617,7 @@ CREATE INDEX idx_content_tags ON contents USING GIN(tags);
 **Coût** : 0€ (Leaflet open source + OSM tiles gratuit)
 
 **Justification** :
+
 - Équilibre information / compacité
 - Lazy loading = performances
 - Infinite scroll = UX moderne

docs/domains/moderation/rules/moderation-communautaire.md

@@ -3,6 +3,7 @@
 **Contexte** : Système de gamification pour encourager les utilisateurs à signaler du contenu inapproprié de manière pertinente et qualitative.
 
 **Objectifs** :
+
 - Améliorer la qualité des signalements (réduire les signalements abusifs)
 - Réduire la charge de travail des modérateurs (priorisation automatique)
 - Récompenser les contributeurs actifs et fiables
@@ -22,6 +23,7 @@
 | 🥇 | **Contributeur Or** | 50 signalements validés + 90% taux pertinence | Signalements prioritaires (+30 points) + Badge visible + Réduction Premium |
 
 **Règles d'éligibilité** :
+
 - Minimum **10 signalements envoyés** pour être éligible aux badges
 - Les signalements "En cours" ne comptent pas dans le calcul
 - Les signalements rejetés font baisser le taux de pertinence
@@ -32,10 +34,12 @@ Taux de pertinence = (Signalements validés / Total signalements envoyés) × 10
 ```
 
 **Période de calcul** :
+
 - Seuls les **6 derniers mois** comptent (période glissante)
 - Évite que les utilisateurs se reposent sur leurs lauriers
 
 **Justification** :
+
 - **Simple** : 3 niveaux seulement (pas d'over-engineering)
 - **Gratuit** : logique backend + affichage frontend
 - **Efficace** : incite la qualité plutôt que la quantité
@@ -52,6 +56,7 @@ Taux de pertinence = (Signalements validés / Total signalements envoyés) × 10
 | **Argent → Or** | 60 jours |
 
 **Justification** :
+
 - Évite la montée en badge trop rapide (anti-farming)
 - Force une contribution régulière sur la durée
 - Détecte les patterns suspects (audit modérateur si trop rapide)
@@ -63,6 +68,7 @@ Taux de pertinence = (Signalements validés / Total signalements envoyés) × 10
 **IMPORTANT** : L'utilisateur doit être informé du système de récompenses **dès son premier signalement**.
 
 **Moment d'affichage** :
+
 - Après avoir envoyé le **premier signalement**
 - Juste après le toast de confirmation standard
 - **2 secondes de délai** avant affichage de la modal
@@ -102,6 +108,7 @@ Taux de pertinence = (Signalements validés / Total signalements envoyés) × 10
 ```
 
 **Lien "En savoir plus"** :
+
 - Redirection vers page dédiée expliquant :
   - Calcul détaillé du taux de pertinence
   - Critères d'obtention pour chaque badge
@@ -116,6 +123,7 @@ Taux de pertinence = (Signalements validés / Total signalements envoyés) × 10
 #### 19.1.4 Affichage badges et statistiques
 
 **Badge visible** :
+
 - **Profil utilisateur** : visible par tous les autres utilisateurs
 - **Historique signalements** : visible uniquement par l'utilisateur lui-même
 - **Toast après obtention** :
@@ -136,10 +144,12 @@ Prochain palier : 🥇 Contributeur Or (30 signalements validés restants)
 ```
 
 **Toast après traitement signalement** :
+
 - Si validé : "✅ Bravo ! Votre signalement a aidé la communauté. Progression : 3/5 pour badge Bronze 🥉"
 - Si rejeté : "❌ Signalement non retenu. Taux de pertinence : 60%. Continuez vos efforts !"
 
 **Justification** :
+
 - **Transparence totale** : l'utilisateur voit sa progression en temps réel
 - **Motivation** : gamification saine (pas de pression, juste encouragement)
 - **Gratifiant** : messages positifs valorisant la contribution
@@ -157,6 +167,7 @@ Score fiabilité = min(100, (Validés × 10 - Rejetés × 5 + Bonus_Or × 20))
 ```
 
 **Détails** :
+
 - **Validés** : nombre de signalements validés par modérateurs
 - **Rejetés** : nombre de signalements rejetés
 - **Bonus_Or** : +20 points si badge Or actif
@@ -181,10 +192,12 @@ Priorité = (Score_IA × 0.7) + (Signalements_cumulés × 0.2) + (Fiabilité_sig
 ```
 
 **Intégration** :
+
 - **Fiabilité_signaleur** = Score fiabilité / 100 (normalisé 0-1)
 - Les signalements des utilisateurs avec badge Argent/Or passent automatiquement devant les autres (même score IA)
 
 **Affichage à l'utilisateur** :
+
 - **NON affiché** publiquement (risque de gamification abusive)
 - **Visible** uniquement dans les stats personnelles :
   ```
@@ -201,6 +214,7 @@ Priorité = (Score_IA × 0.7) + (Signalements_cumulés × 0.2) + (Fiabilité_sig
 **Décision** : Statut automatique pour utilisateurs Badge Argent ou Or
 
 **Critère** :
+
 - Badge **Argent OU Or** actif = automatiquement "Utilisateur de confiance"
 
 **Avantages** :
@@ -209,6 +223,7 @@ Priorité = (Score_IA × 0.7) + (Signalements_cumulés × 0.2) + (Fiabilité_sig
 3. **Notification différée** : résultats sous 12h (au lieu de 24-48h standards)
 
 **Révocation** :
+
 - Perte badge Argent/Or → perte statut confiance automatique
 - Retour au statut normal, aucune sanction supplémentaire
 
@@ -259,10 +274,12 @@ Merci de contribuer à rendre RoadWave meilleur chaque jour !
 ```
 
 **Rappels** :
+
 - Email + Push J-7 : "Il vous reste 7 jours pour profiter de votre réduction Premium -50%"
 - Email + Push J-1 : "Dernière chance ! Votre réduction Premium -50% expire demain"
 
 **Si non activée après 30 jours** :
+
 - Offre expirée (notification : "Votre offre Premium -50% a expiré")
 - Badge Or conservé (seule l'offre expire, pas le badge)
 
@@ -271,16 +288,19 @@ Merci de contribuer à rendre RoadWave meilleur chaque jour !
 #### 19.4.3 Perte du badge Or
 
 **Conditions** :
+
 - Taux de pertinence descend sous **90%** après audit trimestriel
 - Signalements abusifs détectés (voir Section 19.5)
 
 **Conséquences** :
+
 - **Badge Or révoqué** immédiatement
 - **Abonnement Premium en cours** reste actif jusqu'à sa fin normale
 - **Nouvelle souscription** à prix normal (4.99€/mois)
 - **Pas de nouvelle offre -50%** même si badge Or réobtenu ultérieurement
 
 **Justification** :
+
 - Maintien qualité badges sur le long terme
 - Évite abus système
 
@@ -291,11 +311,13 @@ Merci de contribuer à rendre RoadWave meilleur chaque jour !
 **Coût maximum** : **200€/mois** (si 50 utilisateurs Or simultanés avec réduction active)
 
 **ROI attendu** :
+
 - **1 utilisateur Or** = économie ~5-10h modération/mois = 75-150€ économisés (taux horaire modérateur ~15€/h)
 - **10 utilisateurs Or actifs** = 750-1500€ économisés > 200€ coût réductions
 - **ROI positif dès 2-3 utilisateurs Or actifs**
 
 **Justification** :
+
 - **Incitation forte** pour meilleurs contributeurs uniquement
 - **Conversion** : utilisateurs gratuits très engagés → Premium payant après 3 mois
 - **Risque limité** : coût max plafonné, largement compensé par économie modération
@@ -311,11 +333,13 @@ Merci de contribuer à rendre RoadWave meilleur chaque jour !
 **Décision** : Maximum 10 signalements / 24h par utilisateur
 
 **Règles** :
+
 - Au-delà de 10 signalements/24h → signalements automatiquement rejetés
 - Alerte modérateur automatique (enquête manuelle)
 - Message utilisateur : "Limite quotidienne atteinte (10 signalements/24h). Réessayez demain."
 
 **Justification** :
+
 - Évite signalement massif (farming)
 - 10/jour = largement suffisant pour usage légitime
 - Coût : 0€
@@ -336,10 +360,12 @@ HAVING COUNT(*) > 30
 ```
 
 **Action** :
+
 - Enquête manuelle modérateur
 - Révocation badge si abus confirmé
 
 **Patterns détectés** :
+
 - Signalement massif (>30/semaine)
 - Taux de pertinence <50% malgré volume élevé
 - Signalements tous rejetés sur période 7 jours
@@ -368,10 +394,12 @@ HAVING COUNT(*) > 30
    ```
 
 **Après audit** :
+
 - Email résultat : "Badge conservé ✓" ou "Badge révoqué ✗"
 - Possibilité de réobtenir badge ultérieurement (pas de ban)
 
 **Justification** :
+
 - Maintien qualité badges sur le long terme
 - Évite repos sur lauriers
 - Coût : 0€ (script automatique)
@@ -387,6 +415,7 @@ HAVING COUNT(*) > 30
 | **Grave** | Signalements massifs coordonnés (farming) | Ban permanent fonctionnalité signalement + révocation tous badges |
 
 **Notification sanction** :
+
 - Email + Push + In-app
 - Explication détaillée de l'abus détecté
 - Durée sanction
@@ -416,11 +445,13 @@ HAVING COUNT(*) > 30
 ---
 
 **Conformité** :
+
 - ✅ RGPD : données modération anonymisées après 3 ans
 - ✅ Transparence : utilisateur informé dès le 1er signalement
 - ✅ Anti-discrimination : système accessible à tous, basé uniquement sur pertinence
 
 **Scalabilité** :
+
 - 0-100 utilisateurs actifs : système automatique, 0€
 - 100-1000 utilisateurs actifs : 0-50€/mois (quelques badges Or)
 - 1000+ utilisateurs actifs : 50-200€/mois (max 50 badges Or simultanés)

docs/domains/moderation/rules/moderation-flows.md

@@ -19,6 +19,7 @@ Liste déroulante avec 7 options :
 | 🔧 **Autre** | Champ texte obligatoire si sélectionné |
 
 **Justification** :
+
 - Équilibre entre simplicité (pas trop de choix) et précision (aide les modérateurs)
 - Coût : 0€ (liste déroulante standard)
 
@@ -33,6 +34,7 @@ Liste déroulante avec 7 options :
 - Non bloquant : le signalement peut être envoyé sans commentaire
 
 **Justification** :
+
 - Encourage la qualité des signalements sans créer de friction
 - Aide les modérateurs à comprendre le contexte
 - Pas de risque d'abandon du processus
@@ -44,16 +46,19 @@ Liste déroulante avec 7 options :
 **Décision** : Toast in-app avec lien historique
 
 **Affichage** :
+
 - Toast notification : "✓ Signalement envoyé. Nous l'examinerons sous 24-48h."
 - Durée affichage : 5 secondes
 - Bouton optionnel "Voir mes signalements" (accès historique)
 
 **Historique personnel** :
+
 - Liste des signalements envoyés par l'utilisateur
 - Statut : En cours / Traité / Rejeté
 - Notification in-app si action prise (contenu retiré, signalement rejeté)
 
 **Justification** :
+
 - Transparence maximale
 - Coût : 0€ (aucun email automatique)
 - Bonne UX
@@ -85,15 +90,18 @@ Liste déroulante avec 7 options :
 4. Priorisation automatique selon score
 
 **Délais** :
+
 - Audio <5 min : 1-3 minutes
 - Audio 5-30 min : 3-10 minutes
 - Audio >30 min : 10-20 minutes
 
 **Coût** :
+
 - **MVP** : 0€ (CPU standard, processing asynchrone)
 - **Scale** : 50-200€/mois (GPU VPS si >1000 signalements/jour)
 
 **Justification** :
+
 - 100% open source, pas de dépendance GAFAM
 - Coût maîtrisé (scaling progressif)
 - Gain productivité modérateurs ×3-5
@@ -112,10 +120,12 @@ Liste déroulante avec 7 options :
 | **BASSE** | <72h (jours ouvrés) | Qualité audio, tags incorrects → Modérateur junior |
 
 **Traitement automatique** :
+
 - Score IA >95% + catégorie évidente (ex: spam répété) → Action automatique immédiate
 - Notification créateur + possibilité d'appel
 
 **Justification** :
+
 - Réaliste et conforme DSA (Digital Services Act)
 - Scalable : priorisation automatique
 - Ressources humaines optimisées
@@ -133,17 +143,20 @@ Priorité = (Score_IA × 0.7) + (Signalements_cumulés × 0.2) + (Fiabilité_sig
 ```
 
 **Détails** :
+
 - **Score_IA** : 0-100% (confiance analyse automatique)
 - **Signalements_cumulés** : nombre de signalements du même contenu (boost priorité)
 - **Fiabilité_signaleur** : score utilisateur (historique signalements pertinents)
 
 **Classification résultante** :
+
 - Priorité ≥90 → **CRITIQUE** (traitement immédiat)
 - Priorité 70-89 → **HAUTE** (file prioritaire)
 - Priorité 40-69 → **MOYENNE** (file normale)
 - Priorité <40 → **BASSE** (file différée)
 
 **Justification** :
+
 - Optimise le temps des modérateurs
 - Traite les cas graves en priorité
 - Coût : 0€ (algorithme simple)
@@ -186,11 +199,13 @@ L'équipe RoadWave
 ```
 
 **Coût** :
+
 - Email : ~0.001€/notification (Brevo, Resend)
 - Push : 0€ (APNS / FCM natifs)
 - In-app : 0€
 
 **Justification** :
+
 - Conformité DSA (transparence obligatoire)
 - Multi-canal garantit réception
 - Coût négligeable
@@ -232,6 +247,7 @@ L'équipe RoadWave
 ```
 
 **Justification** :
+
 - Transparence maximale (obligation DSA)
 - Créateur comprend l'erreur → amélioration future
 - Réduit les appels non fondés
@@ -243,6 +259,7 @@ L'équipe RoadWave
 **Décision** : Formulaire in-app structuré
 
 **Accès** :
+
 - Bouton "Contester cette décision" dans notification
 - Section "Mes sanctions" dans profil créateur
 
@@ -256,15 +273,18 @@ L'équipe RoadWave
 | **Preuves** | Upload fichiers (max 5, 10 MB total) | ❌ |
 
 **Après soumission** :
+
 - Génération numéro de ticket unique (ex: `#MOD-2026-00142`)
 - Email confirmation : "Votre appel sera traité sous 72h"
 - Statut visible dans l'app : "En cours d'examen"
 
 **Délai de soumission** :
+
 - Maximum **7 jours** après notification de sanction
 - Après 7 jours : appel automatiquement refusé
 
 **Justification** :
+
 - Professionnel et traçable
 - Intégration complète avec système modération
 - Coût : 0€ (formulaire custom backend)
@@ -284,6 +304,7 @@ L'équipe RoadWave
 | **Critique** | 24h (cas suspension longue/ban) | Admin modération |
 
 **Notification intermédiaire** (si délai >72h) :
+
 - Email J+3 : "Votre appel #MOD-XXX est en cours d'examen approfondi. Réponse sous 2 jours."
 
 **Réponse finale** :
@@ -295,10 +316,12 @@ Email détaillé avec :
 4. **Définitif** : mention "Cette décision est définitive" (pas de second appel)
 
 **Suivi in-app** :
+
 - Mise à jour statut : "Appel accepté ✓" ou "Appel rejeté ✗"
 - Badge notification
 
 **Justification** :
+
 - Équilibre entre rapidité et qualité de traitement
 - Conforme pratiques industrie (YouTube, TikTok : 5-7 jours)
 - Ressources humaines réalistes
@@ -329,6 +352,7 @@ Email détaillé avec :
 5. **Fil d'activité** : actions récentes équipe (temps réel)
 
 **Coût infrastructure** :
+
 - MVP : 0-50€/mois (serveur CPU)
 - Scale : 50-200€/mois (GPU + Redis Cluster)
 
@@ -337,20 +361,24 @@ Email détaillé avec :
 ### 14.5 Modération préventive (rappel)
 
 **Nouveaux créateurs** :
+
 - Validation manuelle des **3 premiers contenus**
 - Délai : 24-48h (jours ouvrés)
 - Transcription automatique pour aide modérateur
 
 **Score de confiance** :
+
 - Évolution dynamique selon historique
 - Créateur fiable (0 strike depuis 6 mois) → validation automatique
 - Créateur suspect (strikes récents) → validation manuelle systématique
 
 **Publicités** :
+
 - Validation manuelle obligatoire 24-48h (responsabilité juridique)
 - Transcription + analyse métadonnées (ciblage, durée, volume)
 
 **Justification** :
+
 - Prévention > réaction (économie modération)
 - Qualité plateforme préservée dès le début
 
@@ -375,11 +403,13 @@ Email détaillé avec :
 **Coût total MVP** : **0-200€/mois** (infrastructure IA optionnelle)
 
 **Conformité** :
+
 - ✅ DSA (Digital Services Act) : transparence, traçabilité, délais
 - ✅ RGPD : données modération anonymisées après 3 ans
 - ✅ Logs audit : toutes actions tracées (obligation légale plateforme)
 
 **Scalabilité** :
+
 - 0-1000 signalements/mois : équipe 1-2 modérateurs junior + 1 senior
 - 1000-10K signalements/mois : équipe 5-10 modérateurs + IA GPU
 - 10K+ signalements/mois : équipe dédiée + IA optimisée + modération communautaire

docs/domains/moderation/states/signalement-lifecycle.md

@@ -64,6 +64,7 @@ stateDiagram-v2
 ## Légende
 
 **États principaux** :
+
 - **Reçu** : Signalement initial (<1s)
 - **EnTranscription** : Whisper large-v3 (1-20 min)
 - **EnAnalyseIA** : Score confiance 0-100% (<1 min)