sepehr/Keep
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
Keep/_bmad-output/planning-artifacts/EPICS-ORGANIZATION.md
sepehr ddb67ba9e5 fix: unify theme system - fix theme switching persistence 
- Unified localStorage key to 'theme-preference' across all components
- Fixed header.tsx using wrong localStorage key ('theme' instead of 'theme-preference')
- Added localStorage hybrid persistence for instant theme changes
- Removed router.refresh() which was causing stale data revert
- Replaced Blue theme with Sepia
- Consolidated auth() calls to prevent race conditions
- Updated UserSettingsData types to include all themes
2026-01-18 22:33:41 +01:00

16 KiB
Raw Blame History

🗂️ ORGANISATION DES ÉPICS - BACKLOG CLEANUP

Date: 2026-01-17
Responsable: John - Product Manager
Status: DRAFT
Version: 2.0

📋 RÉSUMÉ EXÉCUTIF

Avant Nettoyage

  • 12 Épics avec 78 User Stories
  • Structure mélée, certaines fonctionnalités obsolètes
  • Pas de priorisation claire (MoSCoW)
  • Tests Playwright partiel

Après Nettoyage

  • 17 Épics avec ~120 User Stories
  • Structure organisée par domaines
  • Priorisation claire (Must/Should/Could/Won't)
  • Tests Playwright complets

Statistiques

Métrique Avant Après Évolution
Épics totaux 12 17 +5 (+42%)
User Stories 78 ~120 +42 (+54%)
Tests Playwright ~20 50+ +30 (+150%)
Couverture tests 30% 100% cible +70%

📊 PRIORITIZATION MOSCOW

MUST HAVE (Q1 2026 - Critique)

Epic Pourquoi ? User Stories Priorité
Epic 10 : Design System Standardization Foundation de TOUT le design 4 P0
Epic 13 : Desktop Design Refactor UX principale desktop 15 P0
Epic 16 : Playwright Test Suite Qualité et fiabilité 20 P0
Epic 15 : Mobile UX Overhaul UX principale mobile 10 P0

Total : 49 User Stories | Estimation : 6-8 semaines

SHOULD HAVE (Q2 2026 - Important)

Epic Pourquoi ? User Stories Priorité
Epic 14 : Admin & Profil Redesign UX admin/profil 12 P1
Epic 1 : AI-Powered Title Suggestions Fonctionnalité clé IA 10 P1
Epic 2 : Hybrid Semantic Search Fonctionnalité clé IA 6 P1
Epic 3 : Memory Echo - Proactive Connections Innovation IA 8 P1
Epic 9 : Simplify NoteCard Interface UX simplification 5 P1

Total : 41 User Stories | Estimation : 5-7 semaines

COULD HAVE (Q3 2026 - Nice to Have)

Epic Pourquoi ? User Stories Priorité
Epic 4 : Paragraph-Level AI Reformulation Fonctionnalité avancée IA 8 P2
Epic 5 : AI Settings & Privacy Control Configuration avancée 11 P2
Epic 8 : Accessibility & Responsive Design Amélioration UX 8 P2
Epic 11 : Settings Interface Redesign UX amélioration 4 P2
Epic 12 : Mobile Experience Optimization Optimisation mobile 4 P2

Total : 35 User Stories | Estimation : 4-6 semaines

WON'T HAVE (Backlog / Futur)

Epic Pourquoi ? User Stories Priorité
Epic 6 : Language Detection & Multilingual Support Fonctionnalité nice-to-have 2 P3
Epic 7 : Admin Dashboard & Analytics Fonctionnalité admin avancée 9 P3
Epic 17 : Innovation Features Fonctionnalités expérimentales 20 P3

Total : 31 User Stories | Estimation : 6-8 semaines

🗃️ ÉPICS ARCHIVÉS (Obsolètes)

Épics Archivés le 2026-01-17

Les épics suivants sont archivés car obsolètes ou remplacés par de nouveaux épics :

  1. "Legacy Mobile Optimization" (Épic archivé)

    • Raison : Remplacé par Epic 15 : Mobile UX Overhaul plus complet
    • Statut : ARCHIVED
    • Migration : Les stories pertinentes ont été migrées vers Epic 15

  2. "Old Settings UI" (Épic archivé)

    • Raison : Remplacé par Epic 14 et Epic 11 plus modernes
    • Statut : ARCHIVED
    • Migration : Les stories pertinentes ont été migrées

  3. "Basic Desktop Design" (Épic archivé)

    • Raison : Remplacé par Epic 13 : Desktop Design Refactor plus complet
    • Statut : ARCHIVED
    • Migration : Les stories pertinentes ont été migrées

User Stories Archivées

Les user stories suivantes sont archivées car obsolètes ou dupliquées :

Story ID Titre Original Raison Remplacé par
US-OLD-001 "Create note with image upload" Remplacé par story plus complet US-13.2
US-OLD-002 "Add note to notebook" Remplacé par story plus complet US-13.2
US-OLD-003 "Delete note with confirmation" Remplacé par story plus complet US-16.8
US-OLD-004 "Edit note content" Remplacé par story plus complet US-16.7
US-OLD-005 "Create notebook" Remplacé par story plus complet US-16.2
US-OLD-006 "Admin view users list" Remplacé par story plus complet US-14.2
US-OLD-007 "Admin create user" Remplacé par story plus complet US-14.2
US-OLD-008 "Mobile note list view" Remplacé par story plus complet US-15.4
US-OLD-009 "Mobile menu drawer" Remplacé par story plus complet US-15.2
US-OLD-010 "Mobile filters horizontal" Remplacé par story plus complet US-15.3

Total archivé : 10 User Stories

📋 NOUVEAUX ÉPICS (13-17)

Epic 13 : Desktop Design Refactor

Statut : ACTIVE
Priorité : P0 (Must Have)
Complexité : Medium-High
User Stories : 15
Estimation : 2-3 semaines

Description : Refonte complète de l'interface desktop pour créer une expérience moderne et cohérente avec un Design System unifié.

Dépendances :

  • Epic 10 : Design System (doit être complété d'abord)

Stories clés :

  • US-13.1 : Créer des composants UI réutilisables (Button, Badge, Input, Card, Dialog, Dropdown)
  • US-13.2 : Implémenter la page notebook desktop (sidebar, masonry grid, note cards)
  • US-13.3 : Implémenter les labels contextuels imbriqués
  • US-13.4 : Implémenter la section Smart Views
  • US-13.5 : Implémenter le footer avec suggestions AI
  • US-13.6 : Implémenter l'intégration recherche

Critères de succès :

  • ✅ 100% des composants suivent le Design System
  • ✅ Sidebar fonctionnelle avec notebooks et labels
  • ✅ Grille masonry responsive (1-3 colonnes)
  • ✅ NoteCards avec images hero et menu "..."
  • ✅ Animations fluides (hover, transitions)

Epic 14 : Admin & Profil Redesign

Statut : ACTIVE
Priorité : P1 (Should Have)
Complexité : Medium
User Stories : 12
Estimation : 2-3 semaines

Description : Refonte complète des pages admin et profil pour offrir une expérience moderne, cohérente avec le Design System.

Dépendances :

  • Epic 10 : Design System
  • Epic 13 : Desktop Design Refactor (patterns réutilisables)

Stories clés :

  • US-14.1 : Implémenter le Dashboard admin avec métriques
  • US-14.2 : Implémenter la gestion des utilisateurs
  • US-14.3 : Implémenter le suivi des coûts IA
  • US-14.4 : Implémenter la page profil avec bannière
  • US-14.5 : Implémenter les paramètres profil
  • US-14.6 : Implémenter le sélecteur de thèmes

Critères de succès :

  • ✅ Dashboard admin avec métriques temps réel
  • ✅ Gestion utilisateurs intuitive
  • ✅ Page profil enrichie (bannière, statistiques, thèmes)
  • ✅ Support 4 thèmes (Light, Dark, Midnight, Sepia)
  • ✅ Interface cohérente avec Design System

Epic 15 : Mobile UX Overhaul

Statut : ACTIVE
Priorité : P0 (Must Have)
Complexité : High
User Stories : 10
Estimation : 3-4 semaines

Description : Refonte complète de l'expérience mobile pour offrir une UX native-like avec patterns modernes (FAB, swipe, gestures, drawer).

Dépendances :

  • Epic 10 : Design System

Stories clés :

  • US-15.1 : Implémenter le header mobile compact
  • US-15.2 : Implémenter le navigation drawer
  • US-15.3 : Implémenter les filtres horizontaux scrollables
  • US-15.4 : Implémenter la liste verticale de notes
  • US-15.5 : Implémenter la bottom tab bar
  • US-15.6 : Implémenter le FAB (Floating Action Button)
  • US-15.7 : Implémenter les swipe gestures
  • US-15.8 : Implémenter le menu contextuel long-press
  • US-15.9 : Implémenter le pull-to-refresh

Critères de succès :

  • ✅ UX native-like sur mobile
  • ✅ Navigation drawer fonctionnelle
  • ✅ Liste verticale optimisée (pas masonry)
  • ✅ FAB avec animation
  • ✅ Swipe gestures fonctionnels
  • ✅ Touch targets 44x44px minimum
  • ✅ Performance 60fps

Epic 16 : Playwright Test Suite

Statut : ACTIVE
Priorité : P0 (Must Have)
Complexité : High
User Stories : 20
Estimation : 2-3 semaines

Description : Création d'une suite de tests Playwright complète pour TOUS les workflows critiques, avec une procédure stricte en cas d'échec (NE JAMAIS ABANDONNER).

Dépendances :

  • Aucune (peut être fait en parallèle avec d'autres épics)

Stories clés :

  • US-16.1 : Tester l'ouverture de toutes les modales (13)
  • US-16.2 : Tester la fermeture de toutes les modales (13)
  • US-16.3 : Tester la soumission des formulaires dans les modales
  • US-16.4 : Tester l'accessibilité des modales
  • US-16.5 : Tester le responsive des modales
  • US-16.6 : Tester le workflow création de note
  • US-16.7 : Tester le workflow édition de note
  • US-16.8 : Tester le workflow suppression de note
  • US-16.9 : Implémenter la procédure d'échec (CRITIQUE)
  • US-16.10 : Tester la performance des modales

Critères de succès :

  • ✅ 100% couverture des modales
  • ✅ Tous les workflows critiques testés
  • ✅ Procédure d'échec stricte implémentée
  • ✅ Tests d'accessibilité (WCAG 2.1 AA)
  • ✅ Tests responsive (mobile, tablette, desktop)
  • ✅ Performance tests (< 150ms pour modales)

Règle d'OR POUR LA PROCÉDURE D'ÉCHEC :

QUAND UN TEST ÉCHOUE :

1. NE JAMAIS ABANDONNER
2. Identifier précisément le blocage
3. Demander à l'utilisateur (Ramez) une action :
   - "Pouvez-vous vérifier que l'application est démarrée ?"
   - "Pouvez-vous ouvrir la page X ?"
   - "Pouvez-vous vérifier les permissions navigateur ?"
   - "Pouvez-vous voir si une console d'erreur est ouverte ?"
4. Attendre la réponse de l'utilisateur
5. Réessayer le test
6. Si ça échoue encore :
   a. Analyser pourquoi
   b. Proposer une solution technique
   c. Demander validation à l'utilisateur
   d. Réessayer
7. RÉPÉTER JUSQU'À CE QUE LE TEST RÉUSSISSE

Epic 17 : Innovation Features

Statut : BACKLOG
Priorité : P3 (Won't Have pour l'instant)
Complexité : Very High
User Stories : 20
Estimation : 6-8 semaines

Description : Fonctionnalités innovantes pour différencier Keep des concurrents (Notion, Obsidian, Evernote, OneNote).

Dépendances :

  • Epic 1-5 : AI Features (titre, recherche, mémoire, reformulation)
  • Epic 13-15 : UX améliorée (design system, desktop, mobile)

Stories clés :

  • US-17.1 : Implémenter la capture vocale de notes
  • US-17.2 : Implémenter les templates intelligents
  • US-17.3 : Implémenter le partage intelligent
  • US-17.4 : Implémenter la recherche par image et audio
  • US-17.5 : Implémenter l'intégration calendrier intelligente
  • US-17.6 : Implémenter le dashboard d'analyse utilisateur
  • US-17.7 : Implémenter les dossiers intelligents
  • US-17.8 : Implémenter l'édition collaborative
  • US-17.9 : Implémenter les pièces jointes intelligentes
  • US-17.10 : Implémenter les résumés IA

Critères de succès :

  • ✅ 5+ fonctionnalités innovantes livrées
  • ✅ Fonctionnalités testées et documentées
  • ✅ Feedback utilisateur positif
  • ✅ Différenciation par rapport aux concurrents

📊 MATRICE DE DÉPENDANCES

Epic Dépend de Bloque
Epic 10 : Design System Aucune Non
Epic 13 : Desktop Refactor Epic 10 Oui
Epic 14 : Admin/Profil Epic 10, Epic 13 Oui
Epic 15 : Mobile UX Epic 10 Oui
Epic 16 : Playwright Tests Aucune Non
Epic 17 : Innovation Epic 1-5, Epic 13-15 Oui

Ordre suggéré d'implémentation :

  1. Epic 10 (Foundation)
  2. Epic 16 (Tests - en parallèle)
  3. Epic 13 (Desktop)
  4. Epic 15 (Mobile)
  5. Epic 14 (Admin/Profil)
  6. Epic 17 (Innovation)

📅 ROADMAP Q1-Q2 2026

Q1 2026 : Foundation & Core UX

Semaine 1-2 : Design System (Epic 10)

  • Créer les composants UI de base
  • Standardiser les couleurs, typographie, spacing
  • Implémenter le support des 4 thèmes
  • Tester tous les composants

Semaine 3-4 : Desktop Refactor (Epic 13)

  • Implémenter le sidebar
  • Implémenter la grille masonry
  • Implémenter les NoteCards
  • Implémenter les labels contextuels
  • Tests Playwright

Semaine 5-6 : Playwright Tests (Epic 16)

  • Créer les tests pour toutes les modales (13)
  • Créer les tests pour les workflows critiques
  • Implémenter la procédure d'échec
  • Atteindre 100% couverture

Semaine 7-8 : Mobile UX (Epic 15)

  • Implémenter le header mobile
  • Implémenter le navigation drawer
  • Implémenter les filtres horizontaux
  • Implémenter la liste verticale
  • Implémenter le FAB et la bottom tab bar

Q2 2026 : Enhancement & Innovation

Semaine 1-3 : Admin & Profil (Epic 14)

  • Implémenter le dashboard admin
  • Implémenter la gestion utilisateurs
  • Implémenter le profil avec bannière
  • Implémenter les paramètres et thèmes

Semaine 4-6 : AI Features (Epic 1-5)

  • Implémenter Title Suggestions (Epic 1)
  • Implémenter Semantic Search (Epic 2)
  • Implémenter Memory Echo (Epic 3)
  • Implémenter Paragraph Reformulation (Epic 4)

Semaine 7-8 : Innovation (Epic 17)

  • Sélectionner 3-5 fonctionnalités prioritaires
  • Implémenter les fonctionnalités sélectionnées
  • Tester et documenter
  • Collecter feedback utilisateur

✅ CHECKLIST DE VALIDATION

Pour chaque Epic complété

  • Tous les user stories implémentés
  • Tests Playwright créés et passants
  • Documentation mise à jour
  • Accessibilité vérifiée (WCAG 2.1 AA)
  • Responsive testé (mobile, tablette, desktop)
  • Performance mesurée (Lighthouse)
  • Feedback utilisateur collecté
  • Bugs corrigés

Pour passer un Epic en "COMPLETED"

  1. Validation fonctionnelle : Tous les critères d'acceptation remplis
  2. Validation technique : Tests passants, code reviewé
  3. Validation UX : Feedback positif, accessibilité OK
  4. Validation performance : Objectifs atteints
  5. Approbation Product Owner : Validation finale

📈 MÉTRIQUES DE SUIVI

KPIs par Epic

Epic Stories Complétées Tests Passants Coverage Estimation Réelle Deadline
Epic 10 0/4 0/10 0% TBD Q1-W2
Epic 13 0/15 0/20 0% TBD Q1-W4
Epic 16 0/20 0/50+ 0% TBD Q1-W6
Epic 15 0/10 0/15 0% TBD Q1-W8
Epic 14 0/12 0/18 0% TBD Q2-W3
Epic 17 0/20 0/30 0% TBD Q2-W8

Objectifs globaux

  • Couverture tests : 100% (tous workflows critiques)
  • Accessibilité : 100% WCAG 2.1 Level AA
  • Performance : Lighthouse score > 90
  • Satisfaction utilisateur : NPS > 50
  • Uptime : 99% pendant heures ouvrables

🎯 PROCHAINES ÉTAPES

Immédiat

  1. ✅ Valider ce document avec Ramez
  2. ⏳ Créer les User Stories détaillées pour Epic 13-17
  3. ⏳ Créer les tests Playwright pour Epic 16
  4. ⏳ Commencer l'implémentation de Epic 10 (Design System)

Court terme (Q1 2026)

  1. Implémenter Epic 10 : Design System
  2. Implémenter Epic 13 : Desktop Design Refactor
  3. Implémenter Epic 16 : Playwright Test Suite
  4. Implémenter Epic 15 : Mobile UX Overhaul

Moyen terme (Q2 2026)

  1. Implémenter Epic 14 : Admin & Profil Redesign
  2. Implémenter Epic 1-5 : AI Features
  3. Sélectionner et implémenter Epic 17 : Innovation Features

Document Status : DRAFT
Date de création : 2026-01-17
Version : 2.0
Responsable : John - Product Manager
Dernière mise à jour : 2026-01-17