# Consignes de maintenance

- Mettre à jour `docs/crealead-caldav.md` lors de toute évolution impactant
  `crealead-caldav.py`, notamment ses pré-requis, sa configuration, son
  lancement, le traitement des événements, ses sorties CSV, sa journalisation
  ou ses tests dans `tests/`.
- Garder les exemples de configuration, les commandes d'exécution et les cas
  de test documentés cohérents avec le comportement du script.
- Chaque nouvelle ligne écrite dans `logs/crealead-caldav.log` doit commencer
  par l'heure d'écriture en UTC au format ISO 8601 avec suffixe `Z`, entre
  crochets. Le format par défaut est :
  `[2026-10-15T12:34:56Z]: [info] - message`.
  Cela s'applique aux sorties standard et d'erreur ainsi qu'aux lignes des
  traces d'exception.
- Tout événement non exporté doit laisser une trace au format
  `[2026-10-15T12:34:56Z]: [warning][event] - message`, sans préfixe `[info]`
  supplémentaire. Préciser le calendrier concerné, le titre, le moment de
  l'événement (début et fin disponibles) et la raison de son exclusion.
  Ajouter le fichier CSV et l'UID pour faciliter son identification.
- Ne jamais ignorer silencieusement un événement, notamment en cas de
  `SUMMARY` absent, de dates absentes ou invalides, de document iCalendar
  illisible ou d'export CSV interrompu. Récupérer les métadonnées disponibles
  dans les données brutes si nécessaire et indiquer `indisponible` pour celles
  qui ne peuvent pas être retrouvées. Échapper les retours à la ligne des
  métadonnées et du motif pour conserver un avertissement sur une seule ligne.
- Lors d'une évolution du traitement des événements ou de la journalisation,
  vérifier dans les tests que les événements écartés sont bien tracés avec les
  informations et les préfixes ci-dessus.