Skip to content

Détection par regex des mentions de collaboration externe dans les amendements#7

Closed
DavidNO wants to merge 3 commits into
add-amendements-modelfrom
detect-mentions-regex
Closed

Détection par regex des mentions de collaboration externe dans les amendements#7
DavidNO wants to merge 3 commits into
add-amendements-modelfrom
detect-mentions-regex

Conversation

@DavidNO

@DavidNO DavidNO commented Jul 14, 2026

Copy link
Copy Markdown
Collaborator

Objectif

Détecter les amendements dont l'exposé sommaire déclare une collaboration ou une inspiration avec une entité externe (lobby, syndicat, association, entreprise, fédération professionnelle, ONG…) — formulations du type « travaillé avec… », « en concertation avec… », « inspiré de… ».

Cette PR apporte un détecteur par expressions régulières.

Contenu

Table d'analyse (models/amendement_mention.pyamendement_mentions)

  • Une ligne par mention : amendementUid, citation, formulation, entite, typeEntite, externe, modele, createdAt.
  • Table d'analyse hors ETL_TABLES : survit aux rebuilds pendant que amendements/dossiers sont recréées.
  • amendementUid est une référence molle (pas de ForeignKey), sur le modèle des RefUid existants, pour ne pas bloquer le drop des tables ETL.

Détecteur regex (analysis/detect_mentions_regex.py)

  • Familles de motifs calibrées sur les formulations réellement observées dans le corpus : travaillé avec, en collaboration/concertation avec, inspiré de, issu d'une proposition de, proposé par, à la demande de, avec le concours de, recommandation de
  • Exclusions contextuelles pour limiter les faux positifs : acteurs publics/parlementaires juste après la tournure (Gouvernement, commission, rapporteur, Conseil d'État…), référents juridiques après « inspiré de » (loi, article, procédure…), référents textuels après les tournures citation (« proposé par le texte », « le rapport », « le groupe X »…).
  • --persist : écriture dans amendement_mentions, scopée au tag modele='regex:v1'

Fix ETL (etl/loading.py)
Insertion par batch de 1 000 lignes. Nécessaire pour charger le corpus complet.

Docs : setup complet dans le README (.env, docker compose, usage du détecteur) et correction de l'exemple de modèle obsolète (UserDossier).

Résultats sur le corpus complet (123 084 amendements AN, législature 17)

  • 96 722 amendements ont un exposé sommaire exploitable.
  • 10 866 amendements (11,2 %) contiennent au moins une mention (11 962 mentions).
  • Top formulations : travaillé avec (6 337), proposé par (1 956), recommandation de (815), en collaboration avec (692), issu d'une proposition de (662), inspiré de (581)…

Évaluation contre un jeu de référence

Les motifs ont été calibrés et évalués contre un jeu de référence de 797 amendements annotés par un LLM (détecteur exploratoire conservé sur la branche detect-mentions-poc, non destiné à être mergé) :

Référence Précision Rappel F1
Mentions externes (hors institutions politiques) 92,7 % 92,7 % 92,7 %

Exemples de FN : (« le CNB demandent », « l'Interfédération a relevé ») — semble hors de portée d'un regex.

DavidNO added 3 commits July 14, 2026 13:06
Stores external-collaboration mentions detected in amendments' exposé
sommaire. Analysis table (not in ETL_TABLES): survives rebuilds via
create_all while amendements/dossiers are dropped and reloaded.

amendementUid is a soft reference to amendements.uid (no ForeignKey),
matching the RefUid pattern in the Amendement model, so the referential
constraint never blocks the drop of the ETL-managed amendements table.
One row per mention; provenance kept via modele/createdAt.

(cherry picked from commit 726994f)
Detects amendments whose exposé sommaire declares a collaboration or
inspiration with an external entity (lobby, union, association, company,
NGO...). Pattern families are calibrated on formulations observed on the
real corpus: travaillé avec, en concertation avec, inspiré de, issu d'une
proposition de, proposé par, à la demande de...

Contextual exclusions keep precision up: public or parliamentary actors
right after the wording (Gouvernement, commission, rapporteur, Conseil
d'État...), legal-object referents after 'inspiré de' (loi, article,
procédure...), and text/role referents after citation-like families
(le texte, le rapport, le groupe X, l'autorité...).

Detection only: fills citation + formulation, leaves entite/typeEntite/
externe NULL (qualifying the entity needs semantic analysis). With
--persist, rows land in amendement_mentions tagged modele='regex:v1';
re-runs are idempotent per amendment and scoped to that tag.

Also documents DB setup and detector usage in the README, and fixes the
stale Dossier model example.
load() sent the whole dataset as a single INSERT: with the full corpus
(123k amendments x ~30 columns) that exceeds the 65,535-parameter limit
of the Postgres protocol and the load fails. Insert in batches of 1,000
rows instead (single transaction, still idempotent via
on_conflict_do_nothing).
@DavidNO

DavidNO commented Jul 16, 2026

Copy link
Copy Markdown
Collaborator Author

Remplacé par #9 : même travail de détection regex, mais empilé sur #8 (create-parliamentary-db) au lieu de add-amendements-model, pour respecter l'ordre ETL complet (#8) puis mentions (#9). Le correctif d'insertion par lots est désormais dans #8. Branches detect-mentions-regex et detect-mentions-poc conservées.

@DavidNO DavidNO closed this Jul 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant