Keep/_bmad-output/planning-artifacts/notebooks-contextual-labels-prd.md

Product Requirements Document (PRD)

Notebooks & Labels Contextuels avec IA

Project: Keep (Memento Phase 1 MVP AI) Date: 2026-01-11 Author: Sally (UX Designer) + Ramez (Product Owner) Status: Draft - Ready for Architecture Priority: High - Core Feature Reorganization

---

📋 Executive Summary

Vision

Transformer l'organisation de Keep d'un système de tags plat en une structure de Notebooks avec Labels Contextuels, où chaque notebook a sa propre taxonomie de labels, permettant une organisation plus naturelle et contextuelle.

Objectifs Principaux

1. ✅ Introduire les Notebooks comme organisation principale
2. ✅ Rendre les Labels contextuels à chaque notebook
3. ✅ Créer une Inbox ("Notes générales") pour les notes non organisées
4. ✅ Intégrer l'IA intelligemment dans cette nouvelle structure
5. ✅ Permettre une migration douce depuis le système actuel

---

🎯 User Stories

Primary Users

• Ramez (Power User): Utilise Keep quotidiennement pour organiser voyage, travail, vie perso
• Professionnel: Gère des projets avec des contextes différents
• Voyageur: Organise ses préparatifs de voyage avec des notes spécifiques

User Journey Exemple

Scénario 1: Création de note dans Notebook

1. Ramez ouvre Keep, navigue vers Notebook "Voyage"
2. Il voit les labels contextuels: #hôtels, #vols, #restos
3. Il clique "Nouvelle note"
4. La note est automatiquement assignée au Notebook "Voyage"
5. Il peut tagger avec #hôtels (disponible car dans le bon contexte)

Scénario 2: Note rapide dans Inbox

1. Ramez a une idée rapide, ouvre Keep (page d'accueil)
2. Il tape son idée et sauve
3. La note va dans "Notes générales" (Inbox)
4. Plus tard, il la déplace vers "Notebook Perso"
5. Les labels de "Perso" deviennent disponibles

Scénario 3: Organisation IA-assistée

1. Ramez a 15 notes dans "Notes générales"
2. Il clique "Organiser avec l'IA"
3. L'IA analyse les notes et propose:
   - "3 notes pour Notebook Voyage"
   - "5 notes pour Notebook Travail"
   - "7 notes pour Notebook Perso"
4. Ramez valide les suggestions
5. Les notes sont déplacées automatiquement

---

🏗️ Structure de l'Organisation

Hiérarchie

KEEP
├─ 📥 Notes générales (Inbox)
│  └─ Notes sans notebook assigné
│  └─ PAS de labels (zone temporaire)
│
├─ 📚 Notebooks (ordonnés manuellement)
│  ├─ ✈️ Voyage
│  │  ├─ Labels: #hôtels, #vols, #restos, #à_visiter
│  │  └─ Notes assignées à "Voyage"
│  │
│  ├─ 💼 Travail
│  │  ├─ Labels: #réunions, #projets, #urgent, #à_faire
│  │  └─ Notes assignées à "Travail"
│  │
│  └─ 📖 Perso
│     ├─ Labels: #idées, #rêves, #objectifs, #réflexions
│     └─ Notes assignées à "Perso"
│
└─ [+] Nouveau Notebook

Règles Métier

R1: Appartenance des Notes

• Une note appartient à UN seul notebook (ou aucune)
• Les notes dans "Notes générales" n'appartiennent à aucun notebook
• Une note ne peut être dans plusieurs notebooks simultanément

R2: Labels Contextuels

• Chaque notebook a ses propres labels (100% isolés)
• Les labels sont créés/supprimés au niveau notebook
• Les notes dans "Notes générales" n'ont pas accès aux labels

R3: Ordre des Notebooks

• Les notebooks sont ordonnés manuellement (drag & drop)
• L'ordre est personnalisé par utilisateur
• Drag & drop dans la sidebar pour réorganiser

R4: Vue "Notes générales"

• Affiche SEULEMENT les notes sans notebook
• PAS de vue "Toutes les notes" (tous notebooks confondus)
• C'est une zone temporaire d'organisation

---

🎨 UX/UI Specifications

1. Navigation - Sidebar

┌─────────────────────────────────────┐
│  KEEP LOGO                          │
├─────────────────────────────────────┤
│  🔍 Search                          │
├─────────────────────────────────────┤
│  📚 NOTEBOOKS                       │
│  ┌───────────────────────────────┐  │
│  │ 📥 Notes générales (12)       │  │ ← Compteur de notes
│  │                                │  │
│  │ ✈️ Voyage (8)                 │  │ ← Notebook actif = highlight
│  │ ┌─ 🏷️ Labels contextuels     │  │
│  │ │  • #hôtels (3)             │  │ ← Labels seulement si actif
│  │ │  • #vols (2)               │  │
│  │ │  • #restos (3)             │  │
│  │ │  [+ Nouveau label]         │  │
│  │ └─────────────────────────────┘  │
│  │                                │  │
│  │ 💼 Travail (15)                │  │ ← Handles pour drag & drop
│  │ ║  ║                           │  │
│  │ 📖 Perso (23)                  │  │
│  │ ║  ║                           │  │
│  └───────────────────────────────┘  │
│                                    │
│  [+ Nouveau Notebook]              │
└─────────────────────────────────────┘

Comportements:

• Click sur notebook → Navigue vers ce notebook
• Drag & drop des notebooks → Réorganise l'ordre
• Hover sur notebook → Affiche les labels contextuels
• [+ Nouveau label] → Crée un label dans ce notebook
• Compteurs → Montre le nombre de notes

2. Création de Note

Cas A: Depuis un Notebook

User dans "Voyage" → [Nouvelle note]
├─ Note créée avec notebookId = "voyage"
├─ Peut utiliser les labels de "Voyage"
└─ UI: Badge "Voyage" visible sur la note

Cas B: Depuis Notes Générales

User sur page d'accueil → [Nouvelle note]
├─ Note créée avec notebookId = null
├─ PAS de labels disponibles
└─ UI: Badge "À trier" visible

Cas C: Création dans un autre notebook

User dans "Voyage", veut créer pour "Travail"
├─ DOIT naviguer vers "Travail" d'abord
├─ OU utilise le raccourci clavier (ex: Ctrl+N → chooser)
└─ PAS de modal à chaque création

3. Déplacement de Notes (Option C: A + B)

Méthode A: Drag & Drop

┌─────────────────────────────────────┐
│  📝 Note à déplacer                 │
│  ┌───────────────────────────────┐  │
│  │ Grip handle │ Note content... │  │ ← Drag depuis ici
│  └───────────────────────────────┘  │
│         ↓                             │
│   Drop vers sidebar →                │
│  ┌───────────────────────────────┐  │
│  │ ✈️ Voyage [Drop zone]         │  │
│  │ 💼 Travail [Drop zone]        │  │
│  └───────────────────────────────┘  │
└─────────────────────────────────────┘

Méthode B: Menu Contextuel

Sur une note → Click droit → Menu:
├─ 📋 Copier
├─ ✏️ Modifier
├─ 📚 Déplacer vers...
│  ├─ 📥 Notes générales
│  ├─ ✈️ Voyage
│  ├─ 💼 Travail
│  └─ 📖 Perso
├─ 🏷️ Ajouter un label
├─ 📌 Épingler
└─ 🗑️ Supprimer

Validation:

• ✅ Drag & drop vers notebook dans sidebar
• ✅ Menu contextuel "Déplacer vers..."
• ✅ Les deux méthodes disponibles

4. Labels Contextuels

Création de Label

Dans Notebook "Voyage":
┌─────────────────────────────────────┐
│  🏷️ Labels                          │
│  • #hôtels  • #vols  • #restos      │
│  [+ Nouveau label]                  │ ← Click
├─────────────────────────────────────┤
│  Modal:                             │
│  ┌───────────────────────────────┐  │
│  │ Nom du label:                 │  │
│  │ [___________]                 │  │
│  │                                │  │
│  │ Couleur: ○ 🟡 ○ 🔴 ○ 🔵       │  │
│  │                                │  │
│  │ [Annuler] [Créer]             │  │
│  └───────────────────────────────┘  │
└─────────────────────────────────────┘

Assignation de Label à Note

Note dans "Voyage" → Click "Ajouter label"
├─ Seuls les labels de "Voyage" sont proposés
├─ Dropdown avec checkboxes
└─ Multi-label possible sur une note

Exemple:
📝 Note: "Hôtel Tokyo Shibuya"
├─ Notebook: ✈️ Voyage
└─ Labels: #hôtels, #réservations

Suppression de Label

Options:
├─ Supprimer le label (du notebook)
│  └─ Warning: "Ce label sera retiré de X notes. Continuer?"
└─ Retirer des notes seulement
   └─ Label existe toujours, mais plus utilisé

5. Gestion des Notebooks

Création de Notebook

Click [+ Nouveau Notebook]
├─ Modal de création
│  ├─ Nom: "Voyage"
│  ├─ Icône: [Sélecteur d'emoji]
│  ├─ Couleur: [Sélecteur de couleur]
│  └─ [Créer]
└─ Notebook créé à la fin de la liste

Édition de Notebook

Click droit sur notebook → Menu:
├─ ✏️ Modifier
│  └─ Modal: Nom, Icône, Couleur
├─ 📊 Statistiques
│  ├─ Nombre de notes
│  ├─ Labels utilisés
│  └─ Dernière mise à jour
├─ 🗑️ Supprimer
│  └─ Warning: "Les notes seront déplacées vers Notes générales"
└─ ❌ Fermer

Réorganisation (Drag & Drop)

✈️ Voyage ║ ║ ← Drag handle
💼 Travail ║ ║
📖 Perso ║ ║

Drag "Travail" vers le haut → Réordonne

---

🤖 Intégration IA

C'est la partie CRUCIALE qui rend cette feature vraiment puissante.

IA1: Suggestion Automatique de Notebook

Scénario

User crée une note dans "Notes générales":
"Rendez-vous dermatologue mardi 15h à Paris"

IA analyse et suggère:
┌─────────────────────────────────────┐
│  💡 Suggestion IA                   │
│  ┌───────────────────────────────┐  │
│  │ Cette note semble appartenir  │  │
│  │ au notebook "Perso".          │  │
│  │                                │  │
│  │ [Ignorer] [Déplacer vers Perso]│  │
│  └───────────────────────────────┘  │
└─────────────────────────────────────┘

Prompt IA:

"Analyse cette note et suggère le notebook le plus approprié:
Note: {content}
Notebooks disponibles: {notebook_names_with_labels}

Réponds avec:
- notebook_suggéré: string
- confiance: 0-1
- raisonnement: string"

Déclencheurs:

• Note créée dans "Notes générales"
• Note modifiée significativement
• 5+ secondes après la fin de frappe (pas en temps réel)

IA2: Suggestion de Labels Contextuels

Scénario

Note dans Notebook "Voyage":
"Hotel Shibuya Excel - 150€/nuit - Booking confirmé"

IA suggère:
┌─────────────────────────────────────┐
│  💡 Suggestions de labels           │
│  ┌───────────────────────────────┐  │
│  │ ✅ #hôtels (confiance: 95%)   │  │ ← Click pour assigner
│  │ ✅ #réservations (80%)        │  │
│  │ ✅ #tokyo (70%)               │  │
│  │                                │  │
│  │ [Tout sélectionner] [Ignorer] │  │
│  └───────────────────────────────┘  │
└─────────────────────────────────────┘

Prompt IA:

"Analyse cette note et suggère les labels appropriés:
Note: {content}
Notebook actuel: {notebook_name}
Labels disponibles dans ce notebook: {available_labels}

Réponds avec un tableau de:
- label: string (doit être dans {available_labels})
- confiance: 0-1
- raisonnement: string"

Comportement:

• ✅ Maximum 3 suggestions
• ✅ Seulement si confiance > 60%
• ✅ Labels cliquables pour assignation en 1 clic
• ✅ Ne pas déranger si l'utilisateur tape activement

IA3: Organisation Intelligente (Batch Processing)

Scénario

User a 20 notes dans "Notes générales"

Click "Organiser avec l'IA"
├─ IA analyse toutes les notes
├- Groupe par thématique
└─ Présente un plan d'organisation:

┌─────────────────────────────────────┐
│  📋 Plan d'organisation IA          │
│  ┌───────────────────────────────┐  │
│  │ Notebook: Voyage (5 notes)    │  │
│  │  • Hotel Tokyo...             │  │
│  │  • Vols JAL...                │  │
│  │  • Restaurant Shibuya...      │  │
│  │  [Tout sélectionner]          │  │
│  │                                │  │
│  │ Notebook: Travail (8 notes)   │  │
│  │  • Réunion lundi...           │  │
│  │  • Projet Alpha...            │  │
│  │  ...                          │  │
│  │                                │  │
│  │ Notebook: Perso (7 notes)     │  │
│  │  • Idées livre...             │  │
│  │  ...                          │  │
│  │                                │  │
│  │ [Annuler] [Appliquer tout]    │  │
│  └───────────────────────────────┘  │
└─────────────────────────────────────┘

Prompt IA:

"Analyse ces {count} notes et propose une organisation:
{notes_with_content}

Notebooks disponibles: {notebooks}

Pour chaque notebook, indique:
- notebook_cible: string
- notes: [{note_id, note_title, confidence, raison}]

Retourne un plan d'organisation optimisé."

Validation:

• ✅ User peut désélectionner des notes
• ✅ User peut ajuster les destinations
• ✅ Confirmation avant application
• ✅ Undo possible (Ctrl+Z)

IA4: Création Automatique de Labels

Scénario

Notebook "Voyage" devient peuplé de notes sur le Japon

IA détecte:
- 10+ notes mentionnant "Tokyo"
- 8+ notes mentionnant "Kyoto"
- 5+ notes mentionnant "Osaka"

IA suggère:
┌─────────────────────────────────────┐
│  💡 Suggestions de nouveaux labels │  │
│  ┌───────────────────────────────┐  │
│  │ J'ai détecté des thèmes récurrents│
│  │ dans vos notes. Créer des labels?│
│  │                                │  │
│  │ ✅ #tokyo (10 notes)          │  │
│  │ ✅ #kyoto (8 notes)           │  │
│  │ ✅ #osaka (5 notes)           │  │
│  │                                │  │
│  │ [Annuler] [Créer et assigner] │  │
│  └───────────────────────────────┘  │
└─────────────────────────────────────┘

Déclencheur:

• Notebook atteint 15+ notes
• IA détecte 3+ mots-clés récurrents (5+ fois chacun)
• Ne propose PAS si les labels existent déjà

IA5: Recherche Sémantique par Notebook

Scénario

User dans Notebook "Voyage" tape:
"endroit pour dormir pas cher"

IA comprend le contexte "Voyage" et cherche:
├─ Semantic search DANS ce notebook seulement
├- Priorise les labels #hôtels, #auberges
└- Résultats plus pertinents car contextuels

Résultats:
┌─────────────────────────────────────┐
│  🔍 Résultats dans "Voyage"         │
│  ┌───────────────────────────────┐  │
│  │ 📝 Capsule Hotel Shinjuku     │  │
│  │    #hôtels #tokyo             │  │
│  │    "Hotel capsule 30€/nuit..." │  │
│  │    Correspondance: 87%         │  │
│  │                                │  │
│  │ 📝 Airbnb Asakusa              │  │
│  │    #hôtels #tokyo             │  │
│  │    "Appartement 45€/nuit..."   │  │
│  │    Correspondance: 82%         │  │
│  └───────────────────────────────┘  │
└─────────────────────────────────────┘

Avantage:

• ✅ Recherche contextuelle au notebook
• ✅ Résultats plus pertinents
• ✅ Comprend le jargon spécifique (ex: "vol" dans Voyage vs Travail)

IA6: Synthèse par Notebook

Scénario

User clique "Résumer ce notebook" dans "Voyage"

IA génère:
┌─────────────────────────────────────┐
│  📊 Synthèse du Notebook Voyage     │
│  ┌───────────────────────────────┐  │
│  │ 🌍 Destinations               │  │
│  │  • Japon (Tokyo, Kyoto)       │  │
│  │  • France (Paris)             │  │
│  │                                │  │
│  │ 📅 Dates                       │  │
│  │  • 15-25 Mars 2024             │  │
│  │                                │  │
│  │ 🏨 Réservations                │  │
│  │  • 3 hôtels réservés          │  │
│  │  • 2 vols confirmés           │  │
│  │  • 5 restaurants identifiés   │  │
│  │                                │  │
│  │ 💰 Budget estimé: 3500€        │  │
│  │                                │  │
│  │ ⚠️ Actions requises            │  │
│  │  • Réserver visa japonais      │  │
│  │  • Confirmer assurance voyage  │  │
│  └───────────────────────────────┘  │
└─────────────────────────────────────┘

Prompt IA:

"Génère une synthèse structurée de ce notebook:
{notes_with_labels}

Inclus:
- Destinations/Thèmes principaux
- Dates importantes
- Éléments réservés vs planifiés
- Actions requises
- Statistiques (nombre de notes, labels utilisés)

Format: Markdown structuré avec emojis."

---

🗄️ Structure de Données (Database Schema)

Prisma Schema - Nouveaux Modèles

// Modèle Notebook
model Notebook {
  id          String   @id @default(cuid())
  name        String
  icon        String?  // Emoji: "✈️", "💼", "📖"
  color       String?  // Hex color: "#FF6B6B"
  order       Int      // Ordre manuel dans la sidebar
  userId      String
  user        User     @relation(fields: [userId], references: [id], onDelete: Cascade)
  notes       Note[]
  labels      Label[]
  createdAt   DateTime @default(now())
  updatedAt   DateTime @updatedAt

  @@index([userId, order])
}

// Modèle Label MODIFIÉ - Ajout notebookId
model Label {
  id          String   @id @default(cuid())
  name        String
  color       String?  // Couleur du label
  notebookId  String   // NOUVEAU: Label appartient à un notebook
  notebook    Notebook @relation(fields: [notebookId], references: [id], onDelete: Cascade)
  notes       Note[]   // Relation many-to-many via NoteLabel
  createdAt   DateTime @default(now())
  updatedAt   DateTime @updatedAt

  @@unique([notebookId, name]) // Un label est unique dans un notebook
  @@index([notebookId])
}

// Modèle Note MODIFIÉ - Ajout notebookId (optionnel)
model Note {
  id          String   @id @default(cuid())
  title       String?
  content     String
  // ... autres champs existants ...

  notebookId  String?  // NOUVEAU: Optionnel - null = dans "Notes générales"
  notebook    Notebook? @relation(fields: [notebookId], references: [id], onDelete: SetNull)

  // Garantir qu'une note est dans UN SEUL notebook
  @@index([userId, notebookId])
}

// Table de jonction Note-Label (existante mais gardée)
model NoteLabel {
  noteId      String
  labelId     String
  note        Note     @relation(fields: [noteId], references: [id], onDelete: Cascade)
  label       Label    @relation(fields: [labelId], references: [id], onDelete: Cascade)

  @@id([noteId, labelId])
  @@index([noteId])
  @@index([labelId])
}

Clés de la Structure

Règles d'intégrité:

1. ✅ Note.notebookId est optionnel (null = Notes générales)
2. ✅ Label.notebookId est obligatoire (labels TOUJOURS contextuels)
3. ✅ @@unique([notebookId, name]) = Unicité des labels DANS un notebook
4. ✅ onDelete: SetNull sur Note→Notebook = Si notebook supprimé, notes → Notes générales

Migration Schema

-- Étape 1: Ajouter les nouveaux modèles
CREATE TABLE "Notebook" (
  "id" TEXT NOT NULL PRIMARY KEY,
  "name" TEXT NOT NULL,
  "icon" TEXT,
  "color" TEXT,
  "order" INTEGER NOT NULL,
  "userId" TEXT NOT NULL,
  "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
  "updatedAt" DATETIME NOT NULL,
  FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE
);

-- Étape 2: Ajouter notebookId aux Notes (optionnel)
ALTER TABLE "Note" ADD COLUMN "notebookId" TEXT;
ALTER TABLE "Note" ADD FOREIGN KEY ("notebookId") REFERENCES "Notebook"("id") ON DELETE SET NULL ON UPDATE CASCADE;

-- Étape 3: Ajouter notebookId aux Labels (obligatoire)
ALTER TABLE "Label" ADD COLUMN "notebookId" TEXT NOT NULL DEFAULT 'TEMP_MIGRATION';
ALTER TABLE "Label" ADD FOREIGN KEY ("notebookId") REFERENCES "Notebook"("id") ON DELETE CASCADE ON UPDATE CASCADE;

-- Étape 4: Créer notebook par défaut pour la migration
INSERT INTO "Notebook" (id, name, icon, color, "order", "userId")
VALUES (
  'migration_default',
  'Labels existants',
  '📦',
  '#9CA3AF',
  999,
  {user_id}
);

-- Étape 5: Assigner tous les labels existants à ce notebook
UPDATE "Label" SET "notebookId" = 'migration_default' WHERE "notebookId" = 'TEMP_MIGRATION';

-- Étape 6: Laisser toutes les notes SANS notebook (Notes générales)
-- Rien à faire - notebookId est déjà NULL par défaut

-- Étape 7: Créer index pour performance
CREATE INDEX "Note_userId_notebookId_idx" ON "Note"("userId", "notebookId");
CREATE UNIQUE INDEX "Label_notebookId_name_key" ON "Label"("notebookId", "name");

---

🔄 Migration des Données Existantes

Stratégie de Migration

Phase 1: Pré-migration (Backend)

// app/actions/migration/prepare-notebooks.ts
'use server'

export async function prepareNotebookMigration() {
  const session = await auth()
  if (!session?.user?.id) throw new Error('Unauthorized')

  // 1. Créer notebook "Import" pour les labels existants
  const importNotebook = await prisma.notebook.create({
    data: {
      name: 'Labels existants',
      icon: '📦',
      color: '#9CA3AF',
      order: 999,
      userId: session.user.id
    }
  })

  // 2. Assigner TOUS les labels existants à ce notebook
  await prisma.label.updateMany({
    where: { userId: session.user.id },
    data: { notebookId: importNotebook.id }
  })

  // 3. Laisser les notes SANS notebook (Notes générales)
  // Rien à faire - notebookId est NULL par défaut

  return { success: true, importNotebookId: importNotebook.id }
}

Phase 2: Migration Interactive (User Journey)

┌─────────────────────────────────────────────────────────┐
│  🎉 Bienvenue dans les Notebooks !                      │
│                                                          │
│  Nous avons organisé vos étiquettes existantes dans     │
│  le notebook "Labels existants" pour ne rien perdre.   │
│                                                          │
│  📊 État actuel:                                        │
│  • 15 notes sans notebook (à organiser)                │
│  • 1 notebook "Labels existants"                        │
│  • 12 étiquettes préservées                             │
│                                                          │
│  Que voulez-vous faire ?                                │
│                                                          │
│  [1] Laisser l'IA organiser mes notes                   │
│  [2] Explorer et créer mes propres notebooks            │
│  [3] Tout déplacer vers "Notes générales"               │
│                                                          │
│  [Plus tard] Je déciderai plus tard                     │
└─────────────────────────────────────────────────────────┘

Phase 3: Organisation IA (Option 1)

Si user choisit "Laisser l'IA organiser":

// app/actions/migration/ai-organize.ts
'use server'

export async function organizeWithAI() {
  const session = await auth()
  const notesWithoutNotebook = await prisma.note.findMany({
    where: {
      userId: session.user.id,
      notebookId: null
    }
  })

  // IA analyse et propose des notebooks
  const suggestions = await aiService.suggestNotebooks(notesWithoutNotebook)

  return {
    success: true,
    suggestions: [
      {
        notebookName: 'Voyage',
        icon: '✈️',
        color: '#3B82F6',
        notes: [/* notes suggérées */],
        confidence: 0.89
      },
      {
        notebookName: 'Travail',
        icon: '💼',
        color: '#10B981',
        notes: [/* notes suggérées */],
        confidence: 0.92
      }
    ]
  }
}

Phase 4: Validation User

┌─────────────────────────────────────────────────────────┐
│  📋 Plan d'organisation proposé par l'IA               │
│                                                          │
│  ✈️ Voyage (5 notes) - Confiance: 89%                  │
│     ☑ Hotel Tokyo Shibuya                               │
│     ☑ Vols JAL Tokyo-Paris                              │
│     ☑ Restaurant Shibuya                                │
│     ☑ Visa japonais                                     │
│     ☑ Itinéraire Kyoto                                  │
│                                                          │
│  💼 Travail (8 notes) - Confiance: 92%                  │
│     ☑ Réunion lundi                                     │
│     ☑ Projet Alpha                                     │
│     ☑ ...                                               │
│                                                          │
│  📖 Perso (2 notes) - Confiance: 76%                    │
│     ☑ Idées livre                                       │
│     ☑ Objectifs 2024                                    │
│                                                          │
│  [Désélectionner] [Annuler] [Appliquer]                │
└─────────────────────────────────────────────────────────┘

---

🎯 Success Metrics

KPIs à Mesurer

Adoption:

• % d'utilisateurs créant au moins 1 notebook dans les 30 jours
• Nombre moyen de notebooks par utilisateur actif
• % de notes organisées (avec notebook) vs notes générales

Engagement:

• Temps passé par notebook (ex: Voyage plus actif avant un voyage)
• Fréquence d'utilisation des labels contextuels
• Taux d'utilisation des suggestions IA

Satisfaction:

• NPS (Net Promoter Score) sur la feature notebooks
• % d'utilisateurs gardant le système par défaut (Import) vs créant les leurs
• Taux d'abandon lors de la migration

Performance IA:

• Taux d'acceptation des suggestions IA (notebook)
• Taux d'acceptation des suggestions IA (labels)
• Précision des suggestions (feedback utilisateur)

---

🚀 Implementation Phases

Phase 1: MVP (Weeks 1-3)

Objectif: Structure de base sans IA

• ✅ Database schema (Notebook, Label modifié, Note modifié)
• ✅ API endpoints (CRUD notebooks)
• ✅ UI: Sidebar avec notebooks
• ✅ UI: Création/édition de notebooks
• ✅ UI: Assignation de notebook aux notes
• ✅ UI: Labels contextuels (affichage)
• ✅ UI: Drag & drop des notebooks
• ✅ Migration: Notebook "Import" par défaut
• ❌ PAS d'IA encore

Phase 2: IA Features (Weeks 4-5)

Objectif: IA pour organisation intelligente

• ✅ IA1: Suggestion automatique de notebook
• ✅ IA2: Suggestion de labels contextuels
• ✅ IA3: Organisation batch (Notes générales → Notebooks)
• ✅ UI: Modals de suggestions IA
• ✅ Feedback loop (accepter/rejeter suggestions)

Phase 3: Advanced IA (Weeks 6-7)

Objectif: Features IA avancées

• ✅ IA4: Création automatique de labels
• ✅ IA5: Recherche sémantique contextuelle
• ✅ IA6: Synthèse par notebook
• ✅ Analytics: Dashboard d'utilisation des notebooks

Phase 4: Polish & Testing (Week 8)

Objectif: Finalisation et tests

• ✅ Playwright E2E tests
• ✅ Performance optimization
• ✅ Accessibility audit
• ✅ Beta testing avec users
• ✅ Documentation

---

🚨 Risques & Mitigations

Risque 1: Résistance au changement

Description: Users habitués aux tags globaux pourraient rejeter les notebooks

Mitigation:

• Phase de migration douce (optionnel)
• Mode hybride temporaire (garder vue tags pendant transition)
• Tutoriels interactifs
• Onboarding progressif

Risque 2: Performance IA

Description: Suggestions IA pourraient être lentes ou inexactes

Mitigation:

• Cache des suggestions (24h)
• Seuils de confiance minimums (>60%)
• Feedback loop pour améliorer le modèle
• Fallback rapide si IA timeout

Risque 3: Migration des données

Description: Perte de données ou organisation pendant la migration

Mitigation:

• Backup automatique avant migration
• Migration par défaut (notebook "Import")
• Possibilité de revenir en arrière (rollback)
• Tests exhaustifs de migration

Risque 4: Complexité UX

Description: Trop de clics pour organiser les notes

Mitigation:

• Drag & drop intuitif
• Raccourcis clavier
• IA pour automatiser l'organisation
• Mesures d'usabilité (clics, temps)

Risque 5: Labels contextuels = perte de flexibilité

Description: Users ne peuvent plus utiliser un label global (#urgent partout)

Mitigation:

• Éduquer: "Urgent" peut être recréé dans chaque notebook
• IA suggère de recréer les labels importants
• Option: Labels "favoris" synchronisés (feature future)

---

📚 Glossaire

• Notebook: Collection de notes sur un thème (ex: Voyage, Travail)
• Labels Contextuels: Tags spécifiques à un notebook (ex: #hôtels dans Voyage)
• Inbox / Notes générales: Zone temporaire pour les notes non organisées
• IA: Intelligence Artificielle (OpenAI ou Ollama)
• Suggestion IA: Proposition automatique basée sur l'analyse du contenu
• Drag & Drop: Action de glisser-déposer pour déplacer des éléments
• Migration: Transition du système de tags vers les notebooks
• Notebook par défaut: Notebook créé automatiquement pour préserver les tags existants

---

📝 Notes pour l'Architecture Team

Points Critiques à Implémenter

1. Database:

   • Note.notebookId est OPTIONNEL (null = Notes générales)
   • Label.notebookId est OBLIGATOIRE
   • Contrainte d'unicité: @@unique([notebookId, name])

2. API:

   • Nouveau endpoint: /api/notebooks (CRUD complet)
   • Endpoint modifié: /api/labels (filtre par notebook)
   • Endpoint modifié: /api/notes (filtre par notebook)

3. UI Components:

   • SidebarNotebooks: Liste des notebooks avec drag & drop
   • NotebookSelector: Dropdown pour choisir le notebook
   • ContextualLabels: Labels filtrés par notebook actif
   • AISuggestions: Modals pour les suggestions IA

4. IA Services:

   • NotebookSuggestionService: IA pour suggérer un notebook
   • LabelSuggestionService: IA pour suggérer des labels
   • BatchOrganizationService: IA pour organiser en lot
   • AutoLabelCreationService: IA pour créer des labels

5. Performance:

   • Index sur Note.userId + Note.notebookId
   • Cache des suggestions IA (Redis ou in-memory)
   • Virtual scrolling pour les notebooks avec 100+ notes

---

✅ Checklist de Validation

Avant de passer en développement, confirmer:

• Ramez valide l'UX décrite dans ce document
• L'Architecture Team a revu le schéma DB
• L'équipe IA a validé les prompts proposés
• Les risques sont acceptables et des mitigations sont en place
• Le plan de migration est testé sur un dataset de test
• Les mesures de succès (KPIs) sont définies et traçables
• Le wireframe UI est validé par Ramez
• L'implémentation est planifiée sur 8 semaines max

---

Status: ✅ PRD COMPLET - Prêt pour Architecture et Wireframes

Next Steps:

1. Créer les wireframes UX (Option XW)
2. Définir l'architecture technique
3. Commencer Phase 1 (MVP)

---

Document créé par Sally (UX Designer) avec Ramez (Product Owner) Date: 2026-01-11 Version: 1.0 - Final