claude code

product/BACKLOG.md

@@ -14,22 +14,98 @@ Must | Should | Could | Won’t
 
 ---
 
-### REQ-XXX — <Titre>
-- Description : <A REMPLIR - PROJET> (exemple: permettre la connexion utilisateur — a supprimer)
-- Valeur utilisateur : <A REMPLIR - PROJET> (exemple: accès sécurisé — a supprimer)
-- Inclus / Exclus : <A REMPLIR - PROJET> (exemple: inclut login, exclut SSO — a supprimer)
-- Priorité : <A REMPLIR - PROJET> (exemple: Must — a supprimer)
-- Statut : <A REMPLIR - PROJET> (exemple: planned — a supprimer)
-- Impacts (FE/BE/DB/Arch = Frontend/Backend/Base de données/Architecture) : <A COMPLETER PAR AGENT>
-- Dépendances : <A REMPLIR - PROJET> (exemple: aucune — a supprimer)
-- Notes : <A REMPLIR - PROJET> (exemple: MVP — a supprimer)
+### REQ-001 — CRUD Items (objets d'inventaire)
+- Description : Créer, lire, modifier et supprimer des items d'inventaire avec champs essentiels (nom, description, catégorie, localisation, état, prix) <!-- complété par codex -->
+- Valeur utilisateur : Constituer et maintenir la base d'inventaire, fondation du système <!-- complété par codex -->
+- Inclus / Exclus : Inclut formulaire complet, validation, liste paginée, détail item. Exclut recherche avancée (voir REQ-004) <!-- complété par codex -->
+- Priorité : Must
+- Statut : planned
+- Impacts : FE/BE/DB/Arch (structure complète frontend/backend/modèles de données) <!-- complété par codex -->
+- Dépendances : Aucune
+- Notes : MVP - Fondation du système, première exigence à implémenter <!-- complété par codex -->
 
 ---
 
-## Exemple (a supprimer)
-### REQ-001 — Authentification
-- Description : permettre la connexion utilisateur.
-- Valeur utilisateur : accès sécurisé.
+### REQ-002 — Gestion hiérarchique des localisations
+- Description : Créer et organiser les emplacements physiques en hiérarchie (lieu → meuble → tiroir → boîte) avec association aux items <!-- complété par codex -->
+- Valeur utilisateur : Retrouver précisément où se trouve un objet dans la maison <!-- complété par codex -->
+- Inclus / Exclus : Inclut création hiérarchie, navigation arborescente, association item<->location. Exclut plan visuel du domicile <!-- complété par codex -->
 - Priorité : Must
 - Statut : planned
-- Impacts : FE/BE
+- Impacts : FE/BE/DB (nouvelle entité Location avec self-référence) <!-- complété par codex -->
+- Dépendances : REQ-001 (dépend des items)
+- Notes : MVP - Différenciateur clé par rapport aux solutions existantes <!-- complété par codex -->
+
+---
+
+### REQ-003 — Upload et gestion de documents
+- Description : Uploader et associer des fichiers (photos, notices PDF, factures) aux items, avec prévisualisation et téléchargement <!-- complété par codex -->
+- Valeur utilisateur : Centraliser toute la documentation d'un objet, ne plus perdre de notices ou factures papier <!-- complété par codex -->
+- Inclus / Exclus : Inclut upload multipart, stockage fichiers, affichage miniatures, plusieurs fichiers par item. Exclut OCR, reconnaissance automatique <!-- complété par codex -->
+- Priorité : Must
+- Statut : planned
+- Impacts : FE/BE/Arch (gestion fichiers, stockage local) <!-- complété par codex -->
+- Dépendances : REQ-001
+- Notes : MVP - Valeur ajoutée importante pour l'utilisateur <!-- complété par codex -->
+
+---
+
+### REQ-004 — Recherche full-text
+- Description : Rechercher des items par mots-clés dans nom, description, catégorie, localisation avec résultats instantanés <!-- complété par codex -->
+- Valeur utilisateur : Retrouver un objet en quelques secondes sans connaître sa localisation exacte <!-- complété par codex -->
+- Inclus / Exclus : Inclut recherche texte simple avec FTS5 SQLite, filtres par catégorie/état. Exclut recherche sémantique, suggestions intelligentes <!-- complété par codex -->
+- Priorité : Must
+- Statut : planned
+- Impacts : BE/DB (FTS5 SQLite, indexation), FE (barre recherche, résultats temps réel) <!-- complété par codex -->
+- Dépendances : REQ-001, REQ-002
+- Notes : MVP - Fonctionnalité critique pour l'utilisabilité <!-- complété par codex -->
+
+---
+
+### REQ-005 — Gestion des catégories
+- Description : Définir et gérer les catégories/domaines (bricolage, informatique, électronique, cuisine) pour classifier les items <!-- complété par codex -->
+- Valeur utilisateur : Organiser l'inventaire par domaine, filtrer rapidement par type d'objet <!-- complété par codex -->
+- Inclus / Exclus : Inclut CRUD catégories, association item<->catégorie, filtrage liste. Exclut hiérarchie de catégories (flat list pour MVP) <!-- complété par codex -->
+- Priorité : Should
+- Statut : planned
+- Impacts : FE/BE/DB (nouvelle entité Category) <!-- complété par codex -->
+- Dépendances : REQ-001
+- Notes : MVP - Améliore l'organisation mais pas bloquant pour utilisation de base <!-- complété par codex -->
+
+---
+
+### REQ-006 — Dashboard et statistiques
+- Description : Page d'accueil avec vue d'ensemble (nombre d'items par catégorie, valeur totale, alertes stock bas) <!-- complété par codex -->
+- Valeur utilisateur : Vision globale de l'inventaire en un coup d'œil <!-- complété par codex -->
+- Inclus / Exclus : Inclut statistiques de base, graphiques simples. Exclut analytics avancées, export rapports <!-- complété par codex -->
+- Priorité : Should
+- Statut : proposed
+- Impacts : FE/BE (endpoints agrégations) <!-- complété par codex -->
+- Dépendances : REQ-001, REQ-005
+- Notes : Post-MVP - Nice to have mais pas critique <!-- complété par codex -->
+
+---
+
+### REQ-007 — Import/Export données
+- Description : Exporter l'inventaire en CSV/JSON, importer depuis CSV pour migration initiale <!-- complété par codex -->
+- Valeur utilisateur : Migrer depuis solution existante, backup des données, portabilité <!-- complété par codex -->
+- Inclus / Exclus : Inclut export complet, import CSV validé. Exclut import fichiers (traité séparément), synchronisation automatique <!-- complété par codex -->
+- Priorité : Could
+- Statut : proposed
+- Impacts : BE (endpoints export/import), FE (UI download/upload) <!-- complété par codex -->
+- Dépendances : REQ-001
+- Notes : Post-MVP - Utile mais contournable manuellement <!-- complété par codex -->
+
+---
+
+### REQ-008 — Authentification basique (optionnelle)
+- Description : Connexion simple username/password pour protéger l'accès si déploiement accessible depuis l'extérieur <!-- complété par codex -->
+- Valeur utilisateur : Sécuriser l'accès en cas d'exposition réseau <!-- complété par codex -->
+- Inclus / Exclus : Inclut login/logout, session cookie. Exclut multi-utilisateurs, OAuth, MFA <!-- complété par codex -->
+- Priorité : Could
+- Statut : proposed
+- Impacts : FE/BE/Arch (gestion sessions) <!-- complété par codex -->
+- Dépendances : Aucune (orthogonal)
+- Notes : Post-MVP - Optionnel pour usage local strict, nécessaire si reverse proxy public <!-- complété par codex -->
+
+---

product/VISION.md

@@ -10,26 +10,22 @@ Ce document synthétise la vision et les objectifs long terme.
 ---
 
 ## Problème
-- Problème principal : <A REMPLIR - PROJET> (exemple: suivi manuel sur tableur — a supprimer)
-- Pourquoi maintenant : <A REMPLIR - PROJET> (exemple: croissance de l’équipe — a supprimer)
+- Problème principal : Gestion désorganisée de l'inventaire domestique, impossibilité de retrouver rapidement les objets, perte de notices/factures, absence de vision globale du matériel possédé <!-- complété par codex -->
+- Pourquoi maintenant : Accumulation d'équipements dans plusieurs domaines (bricolage, informatique, électronique, cuisine), besoin de structurer avant que la situation devienne ingérable <!-- complété par codex -->
 
 ## Utilisateurs cibles
-- Personas : <A REMPLIR - PROJET> (exemple: gestionnaire stock — a supprimer)
-- Besoins clés : <A REMPLIR - PROJET> (exemple: suivi + alertes — a supprimer)
+- Personas : Particulier organisé, passionné de bricolage/informatique/électronique/cuisine, propriétaire d'un domicile avec matériel conséquent à gérer <!-- complété par codex -->
+- Besoins clés : Retrouver instantanément un objet et sa localisation exacte, consulter notices/factures, connaître le stock disponible, éviter les achats en double <!-- complété par codex -->
 
 ## Proposition de valeur
-- Promesse centrale : <A REMPLIR - PROJET> (exemple: inventaire fiable — a supprimer)
-- Différenciation : <A REMPLIR - PROJET> (exemple: déploiement on-premise — a supprimer)
+- Promesse centrale : "Ne jamais perdre de temps à chercher où se trouve un objet ou sa documentation" - inventaire complet et interrogeable en quelques secondes <!-- complété par codex -->
+- Différenciation : Self-hosted (contrôle total des données), mono-utilisateur (simplicité maximale), focus sur localisation physique précise (meuble/tiroir/boîte), pas de complexité inutile <!-- complété par codex -->
 
 ## Objectifs mesurables
-- Indicateurs (KPI = indicateurs clés) : <A REMPLIR - PROJET> (exemple: taux d’activation 40% — a supprimer)
-- Horizon temporel : <A REMPLIR - PROJET> (exemple: 90 jours — a supprimer)
+- Indicateurs : Temps moyen pour retrouver un objet <30 secondes, 100% des achats importants documentés (facture + notice), taux d'utilisation 3x/semaine minimum <!-- complété par codex -->
+- Horizon temporel : MVP fonctionnel en 3 mois, adoption complète (migration inventaire existant) en 6 mois <!-- complété par codex -->
 
 ## Non-objectifs
-- Ce que le produit ne fera pas : <A REMPLIR - PROJET> (exemple: à personnaliser — a supprimer)
+- Ce que le produit ne fera pas : Gestion multi-utilisateurs avec permissions complexes (v1), synchronisation cloud (self-hosted uniquement), marketplace d'objets, estimation de valeur automatique, intégration e-commerce <!-- complété par codex -->
 
----
-
-## Exemple (a supprimer)
-- Problème : gestion manuelle des stocks.
-- KPI : taux d’activation 40% en 90 jours.
+---