# Consigne ClaudeCode — Développement d’une Web App de gestion de jardins

## Objectif
Concevoir et développer une **web app hébergée**, en **français**, **responsive mobile-first** (compatible smartphone), permettant de gérer un ou plusieurs jardins (plein air et serre), leurs cultures, les plants, les tâches et la planification.

---

## Contraintes globales

- **Langue UI** : Français.
- **Plateformes** : Web (desktop + smartphone), PWA souhaitée.
- **Hébergement** : application auto-hébergeable (Docker recommandé).
- **Design** : thème **Gruvbox Dark – seventies**.
- **Sécurité** : authentification utilisateur, permissions minimales, sauvegardes.
- **Architecture** : API + frontend séparés (ou monolithe propre), documentation incluse.

---

## Vision produit

L’application doit centraliser :

1. La gestion des jardins (zones, caractéristiques, météo locale).
2. Le suivi des plants (variétés, stades, actions culturales).
3. Le planning (plantation, entretien, récolte, tâches).
4. Une aide à la décision (saisons, calendrier lunaire, alertes).

---

## Fonctionnalités attendues

## 1) Gestion des jardins

Pour chaque jardin :

- Nom, description.
- Type : **plein air** ou **serre**.
- Coordonnées géographiques (lat/lon).
- Adresse facultative.
- Photos/images.
- Exposition (N, NE, E, SE, S, SO, O, NO + heures d’ensoleillement).
- Température du sol (manuel + capteur possible).
- Température de l’air (manuel + capteur possible).
- Humidité (air et/ou sol si dispo).

### Géométrie du jardin (mode “cases”)

- Représentation en grille (cases).
- Dimensions configurables (ex: 10x20 cases).
- Chaque case peut avoir : culture en place, état, historique, notes.
- Vue visuelle couleur par culture/stade/occupation.

---

## 2) Gestion des plants et cultures

Pour chaque variété/plant :

- Nom commun + nom botanique.
- Type (légume, fruit, aromatique, fleur, etc.).
- Variété/cultivar.
- Durée de germination estimée.
- Besoins (eau, température, ensoleillement, espacement).
- Compatibilités/incompatibilités de culture.
- Périodes recommandées (semis, repiquage, récolte).

### Suivi cycle de vie

- Semis
- Repiquage
- Croissance
- Floraison/fructification
- Récolte
- Fin de culture

Historique horodaté des événements par plant/zone/case.

---

## 3) Planning & tâches

- Création de tâches (ponctuelles/récurrentes).
- Catégories : semis, arrosage, taille, traitement, récolte, observation, maintenance serre.
- Priorités, échéances, rappels.
- Vue liste + kanban + agenda.
- Liaison tâche ↔ jardin/zone/plant/case.

---

## 4) Calendrier cultural + calendrier lunaire

- Calendrier mensuel des actions recommandées.
- Intégration d’un **calendrier lunaire** (jours racine/feuille/fleur/fruit, etc.).
- Suggestion d’actions selon type de culture + phase lunaire.
- Paramétrable (activer/désactiver influence lunaire).

---

## 5) Tableaux de bord

- Vue “Aujourd’hui” : tâches du jour, alertes, actions à faire.
- Vue “Jardin” : état d’occupation des cases, cultures en cours.
- Vue “Récoltes” : prévisions et historique.
- Indicateurs : taux d’occupation, tâches en retard, rendement estimé.

---

## 6) Média & observations

- Upload photos par jardin/plant/tâche.
- Galerie filtrable.
- Notes libres datées (journal de culture).

---

## 7) Brainstorming d’améliorations (roadmap)

- Détection de variétés par photo (IA).
- Détection maladies/carences via photo.
- OCR d’étiquettes de semences.
- Connexion capteurs (temp sol/air, humidité, météo locale).
- Alertes intelligentes (gel, stress hydrique, canicule).
- Suggestions automatiques de rotation des cultures.
- Gestion de stock (graines, substrats, engrais).
- Export PDF/CSV des plannings et historiques.
- Multi-utilisateurs / partage familial.
- Mode hors-ligne (PWA) + synchro.

---

## Exigences UX/UI

- Mobile-first (navigation simple au pouce).
- Performances correctes sur smartphone milieu de gamme.
- Accessibilité (contraste, taille police, focus clavier).
- Thème visuel : **Gruvbox Dark seventies** (palette cohérente sur toute l’app).

### Référence thème (indicative)

- Background principal: `#282828`
- Background secondaire: `#3c3836`
- Texte principal: `#ebdbb2`
- Texte secondaire: `#a89984`
- Accent vert: `#b8bb26`
- Accent jaune: `#fabd2f`
- Accent bleu: `#83a598`
- Accent orange: `#fe8019`
- Erreur rouge: `#fb4934`

---

## Exigences techniques

- API documentée (OpenAPI souhaité).
- Base de données relationnelle (PostgreSQL recommandé).
- Stockage images local ou S3-compatible.
- Auth sécurisée (session ou JWT), gestion des rôles.
- Logs, monitoring, sauvegarde/restauration.
- Déploiement Docker Compose.
- Tests minimaux (unitaires + parcours critiques).

---

## Livrables attendus

1. Cahier d’architecture technique.
2. Schéma de données (ERD).
3. Maquettes principales (mobile + desktop).
4. MVP fonctionnel déployable.
5. Documentation d’installation/exploitation.
6. Backlog priorisé (MVP / V2 / V3).

---

## Priorisation MVP (ordre conseillé)

1. Auth + gestion des jardins.
2. Grille des cases + cultures.
3. Fiches plants.
4. Tâches + planning.
5. Journal + photos.
6. Calendrier lunaire simple.
7. Tableau de bord.

---

## Critères de réussite

- Utilisable à 100% depuis smartphone.
- Suivi complet d’un cycle cultural réel.
- Planification claire des tâches et récoltes.
- Interface stable, rapide, compréhensible.
- Base saine pour extensions IA/capteurs.