Initialise le projet : documentation et squelette
Extension Firefox pour publier une sélection d'événements du calendrier Nextcloud de L'Atelier du Huit vers l'agenda de la mairie de Cugnaux. - README : vue d'ensemble et installation - CLAUDE.md : guide agent et contraintes structurantes - docs/RECHERCHE.md : faits techniques vérifiés (CalDAV, formulaire, agenda, ICS) - docs/DECISIONS.md : choix d'architecture et leur pourquoi - package.json : Bun comme outil de dev minimaliste (pas de build au runtime) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
43
README.md
Normal file
43
README.md
Normal file
@@ -0,0 +1,43 @@
|
||||
# Écho du Huit
|
||||
|
||||
Extension Firefox qui aide les bénévoles de **L'Atelier du Huit** (café associatif,
|
||||
Cugnaux) à publier une **sélection** de leurs événements sur l'agenda de la mairie.
|
||||
|
||||
Source des événements : le calendrier Nextcloud du café.
|
||||
Cible : le formulaire « Proposer un événement » du site de la mairie.
|
||||
|
||||
## Le besoin
|
||||
|
||||
Tous les événements du café ne vont pas sur le site de la mairie — seulement
|
||||
certains. L'extension sert de **TODO list** : pour chaque événement à venir, on
|
||||
voit s'il est *à faire*, *soumis*, *publié* (avec le lien direct) ou *ignoré*,
|
||||
et on peut le pousser vers le formulaire mairie en un clic (pré-rempli, à
|
||||
relire et envoyer soi-même).
|
||||
|
||||
## Comment ça marche
|
||||
|
||||
1. L'extension lit le calendrier Nextcloud via la **session du navigateur**
|
||||
(aucun mot de passe stocké).
|
||||
2. Sa page affiche les événements à venir et leur statut.
|
||||
3. Bouton **Créer** → ouvre le formulaire mairie pré-rempli ; tu relis,
|
||||
complètes (image à glisser à la main), puis envoies.
|
||||
4. Bouton **Ignorer** → marque l'événement (tag partagé, visible dans Nextcloud).
|
||||
5. Le statut **publié** est vérifié sur l'agenda public de la mairie.
|
||||
|
||||
## Installation (dev)
|
||||
|
||||
Extension non signée, chargée comme module temporaire :
|
||||
`about:debugging` → *Ce Firefox* → *Charger un module complémentaire temporaire*
|
||||
→ sélectionner `manifest.json`. Pas de build, pas de runtime à installer.
|
||||
|
||||
## Documentation
|
||||
|
||||
- [`docs/RECHERCHE.md`](docs/RECHERCHE.md) — faits techniques vérifiés (CalDAV,
|
||||
champs du formulaire, valeurs du dropdown thème, structure de l'agenda, cas
|
||||
limites de l'ICS).
|
||||
- [`docs/DECISIONS.md`](docs/DECISIONS.md) — choix d'architecture et leur pourquoi.
|
||||
- [`CLAUDE.md`](CLAUDE.md) — guide pour les agents qui implémentent.
|
||||
|
||||
## Suivi
|
||||
|
||||
Backlog géré dans Piaire : http://localhost:3117/perso/project/echo-du-huit
|
||||
Reference in New Issue
Block a user