gilles
b468104931
- README : fonctionnalités enrichies avec thème, UX mobile, version actuelle - plan.md : phase 3 complétée (tags, photo HEIC, Ctrl+V, bottom sheet multi-select) - plan.md : nouvelle phase 4b UX transversale (ThemeContext, ConfigPage, TopBar, keyboard fix, "Pas de date", nginx media fix) - plan.md : ordre de développement mis à jour (phases 1-4b ✅) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
133 lines
5.3 KiB
Markdown
133 lines
5.3 KiB
Markdown
# HomeHub
|
|
|
|
Application d'organisation personnelle auto-hébergée — PWA mobile-first déployée sur Proxmox 9.
|
|
|
|
## Fonctionnalités (v0.5.1)
|
|
|
|
- **Todos** — tâches classées par domaine, priorité, date objectif, photo, GPS. Swipe gauche = éditer, swipe droite = terminer.
|
|
- **Liste de courses** — générée automatiquement depuis les habitudes d'achat (liste magique), mode magasin plein-écran avec Wake Lock, catalogue enrichi avec tags et stats d'achat, bottom sheet multi-select.
|
|
- **Notes** — saisie rapide avec photo (Ctrl+V ou appareil photo), audio, GPS et métadonnées libres.
|
|
- **Paramètres** — thème dark / light / system, taille de police ajustable avec aperçu temps réel.
|
|
- **MCP Server** — expose les données à des agents IA (Hermes, Claude, etc.) — *à venir*
|
|
|
|
### UX mobile
|
|
- Touch targets 48px minimum, swipe gestures sur toutes les listes
|
|
- Bottom sheet qui remonte automatiquement au-dessus du clavier virtuel iOS
|
|
- Collage d'image par Ctrl+V dans les formulaires Todo et Catalogue
|
|
- Wake Lock API (écran allumé en mode magasin)
|
|
|
|
## Stack technique
|
|
|
|
| Composant | Technologie |
|
|
|-----------|-------------|
|
|
| Frontend | React 18 + Vite + TypeScript + Tailwind CSS |
|
|
| Backend | Python 3.12 + FastAPI (async) |
|
|
| Base de données | PostgreSQL 16 (schémas multiples) |
|
|
| Migrations | Alembic |
|
|
| OCR | Tesseract 5 (service Docker dédié, partagé entre modules) |
|
|
| Scan code-barres | zxing-js (frontend, iOS + Android) |
|
|
| Catalogue produits | OpenFoodFacts API (~3M produits alimentaires) |
|
|
| Recherche image | SearXNG (auto-hébergé, fallback image produits) |
|
|
| Déploiement | Docker Compose · Nginx Proxy Manager |
|
|
| Design system | Gruvbox seventies (`design_system/`) |
|
|
|
|
## Démarrage rapide
|
|
|
|
```bash
|
|
cd ~/Documents/projet/home_hub
|
|
|
|
# Lancer l'app (première fois ou après un arrêt)
|
|
docker compose up -d
|
|
|
|
# Frontend → http://localhost:3001 (ou http://<IP-locale>:3001 sur le réseau)
|
|
# API Swagger → http://localhost:8000/docs
|
|
```
|
|
|
|
**Après modification du code :**
|
|
```bash
|
|
# Rebuild + relancer un service
|
|
docker compose build backend && docker compose up -d backend
|
|
docker compose build frontend && docker compose up -d frontend
|
|
|
|
# Rebuild tout
|
|
docker compose build && docker compose up -d
|
|
```
|
|
|
|
**Maintenance :**
|
|
```bash
|
|
docker compose down # Arrêter (données conservées)
|
|
docker compose logs -f # Logs en direct
|
|
docker compose ps # État des conteneurs
|
|
```
|
|
|
|
## Structure du projet
|
|
|
|
```
|
|
home_hub/
|
|
├── ocr/
|
|
│ ├── app.py # Service FastAPI OCR (Tesseract + Pillow)
|
|
│ └── Dockerfile
|
|
├── product-search/
|
|
│ ├── app.py # Client OpenFoodFacts + proxy SearXNG images
|
|
│ └── Dockerfile
|
|
├── backend/
|
|
│ ├── app/
|
|
│ │ ├── api/ # Endpoints par domaine (todos, shopping, notes, media, mcp)
|
|
│ │ ├── core/ # Config, base de données, middleware
|
|
│ │ ├── models/ # Modèles SQLAlchemy
|
|
│ │ ├── schemas/ # Schémas Pydantic
|
|
│ │ └── services/
|
|
│ │ ├── media.py # Upload, compression, génération miniatures (Pillow)
|
|
│ │ ├── ocr.py # Client vers service ocr:8001
|
|
│ │ └── ... # Suggestions shopping, sync calendrier (futur)
|
|
│ ├── alembic/ # Migrations de base de données
|
|
│ ├── Dockerfile
|
|
│ └── requirements.txt
|
|
├── frontend/
|
|
│ ├── src/
|
|
│ │ ├── components/ # Composants React
|
|
│ │ ├── pages/ # Pages par module
|
|
│ │ ├── hooks/ # Hooks personnalisés (camera, geolocation, wake-lock…)
|
|
│ │ └── api/ # Client API typé
|
|
│ ├── public/
|
|
│ │ └── manifest.json
|
|
│ ├── Dockerfile
|
|
│ └── vite.config.ts
|
|
├── design_system/ # Design system Gruvbox seventies (tokens + composants)
|
|
├── docs/
|
|
│ ├── spec.md # Spécification fonctionnelle complète
|
|
│ └── plan.md # Plan de développement par phases
|
|
├── docker-compose.yml
|
|
├── docker-compose.dev.yml
|
|
└── .env.example
|
|
```
|
|
|
|
## Documentation
|
|
|
|
- [Spécification fonctionnelle](docs/spec.md) — features détaillées, schéma DB, interfaces
|
|
- [Plan de développement](docs/plan.md) — phases et tâches
|
|
- [Design system](design_system/README.md) — composants et règles visuelles
|
|
- API REST : `http://localhost:8000/docs` (Swagger auto-généré par FastAPI)
|
|
|
|
## Déploiement (Proxmox)
|
|
|
|
```bash
|
|
# Production
|
|
docker compose up -d
|
|
|
|
# Nginx Proxy Manager pointe vers :
|
|
# homehub.local → frontend:3000
|
|
# homehub.local/api → backend:8000
|
|
# homehub.local/mcp → backend:8000/mcp (pour les agents IA)
|
|
```
|
|
|
|
## Évolutions prévues
|
|
|
|
- **Phase 5** — Scan code-barres (zxing-js) + enrichissement catalogue via OpenFoodFacts
|
|
- **Phase 6** — Service OCR dédié (Tesseract 5, conteneur partagé)
|
|
- **Phase 7** — Shopping avancé : OCR étiquettes prix, historique et comparaison prix par magasin
|
|
- **Phase 8** — MCP Server : outils IA (`get_todos`, `add_shopping_item`, `search_notes`…)
|
|
- **Phase 9** — Authentification multi-utilisateurs (JWT)
|
|
- **Phase 10** — Calendrier : sync Google Calendar + CalDAV iOS, intégration Home Assistant, webhooks Gitea
|
|
- **Phase 11** — Vision LLM : analyse frigo → suggestions liste de courses (Hermes/Ollama)
|