# HomeStock

Application web self-hosted de gestion d'inventaire domestique permettant de cataloguer équipements, matériels et consommables avec localisation précise et archivage de documents. <!-- complété par codex -->

---

## Légende des zones
- `<A REMPLIR - PROJET> (exemple: à personnaliser — a supprimer)` : à compléter par toi selon le projet.
- `<A COMPLETER PAR AGENT>` : à compléter par un agent spécialisé architecture / dev.

---

## Objectif
- Problème : Gestion désorganisée de l'inventaire domestique, difficulté à retrouver les objets, perte de notices/factures, absence de suivi des stocks <!-- complété par codex -->
- Public cible : Particulier gérant son domicile, domaines bricolage/informatique/électronique/cuisine <!-- complété par codex -->

## Démarrage rapide
- Prérequis : Docker 29.1.5+, Docker Compose, ou Python 3.11+ + Node.js 20+ pour développement sans Docker <!-- complété par codex -->
- Lancer en local : `docker-compose up` ou `make dev` (en développement : backend sur :8000, frontend sur :5173) <!-- complété par codex -->

## Documentation
- Contexte : `PROJECT_CONTEXT.md`
- Vision : `product/VISION.md`
- Architecture : `docs/ARCHITECTURE.md`
- Backlog : `product/BACKLOG.md`
- Workflow : `docs/WORKFLOW.md`

---