docs: marquer formule algorithme comme résolue
Mise à jour INCONSISTENCIES.md : - Déplacer "Formule algorithme recommandation" vers "Corrigées" - Incohérences critiques restantes : 2 → 1 (seule ADR-002 reste) - Score global : 78% → 80% - Progression P0 : 3/5 → 4/5 (80%) Plus qu'une incohérence P0 à corriger avant démarrage coding. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -12,6 +12,7 @@ Ce document liste les incohérences et manques critiques identifiés dans la doc
|
||||
|
||||
- **✅ Références ADR dans CLAUDE.md** : Décalage -2 corrigé (commit `c3abdd7`)
|
||||
- **✅ Geofencing MVP vs Phase 2** : ADR-020 clarifié avec séparation Phase 1/Phase 2 (commit `69a7bd8`)
|
||||
- **✅ Formule algorithme recommandation** : Section détaillée ajoutée dans Règle 04 avec exemple concret (commit `cf26d8a`)
|
||||
|
||||
---
|
||||
|
||||
@@ -40,44 +41,7 @@ Ce document liste les incohérences et manques critiques identifiés dans la doc
|
||||
|
||||
## 🔴 Incohérences critiques restantes
|
||||
|
||||
### 1. Algorithme de recommandation : Formule imprécise
|
||||
|
||||
**Problème** : [Règle 04](docs/regles-metier/04-algorithme-recommandation.md):37
|
||||
```
|
||||
score_interets = moyenne des jauges utilisateur pour les tags du contenu
|
||||
```
|
||||
|
||||
**Incohérences** :
|
||||
- Les jauges sont stockées en pourcentage [0-100]
|
||||
- Le score final doit être [0-1] pour la pondération
|
||||
- Formule exacte manquante : `SUM(gauges) / NB_TAGS / 100` ?
|
||||
- Aucun exemple concret avec nombres réels
|
||||
|
||||
**Impact** : L'équipe backend ne saura pas comment implémenter le scoring exact.
|
||||
|
||||
**Action requise** :
|
||||
```markdown
|
||||
## 2.2 Calcul score_interets (à ajouter dans Règle 04)
|
||||
|
||||
**Formule exacte** :
|
||||
score_interets ∈ [0.0, 1.0] = (SUM(gauge_values) / NB_TAGS) / 100
|
||||
|
||||
**Exemple concret** :
|
||||
Contenu : tags ["Musique", "Tourisme"]
|
||||
Utilisateur : jauge Musique = 75%, jauge Tourisme = 60%
|
||||
|
||||
score_interets = ((75 + 60) / 2) / 100 = 67.5 / 100 = 0.675
|
||||
|
||||
**Impact dans le scoring final** :
|
||||
score_final = 0.5 * score_geo + 0.3 * score_interets + 0.2 * score_engagement
|
||||
= 0.5 * 0.8 + 0.3 * 0.675 + 0.2 * 0.5
|
||||
= 0.4 + 0.2025 + 0.1
|
||||
= 0.7025 / 1.0
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2. Référence cassée dans ADR-002
|
||||
### 1. Référence cassée dans ADR-002
|
||||
|
||||
**Problème** : [ADR-002](docs/adr/002-protocole-streaming.md):180
|
||||
```
|
||||
@@ -252,7 +216,7 @@ Contenu suggéré :
|
||||
| **Scaling** | 40% | ⚠️ Minimal | **ADR-027 recommandé** |
|
||||
| **Testing** | 85% | ✅ Bon | - |
|
||||
|
||||
**Score global** : **78%** (après corrections + acceptation Firebase, était 75%)
|
||||
**Score global** : **80%** (après corrections + formule algorithme, était 78%)
|
||||
|
||||
---
|
||||
|
||||
@@ -263,9 +227,10 @@ Contenu suggéré :
|
||||
1. **✅ FAIT** : Corriger références ADR dans CLAUDE.md
|
||||
2. **✅ FAIT** : Clarifier geofencing Phase 1/Phase 2 dans ADR-020
|
||||
3. **✅ FAIT** : Accepter incohérence Firebase pour MVP (terminaux Android contrôlés)
|
||||
4. **🔴 TODO** : Préciser formule algorithme recommandation (Règle 04)
|
||||
- Ajouter section "2.2 Calcul score_interets" avec exemple chiffré
|
||||
4. **✅ FAIT** : Préciser formule algorithme recommandation (Règle 04)
|
||||
- Section "Calcul détaillé score_interets" ajoutée avec exemple concret
|
||||
- Domaine jauges : 0-100, score final : 0-1
|
||||
- Cas limites documentés
|
||||
5. **🔴 TODO** : Corriger référence cassée ADR-002 (Section 5.2 → 5.1)
|
||||
|
||||
### P1 - Important design (avant Sprint 3-4)
|
||||
@@ -302,9 +267,9 @@ Contenu suggéré :
|
||||
**Deadline recommandée** : 2 semaines avant démarrage développement backend/mobile
|
||||
|
||||
**Statut actuel** :
|
||||
- Incohérences P0 résolues : 3/5 (60%)
|
||||
- Incohérences P0 résolues : 4/5 (80%)
|
||||
- ADR manquants P1 : 0/3 (0%)
|
||||
- Score global : 78% → objectif 95%
|
||||
- Score global : 80% → objectif 95%
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user