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:
jpgiannetti
2026-02-01 15:34:53 +01:00
parent cf26d8a244
commit fa6ba43888

View File

@@ -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%
---