232 lines
9.7 KiB
Markdown
232 lines
9.7 KiB
Markdown
# HomeHub — Plan de développement
|
||
|
||
> Approche itérative : chaque phase livre quelque chose d'utilisable.
|
||
> Stack : FastAPI · React/Vite/TS · PostgreSQL 16 · Docker Compose
|
||
|
||
---
|
||
|
||
## Phase 1 — Socle technique ✅
|
||
|
||
**Objectif** : environnement opérationnel, rien de métier, mais tout tourne.
|
||
|
||
### Backend
|
||
- [x] Structure projet FastAPI (`app/api/`, `app/core/`, `app/models/`, `app/schemas/`, `app/services/`)
|
||
- [x] Configuration SQLAlchemy 2.0 async + pool de connexions
|
||
- [x] Création des schémas PostgreSQL (`todos`, `shopping`, `notes`) via Alembic
|
||
- [x] Migration initiale : toutes les tables (voir spec section 3)
|
||
- [x] Endpoint santé : `GET /api/health`
|
||
- [x] Module media (`app/services/media.py`) :
|
||
- [x] Validation des formats acceptés (JPG, PNG, SVG, WebP, WebM, M4A)
|
||
- [x] Génération miniature Pillow : 150×150 (shopping), 300×300 (notes), 400×300 (inline)
|
||
- [x] Sauvegarde `originals/` + `thumbnails/` sur le volume
|
||
- [x] Endpoint `POST /api/media/upload` → retourne `{ file_path, thumbnail_path }`
|
||
- [x] Endpoint `DELETE /api/media/{uuid}` → supprime original + miniature
|
||
- [x] Middleware CORS pour réseau local `10.0.0.0/22`
|
||
- [x] Configuration via variables d'environnement (`.env`)
|
||
- [x] Dockerfile backend (Python 3.12 slim)
|
||
|
||
### Frontend
|
||
- [x] Scaffold Vite + React 18 + TypeScript
|
||
- [x] Tailwind CSS configuré avec les tokens Gruvbox (via `tokens.json`)
|
||
- [x] Intégration `design_system/components/ui-kit.jsx`
|
||
- [x] `@vite-pwa/plugin` configuré (Service Worker + manifest)
|
||
- [x] `manifest.json` avec icônes iOS + Android
|
||
- [x] Routage React Router v6
|
||
- [x] Layout de base : navigation mobile (bottom bar) + navigation laptop (sidebar)
|
||
- [x] Dockerfile frontend (Nginx + proxy `/api/` → backend)
|
||
- [x] Favicon maison (SVG Gruvbox orange)
|
||
|
||
### Infra
|
||
- [x] `docker-compose.yml` avec 3 services (frontend, backend, db)
|
||
- [x] Volume PostgreSQL persistant
|
||
- [x] Volume uploads persistant (`/uploads/`)
|
||
- [x] Fichier `.env.example`
|
||
- [x] Script de seed (`backend/app/data/seed.py`) : 113 produits + 9 magasins
|
||
|
||
---
|
||
|
||
## Phase 2 — Module Todos ✅
|
||
|
||
**Objectif** : créer, lister, modifier, terminer et reporter des tâches depuis mobile et laptop.
|
||
|
||
### Backend
|
||
- [x] `GET /api/todos` — liste avec filtres (domaine, statut, priorité, tags, période)
|
||
- [x] `POST /api/todos` — création
|
||
- [x] `PATCH /api/todos/{id}` — mise à jour partielle
|
||
- [x] `DELETE /api/todos/{id}` — suppression
|
||
- [x] `POST /api/todos/{id}/postpone` — incrémente postponed_count + décale due_date
|
||
- [x] Schémas Pydantic : TodoCreate, TodoUpdate, TodoResponse
|
||
- [x] Tests d'intégration (9 tests)
|
||
|
||
### Frontend Mobile
|
||
- [x] Page Todos : liste des tâches en cours, groupées par domaine
|
||
- [x] Bouton "+ Tâche" flottant → Modal création (titre + domaine + date + priorité + tags)
|
||
- [x] Double-tap → Modal édition pré-rempli
|
||
- [x] Swipe droite → marquer done
|
||
- [x] Swipe gauche → actions (reporter 1j / reporter 1 semaine / supprimer)
|
||
- [x] Badge compteur par domaine
|
||
|
||
### Frontend Laptop
|
||
- [x] Vue tableau avec filtres : domaine, statut, priorité, période
|
||
- [x] Formulaire complet (tous les champs) via Modal
|
||
- [x] Double-clic sur titre → Modal édition
|
||
- [x] Actions inline : ✓ done / +1j / +1S / ✕ supprimer
|
||
|
||
---
|
||
|
||
## Phase 3 — Module Shopping (liste de courses) ✅
|
||
|
||
**Objectif** : liste de courses fonctionnelle en magasin depuis smartphone, avec génération automatique.
|
||
|
||
### Backend
|
||
- [x] `GET /api/shopping/stores` — liste magasins
|
||
- [x] `GET /api/shopping/products` — catalogue avec recherche (param `q`)
|
||
- [x] `GET /api/shopping/lists` — listes de courses avec compteurs
|
||
- [x] `POST /api/shopping/lists` — création liste
|
||
- [x] `GET /api/shopping/lists/{id}` — détail liste avec articles
|
||
- [x] `PATCH /api/shopping/lists/{id}` — mise à jour liste
|
||
- [x] `DELETE /api/shopping/lists/{id}` — suppression
|
||
- [x] `POST /api/shopping/lists/{id}/items` — ajout article (produit catalogue ou custom)
|
||
- [x] `PATCH /api/shopping/lists/{id}/items/{item_id}` — cocher / modifier
|
||
- [x] `DELETE /api/shopping/lists/{id}/items/{item_id}` — suppression article
|
||
- [x] `POST /api/shopping/lists/{id}/finish` — terminer les courses (report articles non cochés → nouvelle liste draft avec `carried_over=True`)
|
||
- [x] `POST /api/shopping/lists/generate` — liste magique V1 (score = retard / intervalle moyen, articles cochés comme historique)
|
||
- [x] Schémas Pydantic complets (listes, articles, produits, magasins)
|
||
- [x] Tests d'intégration (10 tests)
|
||
|
||
### Frontend
|
||
- [x] Page Shopping avec 3 vues : liste des listes / détail / mode magasin
|
||
- [x] Vue "listes" : cartes par liste (statut, compteur articles), FAB + bouton "Liste magique"
|
||
- [x] Bouton "Liste magique" : désactivé si une liste `draft`/`active` existe
|
||
- [x] Vue "détail" : articles avec swipe-to-delete, FAB ajout article, bouton ✏️ modal gestion
|
||
- [x] Modal ✏️ : ajout rapide d'article + bouton rouge "Supprimer la liste en cours"
|
||
- [x] Vue "Mode magasin" : plein écran, grands boutons (48px+), section cochés/non cochés
|
||
- [x] Wake Lock API activée automatiquement en mode magasin
|
||
- [x] Composant `Modal` générique réutilisable (overlay + Escape + stopPropagation)
|
||
- [x] Composant `ItemRow` : checkbox circulaire + swipe-to-delete + mode magasin
|
||
- [x] Hook `useWakeLock` avec fallback gracieux (mode économie d'énergie)
|
||
- [x] Client API TypeScript typé (`frontend/src/api/shopping.ts`)
|
||
- [x] Migration TodoForm vers Modal (plus de panneau inline)
|
||
|
||
---
|
||
|
||
## Phase 4 — Module Notes ✅
|
||
|
||
**Objectif** : saisie rapide de notes avec photo, audio et GPS depuis smartphone.
|
||
|
||
### Backend
|
||
- [x] `GET /api/notes` — liste avec search full-text + filtres tags/catégorie
|
||
- [x] `POST /api/notes` — création
|
||
- [x] `PATCH /api/notes/{id}` — mise à jour
|
||
- [x] `DELETE /api/notes/{id}` — suppression
|
||
- [x] `POST /api/notes/{id}/attachments` — upload fichier (image/audio)
|
||
- [x] `DELETE /api/notes/{id}/attachments/{att_id}` — suppression pièce jointe
|
||
- [x] Compression image Pillow → WebP (service media partagé)
|
||
- [x] Recherche FTS PostgreSQL français
|
||
|
||
### Frontend Mobile
|
||
- [x] Page Notes : liste chronologique avec aperçu
|
||
- [x] Bouton "+ Note" → formulaire rapide (contenu + tags) via Modal
|
||
- [x] Bouton 📷 → Camera API (capture directe ou import galerie)
|
||
- [x] Bouton 🎤 → MediaRecorder (enregistrement audio inline)
|
||
- [x] Bouton 📍 → Geolocation API → affichage coordonnées
|
||
- [x] Visionneuse photo inline + lecteur audio inline
|
||
- [ ] Compression WebP côté client (Canvas API) — différé Phase 5+
|
||
- [ ] Waveform visuel enregistrement — différé Phase 5+
|
||
|
||
### Frontend Laptop
|
||
- [x] Grille notes avec vignettes photo
|
||
- [x] Recherche full-text
|
||
- [x] Filtres rapides : avec photo, avec audio, avec GPS
|
||
- [ ] Vue carte pour les notes avec GPS (Leaflet.js) — différé Phase 5+
|
||
|
||
---
|
||
|
||
## Phase 5 — Scan produits + enrichissement catalogue
|
||
|
||
**Objectif** : scan code-barres depuis mobile, auto-remplissage depuis OpenFoodFacts.
|
||
|
||
### Services Docker
|
||
- [ ] Dockerfile `product-search/` : Python slim + `requests` + client OpenFoodFacts
|
||
- [ ] Ajout service `product-search` dans `docker-compose.yml` (port 8002)
|
||
- [ ] Ajout service `searxng` dans `docker-compose.yml` (images uniquement)
|
||
|
||
### Backend (endpoints proxy)
|
||
- [ ] `GET /api/products/lookup?barcode=` → proxifie vers product-search
|
||
- [ ] `GET /api/products/search?q=` → proxifie vers product-search
|
||
- [ ] `POST /api/products/import` → crée produit depuis données OpenFoodFacts
|
||
|
||
### Frontend Mobile — scan
|
||
- [ ] Intégration `zxing-js` (BarcodeReader via flux caméra)
|
||
- [ ] Bouton "Scanner" dans le formulaire d'ajout de produit
|
||
- [ ] Sur scan réussi → auto-remplissage formulaire
|
||
|
||
### Frontend Laptop — enrichissement catalogue
|
||
- [ ] CRUD complet produits dans catalogue
|
||
- [ ] Recherche texte → OpenFoodFacts → import 1 clic
|
||
- [ ] Gestion magasins
|
||
|
||
---
|
||
|
||
## Phase 6 — Service OCR (conteneur dédié)
|
||
|
||
**Objectif** : OCR partagé, prérequis pour shopping avancé et notes avancées.
|
||
|
||
- [ ] Dockerfile `ocr/` : Python slim + Tesseract 5 + langues (fra, eng) + Pillow
|
||
- [ ] `POST /extract` : reçoit image (multipart), retourne `{ text, confidence }`
|
||
- [ ] Endpoint backend `POST /api/ocr/extract` : proxifie vers `ocr:8001`
|
||
- [ ] Ajout du service `ocr` dans `docker-compose.yml`
|
||
|
||
---
|
||
|
||
## Phase 7 — Shopping avancé (OCR + suivi prix)
|
||
|
||
### Backend
|
||
- [ ] `POST /api/shopping/ocr/price-tag` — photo étiquette → extraction prix
|
||
- [ ] `POST /api/shopping/ocr/receipt` — photo ticket → reconciliation liste
|
||
- [ ] `GET /api/shopping/products/{id}/price-history` — historique prix par produit + magasin
|
||
|
||
### Frontend
|
||
- [ ] Bouton 📷 sur chaque article → OCR étiquette → pré-remplissage prix
|
||
- [ ] Graphique d'évolution du prix par produit (Recharts)
|
||
- [ ] Comparaison prix par magasin
|
||
|
||
---
|
||
|
||
## Phase 8 — MCP Server
|
||
|
||
**Objectif** : exposer les outils HomeHub aux agents IA (Hermes, Claude, etc.).
|
||
|
||
- [ ] Intégration SDK MCP Python (`mcp` package)
|
||
- [ ] Endpoint SSE `/mcp`
|
||
- [ ] Implémentation des outils : `get_todos()`, `add_todo()`, `add_shopping_item()`, `search_notes()`
|
||
- [ ] Documentation OpenAPI des outils MCP
|
||
|
||
---
|
||
|
||
## Phases futures (hors scope initial)
|
||
|
||
### Phase 9 — Authentification multi-utilisateurs
|
||
- Auth JWT (login / refresh token)
|
||
- Activation de `owner_id` dans toutes les tables
|
||
- Page connexion React
|
||
|
||
### Phase 10 — Calendrier + intégrations
|
||
- Sync Google Calendar (OAuth2 + worker)
|
||
- Endpoint CalDAV pour iOS
|
||
- Redis pour la queue de synchronisation
|
||
- Webhooks Gitea → Kanban
|
||
- Home Assistant : capteur "tâches en retard"
|
||
|
||
### Phase 11 — Vision IA
|
||
- Endpoint analyse frigo (photo → suggestions liste de courses)
|
||
- Amélioration OCR via modèle Vision local (Ollama)
|
||
|
||
---
|
||
|
||
## Ordre de développement
|
||
|
||
```
|
||
Phase 1 ✅ → Phase 2 ✅ → Phase 3 ✅ → Phase 4 (Notes) → Phase 5 (Scan) → Phase 6 (OCR) → Phase 7 (Shopping avancé) → Phase 8 (MCP)
|
||
```
|