Files
roadwave/docs/domains/recommendation/README.md
jpgiannetti 35aaa105d0 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.
2026-02-09 20:49:52 +01:00

47 lines
1.8 KiB
Markdown

# Domaine : Recommendation
## Vue d'ensemble
Le domaine **Recommendation** gère le système de recommandation de contenus basé sur la géolocalisation et les centres d'intérêt des utilisateurs. C'est un **Supporting Subdomain** clé qui différencie RoadWave des autres plateformes audio.
## Responsabilités
- **Jauges de centres d'intérêt** : Gestion et évolution dynamique des préférences utilisateurs
- **Algorithme de recommandation** : Scoring et classement des contenus pertinents
- **Interactions et navigation** : Adaptation des recommandations selon le comportement utilisateur
## Règles métier
- [Centres d'intérêt et jauges](rules/centres-interet-jauges.md)
- [Algorithme de recommandation](rules/algorithme-recommandation.md)
- [Interactions et navigation](rules/interactions-navigation.md)
## Modèle de données
- [Diagramme entités recommandation](entities/modele-recommandation.md) - Entités : USER_INTERESTS, INTEREST_CATEGORIES
## Diagrammes
- [Séquence : Scoring et recommandation]((à créer)) *(à créer si existant)*
## Tests BDD
- Features de recommandation *(voir Phase 6)*
## Ubiquitous Language
**Termes métier du domaine** :
- **Interest Gauge** : Jauge de centre d'intérêt (score de 0 à 100)
- **Interest Category** : Catégorie d'intérêt (automobile, voyage, musique, etc.)
- **Recommendation Score** : Score combinant distance géographique et affinité d'intérêt
- **Content Scoring** : Algorithme de calcul du score de pertinence
- **Geographic Priority** : Priorisation GPS > Ville > Département > Région > Pays
- **Interest Decay** : Diminution progressive de la jauge sans interaction
## Dépendances
- ✅ Dépend de : `_shared` (users, contents)
- ✅ Dépend de : `content` (métadonnées de contenus)
- ⚠️ Utilisé par : interface mobile, API publique