Files

jpgiannetti 5e5fcf4714 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.

2026-02-07 17:15:02 +01:00

2.1 KiB

Raw Blame History

Domaine : Moderation

Vue d'ensemble

Le domaine Moderation gère la modération des contenus et des utilisateurs, les signalements, les sanctions et le système de badges de confiance. C'est un Supporting Subdomain critique pour la qualité et la sécurité de la plateforme.

Responsabilités

Signalements : Workflow de traitement des signalements utilisateurs
Sanctions : Système de strikes et bannissements
Appels : Processus de contestation des sanctions
Badges de confiance : Attribution de badges aux créateurs fiables
Modération communautaire : Implication des utilisateurs dans la modération

Règles métier

Moderation flows - Workflows de modération
Modération communautaire
Autres comportements - Comportements sanctionnables

Modèle de données

Diagramme entités modération - Entités : REPORTS, SANCTIONS, APPEALS, STRIKES, BADGES

Diagrammes

Tests BDD

Features de modération (voir Phase 6)

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)
Appeal : Contestation d'une sanction par l'utilisateur
Trust Badge : Badge de confiance attribué aux créateurs fiables
Community Moderation : Modération participative par les utilisateurs
Moderator : Utilisateur avec droits de modération
Auto-Moderation : Modération automatique (IA, filtres)

Dépendances

✅ Dépend de : _shared (users, contents)
⚠️ Interactions avec : content (modération de contenus)
⚠️ Interactions avec : monetization (démonétisation en cas de sanction)

2.1 KiB Raw Blame History