veye-lalwa/PLAN-IMPLEMENTATION.md

Plan d'implémentation — Plateforme « Veille Législative Guadeloupe »

Phase 0 du prompt prompt-kimi-cli-veille-legislative.md. Rédigé le 25 juillet 2026. Statut : en attente de validation.

---

A. Rapport de lecture du corpus (Phase 0)

A.1 Volumétrie réelle

Ensemble	Fichiers	Mots	Rôle retenu
Rapport consolidé	.agent.final.md (+ .converted.md, doublon)	38 271	Source de vérité rédactionnelle (résumés, points clés)
Chapitres	sec00 → sec10	28 642	sec10 = parsing prioritaire (2 tableaux structurés) ; sec00 = synthèse
Bibliographie	_ref.md	9 591	481 références numérotées [N] Éditeur. Titre [EB/OL]. Date. URL
Dimensions	research/dim01 → dim12	91 530	Matière brute sourcée (claims + notes de bas de page)
Méta-recherche	cross_verification, insight, phase5_validation	5 857	Confiance, analyses transversales, arbitrages
Plan / outline	plan.md, .agent.outline.md	2 332	Taxonomie des chapitres

Total ≈ 214 500 mots. Les .docx sont des dérivés du markdown — non ingérés.

A.2 Découverte structurante : les fichiers dim ont trois dialectes

Le prompt (§2) postule un format unique Claim / Source / URL / Date / Excerpt / Confidence. La réalité mesurée :

Dialecte	Fichiers	Motif
A — claim plat	dim01, dim02, dim03, dim04, dim07	Claim: … puis Source: / URL: / Date: / Excerpt: / Confidence: en début de ligne
B — claim numéroté gras	dim05	**Claim 3 :** … puis champs plats
C — claim en liste	dim10 (+ portions de dim06, dim08)	**Claim 1.2** — … puis - **Source** : / - **URL** : (URLs parfois multiples, séparées par ;)
D — prose + notes	dim06, dim08, dim09, dim11, dim12	Aucun bloc claim ; sources en fin de fichier sous forme [^N^] Éditeur — titre : URL

Comptage : 153 blocs Claim explicites, 258 définitions de notes de bas de page, 884 usages de marqueurs [^N^] dans les dim. Le parseur doit gérer les quatre dialectes, sinon on perd dim06/08/09/11/12 — soit précisément les dimensions associations, entreprises, migration et calendrier.

A.3 Résolution des citations [^dimXX-N^]

Chaîne de résolution implémentable et vérifiée :

sec0X.md : « … chlordécone [^dim07-24^] »
        → dim07, note locale n° 24
        → dim07 §« [^24^] Vie-publique — chlordécone … : https://… »   (ou bloc Claim portant [^24^])
        → URL + date + extrait verbatim + confiance

Marqueurs distincts recensés dans les chapitres : 333, dont des marqueurs non-dim ([^phase5-3.1^], [^insight-5^]) qui pointent vers phase5_validation.md et insight.md — à traiter comme deux « pseudo-dimensions ».

A.4 Inventaire seed cible

• Tableau A de sec10 : 27 lois promulguées (23 avr. → 23 juill. 2026), colonnes N° de loi | Promulgation/JO | Objet | Statut libertés | Pertinence Guadeloupe-OM.
• Tableau B de sec10 : 24 lignes (adoptés non promulgués, navette, déposés, annoncés) — dont 2 lignes portant chacune 2 textes (accords Kazakhstan + Colombie ; MACF ratification + accord plateforme) → 26 textes après éclatement.
• Décisions CC identifiables : 2026-903, 904, 905, 906, 908, 909 (rendues) + 910 à 915 (en instance) = 12 affaires DC.

→ Cible réaliste : 53 textes (27 + 26), au-delà du plancher de 49 exigé au §2. Les décisions CC alimentent la table decisions_cc et non le compteur textes.

A.5 Contradictions détectées dans le corpus (à encoder comme règles, pas à masquer)

1. insight.md §1 annonce « 5 décisions DC attendues fin août » puis en liste 6 ; sec10 en compte 7 + Philippine hors suspension. → Règle : sec10 + phase5_validation priment sur insight pour les faits ; insight n'est utilisé que comme contenu éditorial (encart « point de veille »).
2. dim11 point de vigilance n° 1 dit la saisine Riposte « non confirmée par une source primaire » ; phase5_validation §3 la tranche comme effective, 24/07/2026, n° 2026-915 DC. → phase5_validation prime (règle explicite du §5.2 du prompt).
3. AFD free party : 1 500 € (dim09) vs 500 € (phase5). → 500 €, conformément au test d'acceptation §7 du prompt.
4. Durées DOM chômage antérieures : divergence assumée low dans cross_verification → entrée marquée « à vérifier ».

Ces quatre règles sont codées dans pipeline/resolution_conflits.py et testées.

---

B. Architecture décidée

veille_legislative_971/
├── data/
│   ├── input/                  ← LECTURE SEULE (jamais modifié)
│   ├── veille.db               ← SQLite (généré)
│   └── textes.json             ← dump statique (généré, mode dégradé)
├── pipeline/                   ← Python 3.12 (uv)
│   ├── modeles.py              ← pydantic : Texte, Source, Evenement, DecisionCC
│   ├── db.py                   ← connexion, migrations, FTS5
│   ├── migrations/             ← 001_initial.sql, …
│   ├── seed_from_research.py   ← orchestrateur du seed
│   ├── parseurs/
│   │   ├── tableaux_sec10.py   ← tableaux A et B (chemin principal)
│   │   ├── blocs_claim.py      ← 4 dialectes dim (A/B/C/D)
│   │   ├── notes_bas_page.py   ← résolution [^dimXX-N^] → URL
│   │   ├── bibliographie.py    ← _ref.md, 481 entrées
│   │   └── meta.py             ← cross_verification, insight, phase5
│   ├── collecteurs/            ← legifrance.py (PISTE), assemblee.py, senat.py,
│   │                             conseil_constit.py, vie_publique.py
│   ├── rapprochement.py        ← matching numero_officiel puis fuzzy titre
│   ├── classification.py       ← thèmes/impacts heuristiques (config.yaml)
│   ├── guadeloupe.py           ← détection outre-mer
│   ├── resolution_conflits.py  ← hiérarchie JO > AN/Sénat > CC > presse
│   ├── update.py               ← run complet, --dry-run obligatoire
│   └── config.yaml
├── web/                        ← SvelteKit 2 + Svelte 5 runes + TS strict
│   ├── src/lib/server/         ← better-sqlite3, requêtes FTS5, facettes
│   ├── src/routes/
│   │   ├── +page.svelte                    SSR — tableau de bord
│   │   ├── recherche/                      SSR — facettes dans url.searchParams
│   │   ├── textes/[slug]/                  SSR — fiche + timeline + sources
│   │   ├── calendrier/                     SSR — échéances août-octobre
│   │   ├── a-propos/  methode/             prerender = true
│   │   └── api/textes|textes/[slug]|echeances/+server.ts
│   └── svelte.config.js        ← adapter-node, precompress
├── systemd/
│   ├── veille-legislative.service / .timer     (6 h, 18 h + dimanche intensif)
│   └── veille-web.service / .socket            (activation par socket, IDLE_TIMEOUT=300)
├── tests/                      ← pytest (parseurs, fixtures figées)
├── Makefile                    ← seed, update, dev, build, check, test
├── .env.example
├── README.md
└── README-pipeline.md

B.1 Arbitrages prompt ↔ recommandations doc2sveltekit-transition

Sujet	Prompt	Playbook OKI	Décision
Adapter	adapter-node, SSR, « non négociable » (§3bis)	adapter-static, prerender intégral	Prompt — le playbook vise des sites vitrines, ici les facettes URL et la fraîcheur pipeline exigent le SSR
Zéro tiers, self-hébergement polices	§3 « zéro CDN externe »	§2.2 idem	Convergent — appliqué
Thème sombre / or / flag-bar	« sobre et institutionnel »	identité OKI obligatoire	À valider (question 2)
Tailwind	imposé (§3)	interdit (§2.3)	À valider (question 1)
Zéro emoji, set SVG kréyòl	non traité	obligatoire	Playbook — appliqué (badges de statut en SVG, pas d'emoji)
Motion gwoka + prefers-reduced-motion	non traité	obligatoire	Playbook, dosé : transitions ≤ 120 ms, aucune animation de scroll
Schema.org / SEO AI-Overview	non traité	PRD dédié	Playbook — Legislation + Dataset JSON-LD sur les fiches, sitemap, robots.txt
Accessibilité WCAG AA	§6	§2.8	Convergent

---

C. Phases d'exécution

Phase	Contenu	Vérification exécutable
1	Squelette repo, uv + Python 3.12, schéma SQLite + FTS5, migrations, modèles pydantic	make db-init puis sqlite3 data/veille.db .schema
2	Parseurs sec10 (A + B) → 53 textes, avec statuts, dates, pertinence Guadeloupe	make seed → compte-rendu ≥ 49 textes ; pytest tests/test_tableaux_sec10.py
3	Parseurs dim (4 dialectes) + résolution [^dimXX-N^] + _ref.md → sources, extraits verbatim, confiance	make seed → 100 % des textes avec ≥ 1 source URL ; couverture pytest ≥ 70 %
4	Enrichissement : resume, points_cles, impacts, timeline evenements, decisions_cc, insights	Tests d'acceptation §7 du prompt (7 assertions) automatisés en pytest
5	Collecteurs live + update.py --dry-run + résolution de conflits + veille_log + dump JSON	make update-dry → rapport de diffs réel affiché
6	SvelteKit : layout, tokens, accueil, recherche à facettes, fiche, calendrier, à-propos/méthode, API JSON	npm run build, npm run check (0 erreur TS), node build répond sur 127.0.0.1
7	PWA, systemd (4 unités), README d'installation Debian vierge, doc des dégradations sans clé PISTE	grep de conformité §3bis, démo des 5 scénarios du §8.7

Chaque phase se clôt par la sortie réelle des commandes, montrée telle quelle.

---

D. Points bloquants à trancher avant la Phase 1

1. Tailwind ou CSS vanilla + tokens OKI (prompt vs playbook).
2. Identité visuelle : charte OKI complète, OKI sobrifiée, ou institutionnel neutre.
3. Clé Légifrance : la clé fournie ressemble à un client_id PISTE ; l'API OAuth2 client_credentials exige aussi un client_secret. Sans lui, le collecteur Légifrance sera codé mais désactivé (dégradation documentée : repli scraping AN/Sénat).
4. Git : le dossier n'est pas un dépôt. git init + commit initial recommandé avant toute écriture (règle transverse n° 2 du playbook) ; publication Gitea labola.o-k-i.net optionnelle.