Files
jardin/codex.md
2026-02-22 22:18:32 +01:00

138 lines
5.0 KiB
Markdown

# 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`