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/premium/rules/premium.md

@@ -12,6 +12,7 @@
 **❌ Pas d'essai gratuit**
 
 **Raisons** :
+
 - **Anti-abus vacances** : évite inscriptions opportunistes (essai 14j avant road trip vacances, puis annulation)
 - **Protection revenus créateurs** : les écoutes Premium rémunèrent créateurs dès jour 1
 - **Simplicité** : pas de gestion période trial + conversion
@@ -20,6 +21,7 @@
 **❌ Pas de partage familial (MVP)**
 
 **Raisons** :
+
 - Complexité technique (gestion invitations, validation liens, limite devices)
 - Risque abus ("familles" de 6 inconnus)
 - Coût dev/support élevé pour ROI incertain
@@ -27,6 +29,7 @@
 - **Post-MVP** : Si forte demande, offre "Famille" à 9.99€/mois pour 5 comptes
 
 **Justification tarif** :
+
 - **Aligné marché bas** : Spotify = 10.99€, YouTube Premium = 11.99€, Apple Music = 10.99€
 - **Prix accessible** : cible conducteurs quotidiens (budget raisonnable)
 - **Incitation annuel** : 2 mois offerts = engagement long terme + réduction churn
@@ -100,6 +103,7 @@ Device 1 vraiment offline (mode avion, tunnel)
 ```
 
 **Boutons** :
+
 - **Reprendre ici** : Coupe l'autre device, reprend lecture sur ce device
 - **Sécuriser mon compte** : Lien vers changement mot de passe + déconnexion tous devices
 
@@ -119,6 +123,7 @@ Contenus téléchargés valides 30 jours
 #### Détection abus (post-MVP)
 
 Monitoring patterns suspects (backend analytics) :
+
 - >10 changements devices/jour (suspect)
 - Connexions alternées 2 villes éloignées répétées
 - Signalements users : "je n'ai jamais été à Marseille"
@@ -131,6 +136,7 @@ Action :
 **Pas d'action automatique** (évite faux positifs), juste flag modération manuelle.
 
 **Justification KISS** :
+
 - ✅ **Simplicité technique** : pas de tracking GPS précis, pas de calcul distances, pas de faux positifs (TGV Paris→Lyon = légitime)
 - ✅ **Assume bonne foi** : majorité users honnêtes, partage compte = minorité, gestion réactive suffit
 - ✅ **Message dissuasif clair** : avertissement CGU dans message coupure, possibilité "Sécuriser compte" si suspicion piratage
@@ -144,12 +150,14 @@ Action :
 **Décision** : Créateur décide (déjà couvert section 9.6)
 
 **Rappel règles** :
+
 - Toggle "Réservé Premium" par contenu
 - Aucune limite de ratio gratuit/premium
 - Badge 👑 visible
 - Users gratuits : lecture bloquée avec CTA "Passez Premium"
 
 **Impact algorithme** :
+
 - Contenus premium inclus dans recommandations
 - Si user gratuit → skip automatique (ne consomme pas slot)
 - Si user premium → diffusé normalement selon score
@@ -169,10 +177,12 @@ Action :
 | **Historique écoute** | 100 derniers | Illimité |
 
 **Qualité audio** :
+
 - Gratuit : 48 kbps Opus (~20 MB/h) = très correct pour voix
 - Premium : 64 kbps Opus (~30 MB/h) = excellente qualité
 
 **Justification différences** :
+
 - **0 pub** = argument principal (confort écoute)
 - **Qualité audio** = avantage tangible audiophiles
 - **Offline illimité** = use case road trips longs
@@ -191,23 +201,27 @@ Action :
 | **Android App** | Google Play Billing | 5.99€ | 30% (Google) |
 
 **Majoration mobile (5.99€)** :
+
 - Apple/Google prennent 30% de commission
 - RoadWave majore prix de 20% pour compenser
 - **Incitation web** : Email aux users "Abonnez-vous sur roadwave.com pour 4.99€/mois" (38% moins cher en frais !)
 
 **Renouvellement automatique** :
+
 - Email rappel **7 jours avant** renouvellement
 - Email confirmation **après** renouvellement réussi
 - Retry automatique si échec paiement (3 tentatives sur 7 jours)
 - Annulation automatique après 3 échecs
 
 **Annulation** :
+
 - Self-service dans Settings app : "Abonnement > Annuler"
 - Accès Premium maintenu jusqu'à **fin période payée**
 - Pas de remboursement prorata (standard industrie)
 - Email confirmation annulation avec date fin d'accès
 
 **Réabonnement** :
+
 - Possibilité immédiate
 - ❌ Pas de nouvelle période d'essai (pas d'essai du tout)
 
@@ -235,6 +249,7 @@ CREATE TABLE subscriptions (
 ```
 Cache Redis : premium:{user_id} → boolean (TTL 1h)
 Refresh via webhooks :
+
 - Mangopay : PAYIN_NORMAL_SUCCEEDED, PAYIN_NORMAL_FAILED
 - Apple : App Store Server Notifications
 - Google : Real-time Developer Notifications