29 lines
1.8 KiB
Markdown
29 lines
1.8 KiB
Markdown
# 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.
|