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
2026-02-07 17:15:02 +01:00
parent 78422bb2c0
commit 5e5fcf4714
227 changed files with 1413 additions and 1967 deletions

View File

@@ -0,0 +1,76 @@
# language: fr
@api @moderation @gamification @mvp
Fonctionnalité: Système de badges de modération
En tant qu'utilisateur modérateur
Je veux gagner des badges pour ma contribution
Afin d'être reconnu et motivé à modérer
Scénario: Badge Bronze - 10 signalements validés
Étant donné un utilisateur "alice@roadwave.fr" qui a 10 signalements validés
Quand le 10ème signalement est confirmé
Alors le badge "Modérateur Bronze" est débloqué
Et affiché sur son profil
Et +50 points de réputation
Et un événement "BADGE_BRONZE_MODERATOR_UNLOCKED" est enregistré
Scénario: Badge Argent - 50 signalements validés
Étant donné un utilisateur avec 50 signalements validés
Alors le badge "Modérateur Argent" est débloqué
Et il obtient des privilèges supplémentaires
Et +200 points de réputation
Et un événement "BADGE_SILVER_MODERATOR_UNLOCKED" est enregistré
Scénario: Badge Or - 200 signalements validés
Étant donné un utilisateur avec 200 signalements validés
Alors le badge "Modérateur Or" est débloqué
Et il devient "Utilisateur de confiance"
Et ses signalements sont traités en priorité
Et +500 points de réputation
Et un événement "BADGE_GOLD_MODERATOR_UNLOCKED" est enregistré
Scénario: Badge Diamant - 1000 signalements + 95% de précision
Étant donné un utilisateur avec 1000 signalements validés
Et un taux de précision > 95%
Alors le badge "Modérateur Diamant" est débloqué
Et il peut devenir modérateur officiel
Et +2000 points de réputation
Et un événement "BADGE_DIAMOND_MODERATOR_UNLOCKED" est enregistré
Scénario: Perte de badge si précision < 70%
Étant donné un utilisateur avec badge Silver
Quand son taux de précision tombe < 70%
Alors le badge est révoqué temporairement
Et il doit retrouver 80% de précision pour le récupérer
Et un événement "BADGE_REVOKED_LOW_ACCURACY" est enregistré
Scénario: Badges spéciaux pour expertise
Étant donné un utilisateur spécialisé
Alors il peut obtenir des badges thématiques:
| Badge | Condition |
| Expert droits d'auteur | 100 signalements copyright validés|
| Expert contenu offensant | 100 signalements haine validés |
| Expert spam | 100 signalements spam validés |
Et un événement "EXPERT_BADGE_UNLOCKED" est enregistré
Scénario: Classement des meilleurs modérateurs
Étant donné tous les utilisateurs modérateurs
Alors un leaderboard est affiché:
| Rang | Utilisateur | Signalements | Précision | Badge |
| 1 | alice | 1,234 | 98% | Diamant |
| 2 | bob | 876 | 96% | Or |
| 3 | charlie | 543 | 94% | Or |
Et le top 10 reçoit des récompenses mensuelles
Et un événement "MODERATOR_LEADERBOARD_VIEWED" est enregistré
Scénario: Récompenses mensuelles pour top modérateurs
Étant donné le top 10 du mois
Quand le mois se termine
Alors chacun reçoit:
| Rang | Récompense |
| 1-3 | 6 mois Premium gratuit |
| 4-6 | 3 mois Premium gratuit |
| 7-10 | 1 mois Premium gratuit |
Et un badge "Top modérateur du mois"
Et un événement "MONTHLY_MODERATOR_REWARDS_DISTRIBUTED" est enregistré