From fa6ba438888205c1185b1c5acf28845051bc2069 Mon Sep 17 00:00:00 2001 From: jpgiannetti Date: Sun, 1 Feb 2026 15:34:53 +0100 Subject: [PATCH] =?UTF-8?q?docs:=20marquer=20formule=20algorithme=20comme?= =?UTF-8?q?=20r=C3=A9solue?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- INCONSISTENCIES.md | 51 ++++++++-------------------------------------- 1 file changed, 8 insertions(+), 43 deletions(-) diff --git a/INCONSISTENCIES.md b/INCONSISTENCIES.md index f39c114..98640c3 100644 --- a/INCONSISTENCIES.md +++ b/INCONSISTENCIES.md @@ -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% ---