jpgiannetti
158690ed3e
feat(auth): aligner Gherkins d'authentification avec ADR-008 et règles métier
...
- Corriger règle 1.4 : appliquer logique standard de classification par âge
(13-15 ans: Tout public + 13+, 16-17 ans: + 16+, 18+: tous)
- Mettre à jour classification-age.feature avec nouvelles règles de diffusion
- Mettre à jour inscription.feature pour cohérence avec classification
- Ajouter gestion-compte.feature avec 28 scénarios (déconnexion, changement
mot de passe, changement email, changement pseudo, consultation compte)
2026-02-01 21:06:29 +01:00
jpgiannetti
59a6d49fbb
docs(CLAUDE.md): ajouter règle pour ne pas mettre Claude en co-auteur
...
Ajout d'une section règles importantes pour spécifier de ne jamais
ajouter "Co-Authored-By: Claude" dans les messages de commit.
Les commits doivent rester propres et professionnels sans attribution IA.
2026-02-01 20:06:18 +01:00
jpgiannetti
ec28b52ae5
refactor(adr-024): utiliser Telegram au lieu de Slack/Discord pour alerting
...
Remplacement de tous les canaux Slack/Discord par Telegram Bot :
- Table stack technique : Webhook Slack/Discord → Telegram Bot
- Diagramme Mermaid : mise à jour nodes et connexions
- Alternatives considérées : ligne tableau mise à jour
- Conséquences : mentions Slack/Discord → Telegram
- Alerting rules : Slack + Email → Telegram + Email
Justification :
- Coût : 0€ (identique)
- Disponibilité : temps réel (identique)
- Intrusivité : moyenne (identique)
- Avantage : API Telegram plus simple et plus flexible
INCONSISTENCIES.md mis à jour en conséquence.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-01 20:05:03 +01:00
jpgiannetti
78b723baa3
fix(adr-023/024/025): restaurer diagrammes Mermaid
...
Les diagrammes Mermaid sont utiles pour visualiser l'architecture
et ne posent pas de problème de doublon code/doc.
Restauration des 3 diagrammes :
- ADR-023 : Flux modération (Client → API → Worker → IA → Dashboard)
- ADR-024 : Stack monitoring (Services → Prometheus/Grafana → Alerting)
- ADR-025 : Architecture secrets (Dev/Prod → Vault → Encryption)
Code textuel (SQL, bash, Go, YAML) reste retiré comme demandé.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-01 17:55:58 +01:00
jpgiannetti
81ccbf79e6
refactor(adr-023/024/025): retirer exemples de code et scripts
...
Suppression de tous les exemples de code pour garder uniquement
les descriptions techniques :
ADR-023 (Architecture Modération) :
- Diagramme Mermaid → description flux textuelle
- Exemples SQL/Redis → description workflow
- Interface Go → description abstraction
- Dépendances → liste concise
ADR-024 (Monitoring et Observabilité) :
- Diagramme Mermaid → architecture textuelle
- Exemples PromQL → description métriques
- Config YAML alertes → liste alertes avec seuils
- Commandes bash WAL-E → description backup
- Runbooks → étapes sans commandes
ADR-025 (Sécurité et Secrets) :
- Diagramme Mermaid → flux secrets textuel
- Commandes bash Vault → description process
- Code Go encryption → architecture encryption
- Schéma SQL → contraintes textuelles
- Config Nginx → configuration TLS
- Code Go rate limiting → paramètres middleware
ADR restent 100% techniques et complets sans code concret.
Cohérence avec ADR-022 (même approche).
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-01 17:12:07 +01:00
jpgiannetti
60dce59905
refactor(adr-022): retirer exemples de code et scripts
...
Suppression de tous les exemples de code pour garder uniquement
les descriptions techniques :
- Workflows backend/mobile/shared : descriptions textuelles
au lieu de blocs YAML complets
- Section validation : scénarios décrits au lieu de commandes bash
- Conservation de toute l'information technique sans code concret
ADR reste technique et complet mais plus concis.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-01 16:51:01 +01:00
jpgiannetti
5986286c3d
feat(adr): créer 3 ADR P1 manquants + atteindre score 95%
...
Création des ADR critiques pour phase pré-implémentation :
- ADR-023 : Architecture de Modération
* PostgreSQL LISTEN/NOTIFY + Redis cache priorisation
* Whisper large-v3 (transcription) + NLP (distilbert, roberta)
* Dashboard React + Wavesurfer.js + workflow automatisé
* SLA 2h/24h/72h selon priorité, conformité DSA
- ADR-024 : Monitoring et Observabilité
* Prometheus + Grafana + Loki (stack self-hosted)
* Alerting multi-canal : Email (Brevo) + Webhook (Slack/Discord)
* Backup PostgreSQL : WAL-E continuous (RTO 1h, RPO 15min)
* Runbooks incidents + dashboards métriques + uptime monitoring
- ADR-025 : Secrets et Sécurité
* HashiCorp Vault (self-hosted) pour secrets management
* AES-256-GCM encryption PII (emails, GPS précis)
* Let's Encrypt TLS 1.3 (wildcard certificate)
* OWASP Top 10 mitigation complète + rate limiting
Impact INCONSISTENCIES.md :
- Score Modération : 20% → 95%
- Score Ops & Monitoring : 30% → 95%
- Score Sécurité : 40% → 95%
- Score global : 82% → 95% ✅ OBJECTIF ATTEINT
Phase P0 + P1 TERMINÉES : documentation prête pour Sprint 3 !
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-01 16:44:21 +01:00
jpgiannetti
9bb1891bc1
docs: 🎉 100% des incohérences P0 résolues !
...
Mise à jour INCONSISTENCIES.md :
- Marquer référence ADR-002 comme corrigée
- Section "Incohérences critiques restantes" → "TOUTES RÉSOLUES !"
- Score global : 80% → 82%
- Progression P0 : 4/5 → 5/5 (100%)
🎉 MILESTONE : Toutes les incohérences P0 sont corrigées !
Récapitulatif des corrections P0 :
1. ✅ Références ADR dans CLAUDE.md (commit c3abdd7✅ Geofencing Phase 1/Phase 2 (commit 69a7bd8✅ Firebase accepté pour MVP (commit 0609f38✅ Formule algorithme précisée (commit cf26d8a✅ Référence ADR-002 corrigée (commit 18c8901noreply@anthropic.com >
2026-02-01 15:39:14 +01:00
jpgiannetti
18c8901d69
docs(adr): corriger référence cassée ADR-002
...
Correction référence Règle Métier 05 :
- Avant : "Section 5.2 (Mode Voiture, lignes 16-84)"
- Après : "Section 5.1 (File d'attente et commande Suivant)"
Raison : La Règle 05 ne contient pas de Section 5.2.
La structure réelle est Section 5.1 pour la file d'attente.
Résout dernière incohérence P0 (INCONSISTENCIES.md item 5).
100% des incohérences P0 maintenant corrigées !
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-01 15:37:47 +01:00
jpgiannetti
fa6ba43888
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 >
2026-02-01 15:34:53 +01:00
jpgiannetti
cf26d8a244
docs(regles-metier): préciser formule algorithme recommandation
...
Ajout section détaillée "Calcul score_interets" dans Règle 04:
- Domaine jauges : [0-100] (stockage en pourcentage)
- score_interets : [0.0-1.0] (normalisé pour pondération)
- Formule exacte : (SUM(gauges) / NB_TAGS) / 100
Exemple concret avec nombres :
- Tags ["Musique", "Tourisme"]
- Jauges utilisateur 75% et 60%
- score_interets = 0.675
- Impact dans score_final démontré
Cas limites documentés :
- Aucune jauge → valeur neutre 0.5
- 1 seul tag → gauge_value / 100
- Moyenne arithmétique simple (pas de pondération par tag)
Résout incohérence #1 (INCONSISTENCIES.md P0 item 4).
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-01 15:33:49 +01:00
jpgiannetti
0609f380ff
docs: accepter incohérence Firebase pour MVP
...
Modifications INCONSISTENCIES.md :
- Déplacer "Souveraineté Firebase" vers section "Acceptées pour MVP"
- Justification : terminaux Android équipés (environnement contrôlé)
- Firebase FCM gratuit et fiable pour phase initiale
- Réévaluation Phase 2 (≥20K users) pour solution self-hosted
Impacts :
- Incohérences critiques restantes : 3 → 2
- Score global : 75% → 78%
- Plan P0 : 2/5 items restants (formule algorithme + ref ADR-002)
DPA Google reste à valider avant production publique.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-01 15:24:22 +01:00
jpgiannetti
a3b7c90be0
docs: ajouter document de suivi des incohérences
...
Création INCONSISTENCIES.md à la racine pour tracker :
- Incohérences critiques restantes (3)
- Manques importants identifiés (5)
- Plan d'action prioritaire (P0/P1/P2)
- Score de santé documentaire par domaine
Score actuel : 75% (cible : 95%)
Incohérences restantes critiques :
- Souveraineté Firebase vs self-hosted (documenté ADR-017)
- Formule algorithme recommandation imprécise (Règle 04)
- Référence cassée ADR-002 Section 5.2
Manques critiques (ADR à créer) :
- ADR-023 : Architecture de Modération
- ADR-024 : Monitoring et Ops
- ADR-025 : Secrets et Sécurité
- ADR-026 : Analytics et Events (P2)
- ADR-027 : Stratégie Scaling (P2)
Document de travail à maintenir hebdomadairement.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-01 15:18:31 +01:00
jpgiannetti
69a7bd80cc
docs(adr): clarifier geofencing Phase 2 dans ADR-020
...
Modifications ADR-020 (Librairies Flutter):
- Séparer packages MVP (Phase 1) vs Phase 2
- Déplacer geofence_service en Phase 2 (mode offline)
- Ajouter firebase_messaging en Phase 1 (manquant)
- Mettre à jour diagramme mermaid avec phases
- Ajouter note explicite renvoyant vers ADR-017
- Corriger compteur librairies (7/8 → 7/9)
Résout incohérence: geofence_service n'est PAS utilisé
en MVP. Phase 1 utilise WebSocket + Firebase FCM pour
notifications de proximité (voir ADR-017).
Phase 2 introduira geofencing local pour mode offline.
Refs: ADR-017 (Notifications Géolocalisées)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-01 15:15:44 +01:00
jpgiannetti
c3abdd74af
docs: corriger références ADR dans CLAUDE.md
...
Corrections des numéros d'ADR décalés :
- ADR-014 → ADR-012 (Frontend Mobile)
- ADR-016 → ADR-014 (Organisation Monorepo)
- ADR-012 → ADR-010 (Architecture Backend)
- ADR-013 → ADR-011 (ORM et Accès Données)
- ADR-015 → ADR-013 (Stratégie Tests)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-01 15:08:51 +01:00
jpgiannetti
852f6d5e16
refactor(docs): réorganiser ADR et règles métier pour clarté
...
**Changements majeurs** :
1. **Suppression ADR-010 (Commandes volant et likes)** :
- Contenu consolidé dans Règle 05 (section 5.3)
- Raison : ADR-010 était du métier déguisé en architecture
- Section "Implémentation Technique" ajoutée à Règle 05
- Pattern correct (addition) vs incorrect (multiplication)
2. **Déplacement ADR-011 → Compliance** :
- `docs/adr/011-conformite-stores.md` → `docs/compliance/stores-submission.md`
- Raison : Nature opérationnelle/légale, pas architecture technique
- Nouveau dossier `/docs/compliance/` créé
3. **Renumérotation ADR (010-022)** :
- Combler les trous de numérotation (010 et 011)
- ADR-012→010, ADR-013→011, ..., ADR-024→022
- 22 ADR numérotés en continu (001-022)
- Historique Git préservé (git mv)
4. **Mise à jour références** :
- Règle 03 : ADR-010 → Règle 05 (section 5.3)
- Règle 09 : ADR-010 → Règle 05 (section 5.3)
- INCONSISTENCIES-ANALYSIS.md : toutes références mises à jour
- Incohérence #15 annulée (faux problème : modes séparés)
**Résultat** :
- ✅ Séparation claire ADR (technique) vs Règles métier (fonctionnel)
- ✅ Documentation compliance séparée
- ✅ Numérotation ADR continue sans trous
- ✅ Single Source of Truth (pas de redondance)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-01 14:34:12 +01:00
jpgiannetti
b6b926b233
docs: résoudre incohérences #13 et #14 (emails + K8s)
...
Résolution de 2 incohérences MODERATE (reste 1/9) :
#13 - Emails techniques uniquement (ADR-018)
- Périmètre strict : auth, sécurité, modération, RGPD uniquement
- Pas de notifications sociales/marketing/newsletters
- Projection coûts : 93 emails/jour en MVP → gratuit
- Condensé : 112 → 75 lignes
#14 - Kubernetes roadmap clarifiée (ADR-001, ADR-017)
- ADR-001 : K8s = bonus scalabilité future, pas raison principale
- Go choisi pour simplicité, écosystème, performance
- ADR-017 : Roadmap 3 phases avec triggers métriques
- MVP (0-20K) : VPS + Docker Compose (~14€)
- Croissance (20-100K) : Scaleway managé (~100€)
- Scale (100K+) : Kubernetes (~500€)
- Condensé : 137 → 65 lignes
INCONSISTENCIES-ANALYSIS.md :
- 8/9 MODERATE traités (6 résolus, 1 annulé, 1 documenté)
- 1 MODERATE restant : #15 (Unlike Manuel)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-01 12:19:13 +01:00
jpgiannetti
37c62206ad
feat(bdd): réorganiser features en catégories api/ui/e2e et créer ADR-024
...
Résolution des incohérences #10 , #11 , et #12 de l'analyse d'architecture.
## Phase 1 : Réorganisation Features BDD (Point #10 - RÉSOLU)
- Créer structure features/{api,ui,e2e}
- Déplacer 83 features en 3 catégories via git mv (historique préservé)
- features/api/ : 53 features (tests API backend)
- features/ui/ : 22 features (tests UI mobile)
- features/e2e/ : 8 features (tests end-to-end)
Domaines déplacés :
- API : authentication, recommendation, rgpd-compliance, content-creation,
moderation, monetisation, premium, radio-live, publicites
- UI : audio-guides, navigation, interest-gauges, mode-offline,
partage, profil, recherche
- E2E : abonnements, error-handling
## Phase 2 : Mise à jour Documentation
### ADR-007 - Tests BDD
- Ajouter section "Convention de Catégorisation des Features"
- Documenter règles api/ui/e2e avec exemples concrets
- Spécifier step definitions (backend Go, mobile Dart)
### ADR-024 - Stratégie CI/CD Monorepo (NOUVEAU)
- Créer ADR dédié pour stratégie CI/CD avec path filters
- Architecture workflows séparés (backend.yml, mobile.yml, shared.yml)
- Configuration path filters détaillée avec exemples YAML
- Matrice de déclenchement et optimisations (~70% gain temps CI)
- Plan d'implémentation (~2h, reporté jusqu'au développement)
### ADR-016 - Organisation Monorepo
- Simplifier en retirant section CI/CD détaillée
- Ajouter référence vers ADR-024 pour stratégie CI/CD
### INCONSISTENCIES-ANALYSIS.md
- Point #10 (Tests BDD synchronisés) : ✅ RÉSOLU
- Catégorisation features implémentée
- ADR-007 mis à jour avec convention complète
- Point #11 (70/30 Split paiements) : ✅ ANNULÉ (faux problème)
- ADR-009 et Règle 18 parfaitement cohérents
- Documentation exhaustive existante (formule, SQL, comparaisons)
- Point #12 (Monorepo path filters) : ⏸️ DOCUMENTÉ
- Architecture CI/CD complète dans ADR-024
- Implémentation reportée (projet en phase documentation)
- Métriques mises à jour :
- MODERATE : 6/9 traités (4 résolus + 1 annulé + 1 documenté)
- ADR à jour : 100% (19/19 avec ADR-024)
## Phase 3 : Validation
- Structure features validée (api/ui/e2e, aucun répertoire restant)
- Historique Git préservé (git mv, renommages détectés)
- 83 features total (API: 53, UI: 22, E2E: 8)
Closes: Point #10 (résolu), Point #11 (annulé), Point #12 (documenté)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-01 11:31:41 +01:00
jpgiannetti
841028d1b2
(doc) : ajout et modification de docs après arbitrage
2026-01-31 21:09:59 +01:00
jpgiannetti
f99fb3c614
Initial commit
2026-01-31 11:45:11 +01:00
