Socle : corpus de recherche en entrée, plan d'implémentation, gitignore

Commit initial de l'existant avant toute modification (règle transverse du
playbook OKI). data/input/ est en lecture seule pour toute la suite du projet.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

.env.example

@@ -0,0 +1,50 @@
+# ─────────────────────────────────────────────────────────────────────────────
+# Veille législative Guadeloupe — variables d'environnement
+# Copier en `.env` et renseigner. Le fichier `.env` n'est JAMAIS versionné.
+# ─────────────────────────────────────────────────────────────────────────────
+
+# ── API Légifrance (PISTE) ───────────────────────────────────────────────────
+# Compte : https://piste.gouv.fr — application abonnée à l'API « Légifrance ».
+# Sans ces deux valeurs le pipeline fonctionne en mode dégradé documenté
+# (repli sur le scraping léger AN / Sénat / Conseil constitutionnel).
+LEGIFRANCE_CLIENT_ID=
+LEGIFRANCE_CLIENT_SECRET=
+# `sandbox` pour l'environnement de test PISTE, `prod` pour la production.
+LEGIFRANCE_ENV=prod
+
+# ── Comportement du pipeline ─────────────────────────────────────────────────
+# Chemin de la base SQLite (relatif à la racine du dépôt).
+VEILLE_DB=data/veille.db
+# Répertoire du cache HTTP des collecteurs.
+VEILLE_CACHE=data/cache_http
+# Durée de validité du cache HTTP, en heures.
+VEILLE_CACHE_TTL_H=6
+# User-agent honnête envoyé aux sources publiques (contact obligatoire).
+VEILLE_USER_AGENT=veille-legislative-971/1.0 (+contact: cyber.mawonaj@gmail.com)
+# Délai minimal entre deux requêtes vers un même hôte, en secondes.
+VEILLE_DELAI_REQUETES=1.0
+# Seuil de similarité de titre pour le rapprochement flou (0.0 → 1.0).
+VEILLE_SEUIL_FUZZY=0.86
+
+# ── Notifications de fin de run (désactivées par défaut) ─────────────────────
+VEILLE_NOTIF_ACTIVE=false
+# Webhook générique (POST JSON). Compatible Matrix via un pont, Mattermost, etc.
+VEILLE_NOTIF_WEBHOOK=
+# Envoi courriel : laisser vide pour désactiver.
+VEILLE_NOTIF_SMTP_HOTE=
+VEILLE_NOTIF_SMTP_PORT=587
+VEILLE_NOTIF_SMTP_UTILISATEUR=
+VEILLE_NOTIF_SMTP_MOTDEPASSE=
+VEILLE_NOTIF_DESTINATAIRE=
+
+# ── Application web (adapter-node, production) ───────────────────────────────
+# Node ≥ 20.6 : lancer avec `node --env-file=.env build`
+HOST=127.0.0.1
+PORT=3971
+# Obligatoire derrière un reverse proxy, sinon « Cross-site POST form
+# submissions are forbidden ». Alternative : PROTOCOL_HEADER + HOST_HEADER.
+ORIGIN=https://veille.example.org
+# PROTOCOL_HEADER=x-forwarded-proto
+# HOST_HEADER=x-forwarded-host
+# Mise en sommeil de l'app sans trafic (activation par socket systemd).
+IDLE_TIMEOUT=300