# Codex - Elements développes

Ce document liste les éléments développés dans le projet `jardin`.

## 1) Calendrier lunaire

- Script principal: `calendrier_lunaire/lunar_calendar.py`
- Tests: `calendrier_lunaire/test_lunar_calendar.py`
- Sorties JSON générées:
  - `calendrier_lunaire/calendrier_lunaire_2026.json`
  - `calendrier_lunaire/calendrier_lunaire_2027.json`
- Données/ressources:
  - `calendrier_lunaire/de421.bsp`
  - `calendrier_lunaire/deep_search.md`
  - `calendrier_lunaire/deep_search1.md`

### Fonctions/évolutions intégrées
- Calcul des phases lunaires (nouvelle lune, quartiers, pleine lune)
- Génération annuelle en JSON
- Ajout des données saints du jour
- Ajout lever/coucher soleil et lune + durées
- Ajout transitions intra-journée (jour type / montante-descendante)
- Alignement zodiacal sidéral (constellations)

## 2) Saints et dictons

Dossier dédié: `calendrier_lunaire/saints_dictons/`

- Sources et consignes:
  - `calendrier_lunaire/saints_dictons/consigne_scrap_saint_dictons.md`
  - `calendrier_lunaire/saints_dictons/saints_france.json`
- Parsing:
  - `calendrier_lunaire/saints_dictons/parse_saints_dictons.py`
- Scraping annuel:
  - `calendrier_lunaire/saints_dictons/saint_dicton_year_scraper.py`
- Exemple de sortie:
  - `calendrier_lunaire/saints_dictons/saints_2026.json`
- Exports JSON séparés:
  - `calendrier_lunaire/saints_dictons/saints_du_jour.json`
  - `calendrier_lunaire/saints_dictons/dictons_du_jour.json`
- Scripts hors webapp:
  - `calendrier_lunaire/saints_dictons/export_saints_dictons_json.py`
  - `calendrier_lunaire/saints_dictons/import_saints_dictons_db.py`

### Fonctions/évolutions intégrées
- Format JSON cible: `date`, `saints[]`, `dictons[]`
- Support de formats de date multiples
- Ajout de logs de progression dans le scraper
- Enregistrement JSON (pas uniquement affichage terminal)
- Génération de 2 jeux de données dédiés (saints / dictons)
- Import automatisé en SQLite (`replace` ou `append`)
- Création table `saint_du_jour` si absente + alimentation table `dicton`

## 3) Prévisions météo Open-Meteo

- Script: `prevision meteo/open_meteo_garden_forecast.py`
- Consignes:
  - `prevision meteo/consigne.md`
  - `prevision meteo/consigne_open_meteo.md`
- Mapping WMO:
  - `prevision meteo/wmo_code.json`
- Exemple de sortie:
  - `prevision meteo/prevision meteo/output/forecast.json`

### Fonctions/évolutions intégrées
- Appel Open-Meteo avec variables hourly/current étendues
- Intégration `past_days` + `forecast_days`
- Affichage tableau synthétique
- Export JSON complet
- Correction de sérialisation JSON

## 4) Station météo locale (WeeWX)

- Script: `station_meteo/local_station_weather.py`

### Fonctions/évolutions intégrées
- Récupération des données actuelles (RSS)
- Récupération et parsing des résumés quotidiens
- Récupération de données journalières par date via option CLI
- Valeur par défaut: date de la veille si non fournie
- Normalisation des types (float/int)
- Structure JSON clarifiée: suppression de `yesterday`, ajout `day_data.date` (date complète)
- Enrichissement des blocs: `current`, `stats_today`, `astrology`, `station_info`

## 5) YOLO - Détection feuille/plante

Dossier: `test_yolo/`

- Script test: `test_yolo/test_yolo_leaf.py`
- Documentation: `test_yolo/README.md`
- Données images: `test_yolo/image/`
- Sorties:
  - `test_yolo/test_yolo/output/detections.json`
  - `test_yolo/test_yolo/output/annotated.jpg`

### Fonctions/évolutions intégrées
- Migration vers `ultralytics` (sans `ultralyticsplus`)
- Support modèle local ou repo Hugging Face (`best.pt`)
- Sortie JSON des détections
- Génération image annotée
- Traduction des labels vers le français (`class_name_fr`)

## 6) Assets icônes

- Icônes lune: `icons/moon/*.svg`
  - `new_moon.svg`, `waxing_crescent.svg`, `first_quarter.svg`, `waxing_gibbous.svg`, `full_moon.svg`, `waning_gibbous.svg`, `last_quarter.svg`, `waning_crescent.svg`
- Icônes météo: `icons/weather/*.svg`
  - Codes WMO usuels + `risque_canicule.svg` + `risque_gèle.svg`

## 7) Notes de pilotage

- Plan d'amélioration: `amelioration.md`
- Plan météo/astuces: `avancement.md` (contient plan + logs de session)

## 8) Webapp - évolutions récentes

### Planning
- `frontend/src/views/PlanningView.vue`
- Passage en vue 4 semaines (28 jours)
- Navigation par période: `Prev`, `Today`, `Next`
- Sélection d'un jour avec panneau "Détail du jour"
- Marqueurs visuels par tâches non terminées (ronds colorés par priorité)

### Outils
- `frontend/src/views/OutilsView.vue`
- Le champ notice est désormais une zone de texte libre (`notice_texte`)
- Conserve compatibilité lecture des anciennes notices fichier (`notice_fichier_url`)
- Test backend ajouté: `backend/tests/test_tools.py::test_tool_with_notice_texte`

### Réglages
- `backend/app/routers/settings.py`
- `frontend/src/views/ReglagesView.vue`
- Sauvegarde ZIP téléchargeable (BDD + uploads + fichiers texte + manifeste)
- Liens rapides de test API backend:
  - Swagger: `/docs`
  - ReDoc: `/redoc`
  - Santé: `/api/health`