jardin/codex.md

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