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>
This commit is contained in:
jpgiannetti
@@ -29,20 +29,105 @@ RoadWave nécessite une documentation des use cases qui soit à la fois lisible
|
||||
|
||||
## Structure
|
||||
|
||||
Les features BDD sont organisées en **3 catégories** selon la couche testée :
|
||||
|
||||
```
|
||||
features/
|
||||
├── recommendation/
|
||||
│ ├── geolocalisation.feature
|
||||
│ └── interets.feature
|
||||
├── streaming/
|
||||
│ ├── lecture.feature
|
||||
│ └── buffering.feature
|
||||
├── moderation/
|
||||
│ └── signalement.feature
|
||||
└── steps/
|
||||
└── steps.go
|
||||
├── api/ # Tests de contrats API (Backend)
|
||||
│ ├── authentication/ # REST endpoints, validation email, 2FA
|
||||
│ ├── recommendation/ # Algorithm backend, scoring GPS
|
||||
│ ├── rgpd-compliance/ # GDPR API (delete, export, consent)
|
||||
│ ├── content-creation/ # Upload, encoding, validation API
|
||||
│ ├── moderation/ # Moderation workflow API
|
||||
│ ├── monetisation/ # Payments, KYC, payouts API
|
||||
│ ├── premium/ # Subscription API
|
||||
│ ├── radio-live/ # Live streaming backend
|
||||
│ └── publicites/ # Ads API, budget, metrics
|
||||
│
|
||||
├── ui/ # Tests d'interface utilisateur (Mobile)
|
||||
│ ├── audio-guides/ # Audio player UI, modes (piéton, vélo)
|
||||
│ ├── navigation/ # Steering wheel, voice commands, UI
|
||||
│ ├── interest-gauges/ # Gauge visualization, progression
|
||||
│ ├── mode-offline/ # Download UI, sync status
|
||||
│ ├── partage/ # Share dialog
|
||||
│ ├── profil/ # Creator profile screen
|
||||
│ └── recherche/ # Search bar, filters UI
|
||||
│
|
||||
└── e2e/ # Tests end-to-end (Backend + Mobile)
|
||||
├── abonnements/ # Full subscription flow (Mangopay + Zitadel + UI)
|
||||
└── error-handling/ # Network errors, GPS disabled (backend + mobile)
|
||||
```
|
||||
|
||||
### Convention de Catégorisation
|
||||
|
||||
#### `/features/api/` - Tests de contrats API (Backend)
|
||||
|
||||
**Objectif** : Tester les endpoints REST (requêtes HTTP, codes de statut, validation)
|
||||
|
||||
**Exécuté par** : Backend (Godog + step definitions Go dans `/backend/tests/bdd/`)
|
||||
|
||||
**Exemples de scénarios** :
|
||||
- `POST /api/v1/auth/register` avec email invalide → retourne 400
|
||||
- `GET /api/v1/contents/nearby` avec rayon 500m → retourne POI triés par distance
|
||||
- `DELETE /api/v1/user/account` → supprime données RGPD conformément
|
||||
|
||||
**Caractéristiques** :
|
||||
- Focus sur la **logique métier backend** (algorithme, validation, persistance)
|
||||
- Pas d'interface utilisateur
|
||||
- Testable via requêtes HTTP directes
|
||||
|
||||
---
|
||||
|
||||
#### `/features/ui/` - Tests d'interface utilisateur (Mobile)
|
||||
|
||||
**Objectif** : Tester les interactions utilisateur (tap, scroll, navigation, widgets)
|
||||
|
||||
**Exécuté par** : Mobile (Flutter `integration_test` + step definitions Dart dans `/mobile/tests/bdd/`)
|
||||
|
||||
**Exemples de scénarios** :
|
||||
- Cliquer sur "Lecture" → widget audio player s'affiche avec progress bar
|
||||
- Mode piéton activé → carte interactive affichée + bouton "Télécharger zone"
|
||||
- Scroll dans liste podcasts → lazy loading déclenche pagination
|
||||
|
||||
**Caractéristiques** :
|
||||
- Focus sur l'**expérience utilisateur mobile**
|
||||
- Validation visuelle (widgets, animations, navigation)
|
||||
- Mock du backend si nécessaire (tests UI isolés)
|
||||
|
||||
---
|
||||
|
||||
#### `/features/e2e/` - Tests end-to-end (Backend + Mobile)
|
||||
|
||||
**Objectif** : Tester les parcours complets impliquant plusieurs composants
|
||||
|
||||
**Exécuté par** : Backend **ET** Mobile ensemble
|
||||
|
||||
**Exemples de scénarios** :
|
||||
- Abonnement Premium : Formulaire mobile → API Zitadel → API RoadWave → Mangopay → Confirmation UI
|
||||
- Erreur réseau : Perte connexion pendant streaming → Fallback mode offline → Reprise auto après reconnexion
|
||||
- Notification géolocalisée : GPS détecte POI → Backend calcule recommandation → Push notification → Ouverture app → Lecture audio
|
||||
|
||||
**Caractéristiques** :
|
||||
- Tests **cross-composants** (intégration complète)
|
||||
- Implique souvent des **services tiers** (Zitadel, Mangopay, Firebase)
|
||||
- Validation du **parcours utilisateur de bout en bout**
|
||||
|
||||
---
|
||||
|
||||
### Implémentation Step Definitions
|
||||
|
||||
**Backend** : `/backend/tests/bdd/`
|
||||
- Step definitions Go pour features `api/` et `e2e/`
|
||||
- Utilise `godog` et packages backend (`service`, `repository`)
|
||||
|
||||
**Mobile** : `/mobile/tests/bdd/`
|
||||
- Step definitions Dart pour features `ui/` et `e2e/`
|
||||
- Utilise Flutter `integration_test` framework
|
||||
|
||||
**Note** : Les step definitions ne sont pas encore implémentées (répertoires avec `.gitkeep` seulement). Cette organisation prépare la structure pour l'implémentation future.
|
||||
|
||||
---
|
||||
|
||||
## Exemple
|
||||
|
||||
```gherkin
|
||||
|
||||
Reference in New Issue
Block a user