refactor(docs): réorganiser la documentation selon principes DDD
Réorganise la documentation du projet selon les principes du Domain-Driven Design (DDD) pour améliorer la cohésion, la maintenabilité et l'alignement avec l'architecture modulaire du backend. **Structure cible:** ``` docs/domains/ ├── README.md (Context Map) ├── _shared/ (Core Domain) ├── recommendation/ (Supporting Subdomain) ├── content/ (Supporting Subdomain) ├── moderation/ (Supporting Subdomain) ├── advertising/ (Generic Subdomain) ├── premium/ (Generic Subdomain) └── monetization/ (Generic Subdomain) ``` **Changements effectués:** Phase 1: Création de l'arborescence des 7 bounded contexts Phase 2: Déplacement des règles métier (01-19) vers domains/*/rules/ Phase 3: Déplacement des diagrammes d'entités vers domains/*/entities/ Phase 4: Déplacement des diagrammes flux/états/séquences vers domains/*/ Phase 5: Création des README.md pour chaque domaine Phase 6: Déplacement des features Gherkin vers domains/*/features/ Phase 7: Création du Context Map (domains/README.md) Phase 8: Mise à jour de mkdocs.yml pour la nouvelle navigation Phase 9: Correction automatique des liens internes (script fix-markdown-links.sh) Phase 10: Nettoyage de l'ancienne structure (regles-metier/, diagrammes/, features/) **Configuration des tests:** - Makefile: godog run docs/domains/*/features/ - scripts/generate-bdd-docs.py: features_dir → docs/domains **Avantages:** ✅ Cohésion forte: toute la doc d'un domaine au même endroit ✅ Couplage faible: domaines indépendants, dépendances explicites ✅ Navigabilité améliorée: README par domaine = entrée claire ✅ Alignement code/docs: miroir de backend/internal/ ✅ Onboarding facilité: exploration domaine par domaine ✅ Tests BDD intégrés: features au plus près des règles métier Voir docs/REFACTOR-DDD.md pour le plan complet.
This commit is contained in:
jpgiannetti
633
docs/domains/moderation/rules/autres-comportements.md
Normal file
633
docs/domains/moderation/rules/autres-comportements.md
Normal file
@@ -0,0 +1,633 @@
|
||||
## 15. Autres comportements
|
||||
|
||||
### 15.1 Partage de contenu
|
||||
|
||||
**Décision** : Système de partage complet avec web player
|
||||
|
||||
#### 15.1.1 Bouton "Partager"
|
||||
|
||||
**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)
|
||||
- Historique personnel
|
||||
|
||||
**Icône** : ⬆️ (universelle iOS/Android)
|
||||
|
||||
**Menu options** :
|
||||
- Copier le lien
|
||||
- WhatsApp
|
||||
- Email
|
||||
- SMS
|
||||
- Plus... (sheet natif OS)
|
||||
|
||||
**Justification** :
|
||||
- Viralité = croissance organique gratuite
|
||||
- Aucune friction, partage universel
|
||||
|
||||
---
|
||||
|
||||
#### 15.1.2 Comportement du lien partagé
|
||||
|
||||
**Format URL** : `https://roadwave.fr/share/c/[content_id]`
|
||||
|
||||
**Comportement multi-plateforme** :
|
||||
|
||||
```
|
||||
User clique lien partagé
|
||||
↓
|
||||
Page web responsive
|
||||
↓
|
||||
┌─────────────────────────────────┐
|
||||
│ Si app installée │
|
||||
│ → Deep link (ouverture directe) │
|
||||
└─────────────────────────────────┘
|
||||
↓
|
||||
┌─────────────────────────────────┐
|
||||
│ Si app non installée │
|
||||
│ → Web player + CTA téléchargement│
|
||||
└─────────────────────────────────┘
|
||||
```
|
||||
|
||||
**Contenu de la page web** :
|
||||
|
||||
```html
|
||||
┌───────────────────────────────────────┐
|
||||
│ RoadWave │
|
||||
├───────────────────────────────────────┤
|
||||
│ [Image cover 16:9] │
|
||||
│ │
|
||||
│ 📻 Titre du contenu │
|
||||
│ Par @créateur · 12 min · 🎧 2.3K │
|
||||
│ │
|
||||
│ 📍 Paris 5e · Ancré │
|
||||
│ 🏷️ #Voyage #Histoire │
|
||||
│ │
|
||||
│ Description : Lorem ipsum... │
|
||||
│ │
|
||||
│ [▶️ Écouter maintenant] │
|
||||
│ (Player HTML5 si contenu public) │
|
||||
│ │
|
||||
│ ────────────────────────────────── │
|
||||
│ │
|
||||
│ 📱 Télécharger l'app RoadWave │
|
||||
│ [App Store] [Google Play] │
|
||||
│ │
|
||||
│ [Voir le profil de @créateur] │
|
||||
└───────────────────────────────────────┘
|
||||
```
|
||||
|
||||
**Métadonnées Open Graph (SEO)** :
|
||||
|
||||
```html
|
||||
<meta property="og:title" content="[Titre contenu] - RoadWave">
|
||||
<meta property="og:description" content="[Description ou extrait]">
|
||||
<meta property="og:image" content="[URL cover image]">
|
||||
<meta property="og:audio" content="[URL audio si public]">
|
||||
<meta property="og:type" content="music.song">
|
||||
<meta property="og:site_name" content="RoadWave">
|
||||
<meta name="twitter:card" content="player">
|
||||
<meta name="twitter:player" content="https://roadwave.fr/player/[content_id]">
|
||||
```
|
||||
|
||||
**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)
|
||||
- Coût : 0€ (backend simple + CDN existant)
|
||||
|
||||
---
|
||||
|
||||
#### 15.1.3 Contenus Premium partagés
|
||||
|
||||
**Décision** : Preview 30 secondes + paywall
|
||||
|
||||
**Comportement** :
|
||||
|
||||
1. User clique lien contenu Premium partagé
|
||||
2. Page web affiche badge "👑 Contenu Premium"
|
||||
3. Player démarre automatiquement
|
||||
4. Après **30 secondes exactement** :
|
||||
- Fade out audio (2 secondes)
|
||||
- Overlay apparaît :
|
||||
|
||||
```
|
||||
┌─────────────────────────────────┐
|
||||
│ 👑 Contenu réservé Premium │
|
||||
│ │
|
||||
│ Profitez de ce contenu complet │
|
||||
│ et de milliers d'autres │
|
||||
│ sans publicité │
|
||||
│ │
|
||||
│ [Passer Premium - 4.99€/mois] │
|
||||
│ [Télécharger l'app] │
|
||||
└─────────────────────────────────┘
|
||||
```
|
||||
|
||||
5. Utilisateur peut :
|
||||
- S'abonner Premium (redirection web Mangopay)
|
||||
- Télécharger l'app (redirection stores)
|
||||
- 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
|
||||
|
||||
---
|
||||
|
||||
### 15.2 Profil créateur
|
||||
|
||||
**Décision** : Profil public complet et transparent
|
||||
|
||||
#### 15.2.1 Structure de la page profil
|
||||
|
||||
**URL** : `https://roadwave.fr/@[pseudo]`
|
||||
|
||||
**Layout** :
|
||||
|
||||
```
|
||||
┌────────────────────────────────────────┐
|
||||
│ [Photo profil 120×120] │
|
||||
│ @pseudo ✓ │
|
||||
│ [Badge vérifié si applicable] │
|
||||
│ │
|
||||
│ Bio : Lorem ipsum dolor sit amet... │
|
||||
│ (300 caractères max) │
|
||||
│ │
|
||||
│ 🎧 1.2K abonnés │
|
||||
│ 📻 42 contenus │
|
||||
│ ⏱️ 18h de contenu créé │
|
||||
│ 🔊 54K écoutes totales │
|
||||
│ │
|
||||
│ [S'abonner] [Partager profil] [•••] │
|
||||
│ │
|
||||
│ ──────────────────────────────────── │
|
||||
│ │
|
||||
│ Contenus ▼ [Plus récents ▼] │
|
||||
│ │
|
||||
│ ┌──────────────────────────────────┐ │
|
||||
│ │ [Cover] Titre contenu 1 │ │
|
||||
│ │ 12 min · 🎧 2.3K · 📍 Paris │ │
|
||||
│ │ [▶️] │ │
|
||||
│ └──────────────────────────────────┘ │
|
||||
│ │
|
||||
│ ┌──────────────────────────────────┐ │
|
||||
│ │ [Cover] Titre contenu 2 │ │
|
||||
│ │ 8 min · 🎧 5.1K · 📍 Lyon │ │
|
||||
│ │ [▶️] │ │
|
||||
│ └──────────────────────────────────┘ │
|
||||
│ │
|
||||
│ [Charger plus] │
|
||||
└────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
**Informations affichées** :
|
||||
|
||||
| Élément | Visibilité | Détails |
|
||||
|---------|------------|---------|
|
||||
| **Photo + pseudo** | ✅ Public | Identité visuelle |
|
||||
| **Badge vérifié ✓** | ✅ Public (si applicable) | Compte authentique |
|
||||
| **Bio** | ✅ Public | 0-300 caractères, markdown basique (gras, italique, liens) |
|
||||
| **Nombre abonnés** | ✅ Public | Arrondi si >1000 (ex: 1.2K, 54K) |
|
||||
| **Nombre contenus** | ✅ Public | Exact |
|
||||
| **Durée totale créée** | ✅ Public | Arrondi en heures (ex: 18h, 142h) |
|
||||
| **Écoutes totales** | ✅ Public | Arrondi (ex: 54K, 1.2M) |
|
||||
| **Liste abonnés** | ❌ Privé | Protection vie privée (RGPD) |
|
||||
| **Revenus** | ❌ Privé | Confidentialité financière |
|
||||
| **Localisation précise** | ❌ Privé | Sécurité |
|
||||
| **Email** | ❌ Privé | Anti-spam |
|
||||
|
||||
**Tri des contenus** :
|
||||
|
||||
| Option | Comportement |
|
||||
|--------|--------------|
|
||||
| **Plus récents** | Date publication DESC (défaut) |
|
||||
| **Plus populaires** | Écoutes complètes × (1 + (date_publication - now) / 90 jours) |
|
||||
| **Plus anciens** | Date publication ASC |
|
||||
| **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)
|
||||
|
||||
---
|
||||
|
||||
#### 15.2.2 Statistiques publiques
|
||||
|
||||
**Décision** : Stats arrondies et motivantes
|
||||
|
||||
**Affichage public** :
|
||||
|
||||
| Métrique | Format affichage | Exemple |
|
||||
|----------|------------------|---------|
|
||||
| **Abonnés** | Exact si <1000, arrondi sinon | 342 / 1.2K / 54K / 1.2M |
|
||||
| **Écoutes totales** | Arrondi dès 1000 | 842 / 5.4K / 142K / 2.1M |
|
||||
| **Contenus publiés** | Exact | 42 contenus |
|
||||
| **Durée totale** | Arrondi en heures | 18h / 142h de contenu |
|
||||
|
||||
**Métriques PRIVÉES (créateur uniquement)** :
|
||||
|
||||
| Métrique | Disponible dans dashboard créateur |
|
||||
|----------|-------------------------------------|
|
||||
| **Taux complétion moyen** | 78% (écoutes >80% / écoutes totales) |
|
||||
| **Évolution abonnés** | Graphique 30j / 90j / 1 an |
|
||||
| **Écoutes par contenu** | Tableau détaillé |
|
||||
| **Revenus** | Dashboard monétisation dédié |
|
||||
| **Taux conversion Premium** | Partages → conversions |
|
||||
| **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)
|
||||
- Privacy by design
|
||||
|
||||
---
|
||||
|
||||
#### 15.2.3 Badge vérifié
|
||||
|
||||
**Décision** : Badge unique ✓ (vérifié officiel)
|
||||
|
||||
**Critères d'attribution** (au moins UN des critères) :
|
||||
|
||||
1. **KYC monétisation validé** : identité vérifiée via Mangopay KYC
|
||||
2. **Célébrité / Média officiel** : validation manuelle équipe RoadWave
|
||||
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é"
|
||||
|
||||
**Processus d'obtention** :
|
||||
|
||||
| Type | Processus |
|
||||
|------|-----------|
|
||||
| **Automatique (KYC)** | Badge attribué dès validation documents Mangopay |
|
||||
| **Manuel (célébrité)** | Formulaire demande → équipe vérifie identité → validation 48-72h |
|
||||
| **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)
|
||||
- Coût : 0€ (champ boolean `verified` en DB)
|
||||
|
||||
---
|
||||
|
||||
### 15.3 Recherche
|
||||
|
||||
**Décision** : Recherche full-text + géo + filtres avancés
|
||||
|
||||
#### 15.3.1 Recherche par mot-clé
|
||||
|
||||
**Implémentation** : PostgreSQL full-text search (français)
|
||||
|
||||
**Configuration technique** :
|
||||
|
||||
```sql
|
||||
-- Index full-text optimisé français
|
||||
CREATE INDEX idx_content_search ON contents
|
||||
USING GIN(
|
||||
to_tsvector('french',
|
||||
coalesce(title, '') || ' ' ||
|
||||
coalesce(description, '') || ' ' ||
|
||||
coalesce(creator_pseudo, '')
|
||||
)
|
||||
);
|
||||
|
||||
-- Recherche avec ranking
|
||||
SELECT
|
||||
c.*,
|
||||
ts_rank(
|
||||
to_tsvector('french', c.title || ' ' || c.description),
|
||||
plainto_tsquery('french', $search_query)
|
||||
) AS rank
|
||||
FROM contents c
|
||||
WHERE to_tsvector('french', c.title || ' ' || c.description)
|
||||
@@ plainto_tsquery('french', $search_query)
|
||||
ORDER BY rank DESC, listen_count DESC
|
||||
LIMIT 20;
|
||||
```
|
||||
|
||||
**Champs indexés** :
|
||||
- Titre du contenu (poids × 3)
|
||||
- Description (poids × 1)
|
||||
- Pseudo créateur (poids × 2)
|
||||
- Tags (poids × 1.5)
|
||||
|
||||
**Fonctionnalités** :
|
||||
|
||||
| Feature | Description |
|
||||
|---------|-------------|
|
||||
| **Stemming français** | "voyages" trouve "voyage", "voyager", etc. |
|
||||
| **Correction auto** | Suggestion si 0 résultat |
|
||||
| **Recherches populaires** | "Essayez plutôt : balade paris, audio-guide louvre" |
|
||||
| **Historique personnel** | 10 dernières recherches sauvegardées |
|
||||
| **Autocomplete** | Suggestions pendant frappe (top 5) |
|
||||
|
||||
**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
|
||||
|
||||
---
|
||||
|
||||
#### 15.3.2 Recherche géographique
|
||||
|
||||
**Décision** : Recherche lieu + rayon paramétrable
|
||||
|
||||
**Interface utilisateur** :
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────┐
|
||||
│ 🔍 Recherche contenu... │
|
||||
├─────────────────────────────────────┤
|
||||
│ <20><> Lieu │
|
||||
│ [Paris, France ▼] │
|
||||
│ · Autour de moi (GPS actuel) │
|
||||
│ · Entrer une adresse/ville │
|
||||
│ │
|
||||
│ 📏 Rayon de recherche │
|
||||
│ [●─────────────────] 50 km │
|
||||
│ (curseur 5 km → 500 km) │
|
||||
│ │
|
||||
│ 🗺️ [Afficher sur carte] │
|
||||
└─────────────────────────────────────┘
|
||||
```
|
||||
|
||||
**Géocodage** :
|
||||
|
||||
| Service | Usage | Coût |
|
||||
|---------|-------|------|
|
||||
| **Nominatim (OSM)** | MVP (API publique) | 0€ (rate limit 1 req/s) |
|
||||
| **Nominatim self-hosted** | Scale (Docker) | 20-50€/mois VPS |
|
||||
| **Mapbox Geocoding** | Fallback premium | 0.50€ / 1000 requêtes |
|
||||
|
||||
**Processus de recherche géo** :
|
||||
|
||||
1. User tape "Louvre" ou "Paris"
|
||||
2. Autocomplete via Nominatim → liste suggestions
|
||||
3. User sélectionne → récupération coordonnées (lat, lon)
|
||||
4. Requête PostGIS :
|
||||
|
||||
```sql
|
||||
SELECT c.*,
|
||||
ST_Distance(c.location::geography, ST_Point($lon, $lat)::geography) AS distance
|
||||
FROM contents c
|
||||
WHERE ST_DWithin(
|
||||
c.location::geography,
|
||||
ST_Point($lon, $lat)::geography,
|
||||
$radius_meters
|
||||
)
|
||||
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)
|
||||
|
||||
---
|
||||
|
||||
#### 15.3.3 Filtres avancés
|
||||
|
||||
**Décision** : 7 catégories de filtres combinables
|
||||
|
||||
**Interface filtres** :
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────┐
|
||||
│ Filtres [×] │
|
||||
├─────────────────────────────────────┤
|
||||
│ Type de contenu │
|
||||
│ ☐ Contenu court (<5 min) │
|
||||
│ ☐ Podcast (>5 min) │
|
||||
│ ☐ Radio live │
|
||||
│ ☐ Audio-guide │
|
||||
│ │
|
||||
│ Durée │
|
||||
│ ○ Toutes durées │
|
||||
│ ○ <5 min │
|
||||
│ ○ 5-15 min │
|
||||
│ ○ 15-30 min │
|
||||
│ ○ >30 min │
|
||||
│ │
|
||||
│ Classification âge │
|
||||
│ ☐ Tout public │
|
||||
│ ☐ 13+ │
|
||||
│ ☐ 16+ │
|
||||
│ ☐ 18+ │
|
||||
│ │
|
||||
│ Géo-pertinence │
|
||||
│ ☐ Ancré (lieu précis) │
|
||||
│ ☐ Contextuel (zone large) │
|
||||
│ ☐ Neutre (national) │
|
||||
│ │
|
||||
│ Tags (multi-sélection) │
|
||||
│ ☐ Automobile ☐ Voyage │
|
||||
│ ☐ Famille ☐ Histoire │
|
||||
│ ☐ Économie ☐ Sciences │
|
||||
│ ... (liste complète tags) │
|
||||
│ │
|
||||
│ Date de publication │
|
||||
│ ○ Toutes dates │
|
||||
│ ○ Dernières 24h │
|
||||
│ ○ Cette semaine │
|
||||
│ ○ Ce mois │
|
||||
│ ○ Cette année │
|
||||
│ │
|
||||
│ Abonnement │
|
||||
│ ○ Tous les contenus │
|
||||
│ ○ Gratuits uniquement │
|
||||
│ ○ Premium uniquement 👑 │
|
||||
│ │
|
||||
│ ────────────────────────────── │
|
||||
│ [Réinitialiser] [Appliquer] │
|
||||
└─────────────────────────────────────┘
|
||||
```
|
||||
|
||||
**Options de tri** :
|
||||
|
||||
| Tri | Algorithme |
|
||||
|-----|-----------|
|
||||
| **Pertinence** | Score recherche × (1 + log(listen_count + 1)) |
|
||||
| **Popularité** | Écoutes complètes derniers 30j DESC |
|
||||
| **Récent** | Date publication DESC |
|
||||
| **Proximité** | Distance GPS ASC (si recherche géo active) |
|
||||
| **Durée** | Durée audio ASC ou DESC |
|
||||
|
||||
**Sauvegarde de recherches** :
|
||||
|
||||
- Bouton "💾 Sauvegarder cette recherche"
|
||||
- Nom personnalisable : "Podcasts voyage Paris"
|
||||
- Maximum **5 recherches sauvegardées**
|
||||
- Accès rapide : onglet "Recherches sauvegardées" dans page recherche
|
||||
- Notifications optionnelles : "3 nouveaux contenus dans 'Podcasts voyage Paris'"
|
||||
|
||||
**Performances** :
|
||||
|
||||
```sql
|
||||
-- Index composites pour filtres
|
||||
CREATE INDEX idx_content_filters ON contents (
|
||||
content_type,
|
||||
duration,
|
||||
age_rating,
|
||||
geo_type,
|
||||
published_at
|
||||
);
|
||||
|
||||
-- Index GIN pour tags
|
||||
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
|
||||
|
||||
---
|
||||
|
||||
#### 15.3.4 Page de résultats
|
||||
|
||||
**Décision** : Liste avec previews enrichies
|
||||
|
||||
**Layout résultats** :
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────┐
|
||||
│ 🔍 "voyage paris" │
|
||||
│ 42 résultats · Tri : Pertinence ▼ │
|
||||
│ [Filtres] [Carte] │
|
||||
├─────────────────────────────────────────┤
|
||||
│ ┌─────────────────────────────────────┐ │
|
||||
│ │ [Cover ] Balade à Paris │ │
|
||||
│ │ [16:9 ] @paris_stories ✓ │ │
|
||||
│ │ [Image ] 12 min · 🎧 2.3K │ │
|
||||
│ │ 📍 Paris 5e · Ancré │ │
|
||||
│ │ 🏷️ #Voyage #Histoire │ │
|
||||
│ │ [▶️ Écouter] [⋮] │ │
|
||||
│ └─────────────────────────────────────┘ │
|
||||
│ │
|
||||
│ ┌─────────────────────────────────────┐ │
|
||||
│ │ [Cover ] Secrets Montmartre │ │
|
||||
│ │ [16:9 ] @explore_paris │ │
|
||||
│ │ [Image ] 8 min · 🎧 5.1K │ │
|
||||
│ │ 📍 Paris 18e · Guide │ │
|
||||
│ │ 🏷️ #Voyage #Art │ │
|
||||
│ │ [▶️ Écouter] [⋮] │ │
|
||||
│ └─────────────────────────────────────┘ │
|
||||
│ │
|
||||
│ [Charger plus] (20 suivants) │
|
||||
└─────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
**Informations par résultat** :
|
||||
|
||||
| Élément | Affichage |
|
||||
|---------|-----------|
|
||||
| **Cover image** | 16:9, 120×68 px, lazy loading |
|
||||
| **Titre** | Tronqué 2 lignes max |
|
||||
| **Créateur** | @pseudo + badge ✓ si vérifié, cliquable → profil |
|
||||
| **Durée** | Format : "3 min" / "12 min" / "1h 24 min" |
|
||||
| **Écoutes** | Arrondi : "2.3K" / "54K" / "1.2M" |
|
||||
| **Localisation** | Ville + type géo (Ancré/Contextuel/Neutre) |
|
||||
| **Tags** | Maximum 3 premiers tags |
|
||||
| **Badge Premium** | 👑 si contenu premium |
|
||||
| **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
|
||||
- Clustering si >50 résultats proches
|
||||
|
||||
**Coût** : 0€ (Leaflet open source + OSM tiles gratuit)
|
||||
|
||||
**Justification** :
|
||||
- Équilibre information / compacité
|
||||
- Lazy loading = performances
|
||||
- Infinite scroll = UX moderne
|
||||
|
||||
---
|
||||
|
||||
## Récapitulatif Section 15
|
||||
|
||||
| Point | Décision | Coût | Complexité |
|
||||
|-------|----------|------|------------|
|
||||
| **15.1.1** Bouton partager | Disponible partout (⬆️), menu natif OS | 0€ | Faible |
|
||||
| **15.1.2** Lien partagé | Web player + deep link + Open Graph SEO | 0€ | Moyenne |
|
||||
| **15.1.3** Premium partagé | Preview 30s + paywall overlay | 0€ | Faible |
|
||||
| **15.2.1** Page profil | Profil public complet (stats + bio + contenus + tri) | 0€ | Faible |
|
||||
| **15.2.2** Stats publiques | Arrondies (abonnés, écoutes, durée totale) | 0€ | Faible |
|
||||
| **15.2.3** Badge vérifié | ✓ si KYC/célébrité/>10K abonnés | 0€ | Faible |
|
||||
| **15.3.1** Recherche texte | PostgreSQL full-text french + stemming | 0€ | Moyenne |
|
||||
| **15.3.2** Recherche géo | Lieu + rayon (Nominatim OSM) | 0-50€/mois | Moyenne |
|
||||
| **15.3.3** Filtres | 7 catégories combinables + sauvegarde recherches | 0€ | Moyenne |
|
||||
| **15.3.4** Page résultats | Liste enrichie + vue carte Leaflet + infinite scroll | 0€ | Moyenne |
|
||||
|
||||
**Coût total MVP : 0-50€/mois** (Nominatim self-hosted optionnel)
|
||||
|
||||
---
|
||||
|
||||
## Points d'attention pour Gherkin
|
||||
|
||||
- Tester partage contenu public vs Premium (preview 30s)
|
||||
- Tester deep linking iOS/Android (ouverture app si installée)
|
||||
- Tester Open Graph (aperçu correct sur WhatsApp, Twitter, Facebook)
|
||||
- Tester profil public (stats arrondies, badge vérifié)
|
||||
- Tester recherche full-text français (stemming, accents)
|
||||
- Tester recherche géo + rayon (PostGIS distance)
|
||||
- Tester combinaison filtres multiples (AND logic)
|
||||
- Tester sauvegarde recherches (max 5)
|
||||
- Tester pagination infinite scroll + fallback bouton
|
||||
- Tester vue carte Leaflet (clustering, markers cliquables)
|
||||
430
docs/domains/moderation/rules/moderation-communautaire.md
Normal file
430
docs/domains/moderation/rules/moderation-communautaire.md
Normal file
@@ -0,0 +1,430 @@
|
||||
## 19. Modération Communautaire - Badges et Récompenses
|
||||
|
||||
**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
|
||||
|
||||
---
|
||||
|
||||
### 19.1 Système de badges
|
||||
|
||||
**Décision** : 3 niveaux de badges selon l'historique de signalements validés
|
||||
|
||||
#### 19.1.1 Badges et critères
|
||||
|
||||
| Badge | Nom | Critères | Avantages |
|
||||
|-------|-----|----------|-----------|
|
||||
| 🥉 | **Contributeur Bronze** | 5 signalements validés + 70% taux pertinence | Signalements prioritaires (+10 points algorithme) |
|
||||
| 🥈 | **Contributeur Argent** | 20 signalements validés + 80% taux pertinence | Signalements prioritaires (+20 points) + Badge visible profil |
|
||||
| 🥇 | **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
|
||||
|
||||
**Calcul du taux de pertinence** :
|
||||
```
|
||||
Taux de pertinence = (Signalements validés / Total signalements envoyés) × 100
|
||||
```
|
||||
|
||||
**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é
|
||||
|
||||
---
|
||||
|
||||
#### 19.1.2 Délai entre obtention badges
|
||||
|
||||
**Décision** : Délai minimum entre niveaux
|
||||
|
||||
| Transition | Délai minimum |
|
||||
|------------|---------------|
|
||||
| **Bronze → Argent** | 30 jours |
|
||||
| **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)
|
||||
|
||||
---
|
||||
|
||||
#### 19.1.3 Découverte du système
|
||||
|
||||
**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
|
||||
|
||||
**Modal d'information** (affichage unique, ne se réaffiche jamais) :
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────┐
|
||||
│ 🎯 Bravo ! Vous contribuez à une │
|
||||
│ communauté plus saine │
|
||||
├─────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ En signalant ce contenu, vous participez │
|
||||
│ activement à améliorer l'expérience de │
|
||||
│ tous les utilisateurs RoadWave. │
|
||||
│ │
|
||||
│ Vos contributions de qualité sont │
|
||||
│ valorisées et récompensées : │
|
||||
│ │
|
||||
│ 🥉 Bronze : 5 signalements validés │
|
||||
│ → Signalements prioritaires │
|
||||
│ │
|
||||
│ 🥈 Argent : 20 signalements validés │
|
||||
│ → Badge visible + priorité accrue │
|
||||
│ │
|
||||
│ 🥇 Or : 50 signalements validés │
|
||||
│ → Réduction Premium -50% pendant 3 mois │
|
||||
│ │
|
||||
│ 💡 Votre taux de pertinence compte ! │
|
||||
│ Signalements validés ÷ Total × 100 │
|
||||
│ │
|
||||
│ Continuez à nous aider, chaque │
|
||||
│ signalement pertinent compte ! 🙏 │
|
||||
│ │
|
||||
│ [En savoir plus] [J'ai compris] │
|
||||
└─────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
**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
|
||||
- Avantages détaillés de chaque niveau
|
||||
- Règles anti-abus (limite 10 signalements/24h)
|
||||
- Durée de validité des badges (audit trimestriel)
|
||||
|
||||
**Coût** : **0€** (modal one-time, logique backend simple)
|
||||
|
||||
---
|
||||
|
||||
#### 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** :
|
||||
- 🥉 Bronze : "🎉 Félicitations ! Vous êtes désormais Contributeur Bronze. Merci de rendre RoadWave meilleur !"
|
||||
- 🥈 Argent : "🎉 Impressionnant ! Badge Contributeur Argent obtenu. Votre engagement fait la différence !"
|
||||
- 🥇 Or : "🎉 Exceptionnel ! Vous êtes Contributeur Or. La communauté vous remercie pour votre aide précieuse !"
|
||||
|
||||
**Statistiques personnelles** (page Profil > Mes signalements) :
|
||||
```
|
||||
📊 Vos statistiques de modération
|
||||
Signalements envoyés : 27
|
||||
Validés : 23 ✅
|
||||
Rejetés : 4 ❌
|
||||
Taux de pertinence : 85%
|
||||
|
||||
Badge actuel : 🥈 Contributeur Argent
|
||||
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
|
||||
|
||||
---
|
||||
|
||||
### 19.2 Score de fiabilité
|
||||
|
||||
**Décision** : Score interne utilisé pour prioriser les signalements dans l'algorithme
|
||||
|
||||
#### 19.2.1 Formule
|
||||
|
||||
```
|
||||
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
|
||||
- **Plafond** : maximum 100 points
|
||||
|
||||
**Exemples** :
|
||||
|
||||
| Cas | Validés | Rejetés | Badge | Score |
|
||||
|-----|---------|---------|-------|-------|
|
||||
| Nouvel utilisateur fiable | 10 | 1 | Aucun | 95 |
|
||||
| Utilisateur moyen | 15 | 8 | Bronze | 70 |
|
||||
| Contributeur Or | 50 | 3 | Or | 100 (plafonné) |
|
||||
| Signaleur abusif | 2 | 20 | Aucun | 0 (min 0) |
|
||||
|
||||
---
|
||||
|
||||
#### 19.2.2 Utilisation dans l'algorithme de priorisation
|
||||
|
||||
**Rappel formule Section 14.2.3** :
|
||||
```
|
||||
Priorité = (Score_IA × 0.7) + (Signalements_cumulés × 0.2) + (Fiabilité_signaleur × 0.1)
|
||||
```
|
||||
|
||||
**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 :
|
||||
```
|
||||
Votre score de fiabilité : 85/100
|
||||
→ Vos signalements sont traités en priorité
|
||||
```
|
||||
|
||||
**Coût** : **0€** (calcul automatique lors du traitement)
|
||||
|
||||
---
|
||||
|
||||
### 19.3 Statut "Utilisateur de confiance"
|
||||
|
||||
**Décision** : Statut automatique pour utilisateurs Badge Argent ou Or
|
||||
|
||||
**Critère** :
|
||||
- Badge **Argent OU Or** actif = automatiquement "Utilisateur de confiance"
|
||||
|
||||
**Avantages** :
|
||||
1. **Priorisation signalements** : traités avant signalements standards (même score IA)
|
||||
2. **Badge visible** : affichage "Utilisateur de confiance" sur profil public
|
||||
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
|
||||
|
||||
**Coût** : **0€** (simple flag booléen calculé automatiquement)
|
||||
|
||||
---
|
||||
|
||||
### 19.4 Réduction Premium pour badge Or
|
||||
|
||||
**Décision** : Seuls les utilisateurs **Contributeur Or** (top contributeurs) obtiennent une réduction Premium
|
||||
|
||||
#### 19.4.1 Conditions
|
||||
|
||||
| Critère | Valeur |
|
||||
|---------|--------|
|
||||
| **Montant** | **-50% pendant 3 mois** (2.49€/mois au lieu de 4.99€) |
|
||||
| **Éligibilité** | Badge Or actif + pas déjà Premium |
|
||||
| **Durée** | 3 mois à partir de l'activation |
|
||||
| **Renouvellement** | Prix normal (4.99€/mois) après 3 mois |
|
||||
| **Cumul** | Non cumulable avec offre annuelle |
|
||||
| **Délai activation** | 30 jours après obtention badge Or |
|
||||
|
||||
---
|
||||
|
||||
#### 19.4.2 Notification
|
||||
|
||||
**Email + Push + In-app** dès obtention badge Or :
|
||||
|
||||
```
|
||||
🎉 Exceptionnel ! Vous avez obtenu le badge Contributeur Or
|
||||
|
||||
Vous faites partie des meilleurs contributeurs de RoadWave.
|
||||
Grâce à votre engagement et votre vigilance, vous aidez
|
||||
des milliers d'utilisateurs à profiter d'une expérience
|
||||
audio de qualité.
|
||||
|
||||
La communauté vous remercie ! 🙏
|
||||
|
||||
En reconnaissance de votre aide précieuse, vous bénéficiez de :
|
||||
|
||||
✨ 3 mois d'abonnement Premium à -50%
|
||||
→ 2.49€/mois au lieu de 4.99€
|
||||
|
||||
[Profiter de l'offre]
|
||||
|
||||
Cette offre est valable pendant 30 jours.
|
||||
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)
|
||||
|
||||
---
|
||||
|
||||
#### 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
|
||||
|
||||
---
|
||||
|
||||
#### 19.4.4 ROI et justification
|
||||
|
||||
**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
|
||||
|
||||
---
|
||||
|
||||
### 19.5 Anti-abus
|
||||
|
||||
**CRITIQUE** : Système de protection contre les comportements abusifs
|
||||
|
||||
#### 19.5.1 Limite temporelle
|
||||
|
||||
**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€
|
||||
|
||||
---
|
||||
|
||||
#### 19.5.2 Détection patterns suspects
|
||||
|
||||
**Audit automatique hebdomadaire** :
|
||||
|
||||
```sql
|
||||
-- Détection signaleurs suspects
|
||||
SELECT user_id, COUNT(*) as total
|
||||
FROM reports
|
||||
WHERE created_at > NOW() - INTERVAL '7 days'
|
||||
GROUP BY user_id
|
||||
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
|
||||
- Signalements ciblant toujours même créateur (harcèlement)
|
||||
|
||||
---
|
||||
|
||||
#### 19.5.3 Audit trimestriel automatique
|
||||
|
||||
**Décision** : Tous les 3 mois, recalcul badges et révocation si critères non respectés
|
||||
|
||||
**Processus** :
|
||||
1. Recalcul taux pertinence sur période glissante 6 mois
|
||||
2. Vérification critères :
|
||||
- Bronze : minimum 70% pertinence
|
||||
- Argent : minimum 80% pertinence
|
||||
- Or : minimum 90% pertinence
|
||||
3. Révocation badge si taux insuffisant
|
||||
4. Email notification **7 jours avant audit** :
|
||||
```
|
||||
Votre badge Contributeur Argent sera audité dans 7 jours.
|
||||
Taux de pertinence actuel : 78%
|
||||
Minimum requis : 80%
|
||||
|
||||
Continuez à signaler du contenu pertinent pour conserver votre badge !
|
||||
```
|
||||
|
||||
**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)
|
||||
|
||||
---
|
||||
|
||||
#### 19.5.4 Sanctions abus détecté
|
||||
|
||||
| Gravité | Abus détecté | Sanction |
|
||||
|---------|--------------|----------|
|
||||
| **Mineur** | >10 signalements/jour pendant 1 jour | Avertissement + limite 5/jour pendant 7 jours |
|
||||
| **Modéré** | >30 signalements/semaine avec <50% pertinence | Révocation badge + interdiction signalement 30 jours |
|
||||
| **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
|
||||
- **Pas de recours** pour sanctions graves (farming confirmé)
|
||||
|
||||
---
|
||||
|
||||
## Récapitulatif Section 19
|
||||
|
||||
| Point | Décision | Coût |
|
||||
|-------|----------|------|
|
||||
| **Badges (3 niveaux)** | Bronze (5), Argent (20), Or (50) signalements validés | 0€ |
|
||||
| **Modal découverte** | Affichage unique au 1er signalement | 0€ |
|
||||
| **Score fiabilité** | Calcul automatique pour priorisation | 0€ |
|
||||
| **Utilisateurs de confiance** | Statut auto Argent/Or | 0€ |
|
||||
| **Réduction Premium Or** | -50% pendant 3 mois (Post-MVP) | 0-200€/mois |
|
||||
| **Limite temporelle** | Max 10 signalements/24h | 0€ |
|
||||
| **Audit trimestriel** | Révocation si critères non respectés | 0€ |
|
||||
| **Sanctions abus** | Mineur/Modéré/Grave selon pattern | 0€ |
|
||||
|
||||
**Coût total MVP** : **0€**
|
||||
|
||||
**Coût total Post-MVP** : **0-200€/mois** (réductions Premium Or)
|
||||
|
||||
**ROI** : **Positif dès 2-3 utilisateurs Or actifs** (économie modération > coût réductions)
|
||||
|
||||
---
|
||||
|
||||
**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)
|
||||
|
||||
---
|
||||
|
||||
**Prochaine section à clarifier** : Section 20 (si nécessaire) ou validation complète règles métier
|
||||
393
docs/domains/moderation/rules/moderation-flows.md
Normal file
393
docs/domains/moderation/rules/moderation-flows.md
Normal file
@@ -0,0 +1,393 @@
|
||||
## 14. Modération - Flows opérationnels
|
||||
|
||||
### 14.1 Signalement
|
||||
|
||||
**Décision** : Formulaire simple avec 7 catégories prédéfinies
|
||||
|
||||
#### 14.1.1 Catégories de signalement
|
||||
|
||||
Liste déroulante avec 7 options :
|
||||
|
||||
| Catégorie | Description |
|
||||
|-----------|-------------|
|
||||
| 🚫 **Haine & violence** | Incitation à la haine, discrimination, menaces |
|
||||
| 🔞 **Contenu sexuel** | Pornographie, contenu explicite |
|
||||
| ⚖️ **Illégalité** | Terrorisme, apologie de crimes |
|
||||
| 🎵 **Droits d'auteur** | Musique/contenu protégé non autorisé (voir [Section 18](18-detection-contenu-protege.md) pour règles détaillées) |
|
||||
| 📧 **Spam** | Publicité non sollicitée, répétition |
|
||||
| ❌ **Fausse information** | Désinformation sur santé, sécurité routière |
|
||||
| 🔧 **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)
|
||||
|
||||
---
|
||||
|
||||
#### 14.1.2 Commentaire du signaleur
|
||||
|
||||
**Décision** : Optionnel avec incitation
|
||||
|
||||
- Champ texte libre (0-500 caractères)
|
||||
- Placeholder : "Décrivez le problème (optionnel mais recommandé)"
|
||||
- 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
|
||||
|
||||
---
|
||||
|
||||
#### 14.1.3 Confirmation après signalement
|
||||
|
||||
**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
|
||||
|
||||
---
|
||||
|
||||
### 14.2 Traitement des signalements
|
||||
|
||||
#### 14.2.1 IA pré-filtre (transcription + analyse)
|
||||
|
||||
**Décision** : OpenAI Whisper open source + NLP
|
||||
|
||||
**Stack technique** :
|
||||
|
||||
| Composant | Technologie | Hébergement |
|
||||
|-----------|-------------|-------------|
|
||||
| **Transcription** | Whisper large-v3 | Self-hosted (CPU MVP, GPU scale) |
|
||||
| **Analyse sentiment** | distilbert-base-uncased | Self-hosted |
|
||||
| **Détection haine** | facebook/roberta-hate-speech | Self-hosted |
|
||||
| **Mots-clés** | Liste noire FR/EN + regex | PostgreSQL |
|
||||
|
||||
**Processus** :
|
||||
1. Signalement reçu → ajout file d'attente asynchrone
|
||||
2. Transcription audio (1-10 minutes selon durée)
|
||||
3. Analyse automatique :
|
||||
- Score de confiance : 0-100%
|
||||
- Catégorie détectée
|
||||
- Timestamps des passages problématiques
|
||||
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
|
||||
|
||||
---
|
||||
|
||||
#### 14.2.2 Délais de traitement (SLA)
|
||||
|
||||
**Décision** : SLA progressif selon priorité
|
||||
|
||||
| Priorité | Délai cible | Traitement |
|
||||
|----------|-------------|------------|
|
||||
| **CRITIQUE** | <2h (24/7) | Violence, suicide, mise en danger → Astreinte modérateur senior |
|
||||
| **HAUTE** | <24h (jours ouvrés) | Haine, harcèlement, désinformation → Modérateur junior/senior |
|
||||
| **MOYENNE** | <24h (jours ouvrés) | Spam, contenu inapproprié → Modérateur junior |
|
||||
| **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
|
||||
|
||||
---
|
||||
|
||||
#### 14.2.3 Priorisation automatique
|
||||
|
||||
**Décision** : File d'attente intelligente basée sur score IA
|
||||
|
||||
**Calcul de priorité** :
|
||||
|
||||
```
|
||||
Priorité = (Score_IA × 0.7) + (Signalements_cumulés × 0.2) + (Fiabilité_signaleur × 0.1)
|
||||
```
|
||||
|
||||
**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)
|
||||
|
||||
---
|
||||
|
||||
### 14.3 Sanctions
|
||||
|
||||
#### 14.3.1 Notification au créateur
|
||||
|
||||
**Décision** : Multi-canal (email + push + in-app)
|
||||
|
||||
**Canaux utilisés** :
|
||||
|
||||
| Canal | Timing | Contenu |
|
||||
|-------|--------|---------|
|
||||
| **Push notification** | Immédiat | Alerte courte : "Votre contenu a été modéré" |
|
||||
| **In-app** | Au prochain lancement | Popup détaillée avec bouton "Voir détails" |
|
||||
| **Email** | Dans l'heure | Notification complète avec lien vers formulaire d'appel |
|
||||
|
||||
**Contenu email** :
|
||||
```
|
||||
Objet : Modération de votre contenu "[Titre du contenu]"
|
||||
|
||||
Bonjour [Pseudo],
|
||||
|
||||
Votre contenu "[Titre]" publié le [Date] a été modéré.
|
||||
|
||||
Catégorie violée : [Catégorie]
|
||||
Raison : [Explication détaillée]
|
||||
Sanction : [Strike X / Suspension X jours / Suppression contenu]
|
||||
|
||||
Extrait audio concerné : [Timestamp]
|
||||
Transcription : "[Passage problématique surligné]"
|
||||
|
||||
Vous pouvez contester cette décision sous 7 jours :
|
||||
[Lien formulaire d'appel]
|
||||
|
||||
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
|
||||
|
||||
---
|
||||
|
||||
#### 14.3.2 Détail de la sanction
|
||||
|
||||
**Décision** : Notification complète avec preuves
|
||||
|
||||
**Éléments inclus obligatoirement** :
|
||||
|
||||
1. **Catégorie violée** : référence précise CGU (ex: "Article 3.2 - Haine & violence")
|
||||
2. **Raison détaillée** : explication en langage clair (non juridique)
|
||||
3. **Extrait audio** : timestamp exact du passage problématique (ex: "3:42-4:15")
|
||||
4. **Transcription** : texte problématique surligné en rouge
|
||||
5. **Gravité** : Strike actuel + conséquences (ex: "Strike 2/4 - Suspension 7 jours")
|
||||
6. **Recours** : lien direct vers formulaire d'appel + délai (7 jours)
|
||||
|
||||
**Exemple visuel in-app** :
|
||||
```
|
||||
┌─────────────────────────────────────┐
|
||||
│ ⚠️ Contenu modéré │
|
||||
├─────────────────────────────────────┤
|
||||
│ Titre : "Mon podcast #42" │
|
||||
│ Publié le : 15/01/2026 │
|
||||
│ │
|
||||
│ Catégorie violée : │
|
||||
│ 🚫 Haine & violence (Article 3.2) │
|
||||
│ │
|
||||
│ Passage problématique : 3:42-4:15 │
|
||||
│ "[Transcription surlignée]" │
|
||||
│ │
|
||||
│ Sanction : Strike 2/4 │
|
||||
│ Suspension : 7 jours │
|
||||
│ │
|
||||
│ [Contester cette décision] │
|
||||
└─────────────────────────────────────┘
|
||||
```
|
||||
|
||||
**Justification** :
|
||||
- Transparence maximale (obligation DSA)
|
||||
- Créateur comprend l'erreur → amélioration future
|
||||
- Réduit les appels non fondés
|
||||
|
||||
---
|
||||
|
||||
#### 14.3.3 Processus d'appel
|
||||
|
||||
**Décision** : Formulaire in-app structuré
|
||||
|
||||
**Accès** :
|
||||
- Bouton "Contester cette décision" dans notification
|
||||
- Section "Mes sanctions" dans profil créateur
|
||||
|
||||
**Formulaire d'appel** :
|
||||
|
||||
| Champ | Type | Obligatoire |
|
||||
|-------|------|-------------|
|
||||
| **Sanction contestée** | Pré-rempli (non modifiable) | ✅ |
|
||||
| **Raison de l'appel** | Texte libre (50-1000 caractères) | ✅ |
|
||||
| **Arguments** | Zone texte enrichie | ✅ |
|
||||
| **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)
|
||||
|
||||
---
|
||||
|
||||
#### 14.3.4 Délai de réponse pour appel
|
||||
|
||||
**Décision** : SLA 72h garanti
|
||||
|
||||
**Délais** :
|
||||
|
||||
| Type d'appel | Délai | Responsable |
|
||||
|--------------|-------|-------------|
|
||||
| **Standard** | 72h max (3 jours ouvrés) | Modérateur senior |
|
||||
| **Complexe** | 5 jours ouvrés + notification intermédiaire J+3 | Modérateur senior + Admin modération |
|
||||
| **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** :
|
||||
|
||||
Email détaillé avec :
|
||||
1. **Décision** : Maintien / Annulation / Réduction de sanction
|
||||
2. **Justification** : explication de la décision d'appel
|
||||
3. **Actions** : Strike retiré / Suspension annulée / Contenu rétabli (si applicable)
|
||||
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
|
||||
|
||||
---
|
||||
|
||||
### 14.4 Outils modérateurs
|
||||
|
||||
**Stack technique complète** :
|
||||
|
||||
| Outil | Technologie | Fonction |
|
||||
|-------|-------------|----------|
|
||||
| **Dashboard** | React + TanStack Table | Interface modération |
|
||||
| **File signalements** | PostgreSQL + Redis | Priorisation temps réel |
|
||||
| **Player audio** | Wavesurfer.js | Lecture avec waveform + annotations |
|
||||
| **Transcription** | Whisper large-v3 | Conversion audio → texte |
|
||||
| **Historique créateur** | Vue 360° | Contenus, strikes, appels, métriques |
|
||||
| **Actions rapides** | Shortcuts clavier | Approuver (A), Rejeter (R), Escalade (E) |
|
||||
| **Logs audit** | PostgreSQL + export | Traçabilité complète (DSA) |
|
||||
| **Collaboration** | Système de commentaires | Modérateurs peuvent s'entraider sur cas complexes |
|
||||
|
||||
**Fonctionnalités clés** :
|
||||
|
||||
1. **Lecture accélérée** : 0.75x à 2x (gain productivité)
|
||||
2. **Marqueurs temporels** : annotation directe sur waveform
|
||||
3. **Historique créateur** : vue rapide contenus précédents + strikes
|
||||
4. **Statistiques** : signalements traités/jour, temps moyen, précision
|
||||
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)
|
||||
|
||||
---
|
||||
|
||||
### 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
|
||||
|
||||
---
|
||||
|
||||
## Récapitulatif Section 14
|
||||
|
||||
| Point | Décision | Coût |
|
||||
|-------|----------|------|
|
||||
| **Catégories signalement** | 7 catégories prédéfinies + champ libre | 0€ |
|
||||
| **Commentaire signaleur** | Optionnel avec incitation | 0€ |
|
||||
| **Confirmation** | Toast in-app + historique personnel | 0€ |
|
||||
| **IA pré-filtre** | Whisper (CPU MVP, GPU scale) + NLP open source | 0-200€/mois |
|
||||
| **Délais traitement** | SLA progressif : 2h/24h/72h selon priorité | Dépend équipe |
|
||||
| **Priorisation** | File intelligente basée score IA | 0€ |
|
||||
| **Notification sanction** | Email + push + in-app (multi-canal) | ~0.001€/notif |
|
||||
| **Détail sanction** | Complet : raison + extrait + transcription | 0€ |
|
||||
| **Processus appel** | Formulaire in-app structuré | 0€ |
|
||||
| **Délai appel** | 72h garanti (standard) | Dépend équipe |
|
||||
| **Outils modérateurs** | Dashboard React + Whisper + Wavesurfer.js | 0-200€/mois |
|
||||
|
||||
**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
|
||||
|
||||
---
|
||||
|
||||
**🎯 Modération communautaire** : Voir [Section 19](19-moderation-communautaire.md) pour le système complet de badges, récompenses et priorisation des signalements pertinents.
|
||||
|
||||
---
|
||||
|
||||
**Section suivante** : [Section 19 - Modération Communautaire](19-moderation-communautaire.md)
|
||||
Reference in New Issue
Block a user