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

1.5 KiB

Raw Blame History

Domaine : Monetization

Vue d'ensemble

Le domaine Monetization gère la monétisation des créateurs de contenu via les revenus publicitaires et les abonnements. C'est un Generic Subdomain qui implémente le modèle de partage de revenus.

Responsabilités

KYC (Know Your Customer) : Vérification d'identité des créateurs
Calcul des revenus : Agrégation des revenus par source (pub, abonnements)
Versements : Paiements mensuels via Mangopay
Tableaux de bord : Analytics de revenus pour créateurs

Règles métier

Monétisation des créateurs

Modèle de données

Diagramme entités monétisation - Entités : CREATOR_MONETIZATION, REVENUES, PAYOUTS

Ubiquitous Language

Termes métier du domaine :

Creator Monetization : Activation de la monétisation pour un créateur
KYC Verification : Vérification d'identité requise pour versements
Revenue Share : Partage de revenus (70% créateur / 30% plateforme)
Payout : Versement mensuel des revenus
Minimum Threshold : Seuil minimum de revenus pour déclencher un versement
Revenue Source : Source de revenu (ads, premium subscriptions)

Dépendances

✅ Dépend de : _shared (users en tant que créateurs)
✅ Dépend de : content (contenus monétisés)
✅ Dépend de : advertising (revenus publicitaires)
✅ Dépend de : premium (revenus abonnements)
⚠️ Interactions avec : système de paiement Mangopay (externe)

1.5 KiB Raw Blame History