feat: add Luxembourg–France cross-border corridor — #40 PR 2/4 (#48)

HirenGajjar · web-flow · commit e18c8c08b0db · 2026-05-30T11:55:17.000+02:00
Part 2 of 4 for issue #40. Depends on PR 1/4 (#47, now merged). Adds the France corridor: 2 French sources, 2 French institutions, and the LU–FR corridor scenario. --- ## Context France is the largest frontalier corridor for Luxembourg — approximately 120,000 workers cross the border daily. This PR encodes the sources and institutions a Luxembourg-connected family with French ties would interact with, and wires them into a corridor scenario that references the cross-border conditions and EU regulations from PR 1. --- ## Files added ### `data/sources/fr/service-public-deces.yaml` **URL verified:** https://www.service-public.fr/particuliers/vosdroits/F16507 — loads correctly, title confirmed as "Un proche est décédé". Last verified on service-public.fr: 01 janvier 2026. - `source_type: government_portal` - `verification_status: source-checked` - Covers the full French bereavement journey: funeral organisation, institution notifications, succession steps, and time-sensitive obligations --- ### `data/sources/fr/info-retraite-reversion.yaml` **URL verified:** https://www.info-retraite.fr — loads correctly. GIP Union Retraite official portal. - `source_type: institutional_page` - `verification_status: source-checked` - Key research finding documented in notes: if the survivor pension (pension de réversion) is filed within 1 year of death, the start date is the first day of the month after death. A single online request covers all French base and complementary schemes. --- ### `data/institutions/fr/carsat.yaml` **URL verified:** https://www.carsat-alsacemoselle.fr — loads correctly. - `id: institution:fr:carsat-alsace-moselle` — deliberately the Alsace-Moselle CARSAT, not a generic CARSAT record, because this CARSAT directly borders Luxembourg and specifically handles Luxembourg frontalier pension coordination - Documents the 2026 "mixed career" form (formulaire carrière mixte) introduced to expedite coordination with CNAP via form P5000 - Organises personalised advisory sessions with Luxembourg CNAP representatives --- ### `data/institutions/fr/scec.yaml` **URL verified:** https://www.diplomatie.gouv.fr/fr/services-aux-francais/etat-civil-et-nationalite-francaise/ — loads correctly (general civil status section). - `id: institution:fr:scec` - `verification_status: discovered` — the specific SCEC transcription page content was not fully verified; honest status applied - Documents that for a French national who dies in Luxembourg, the family must request transcription of the Luxembourg death certificate through SCEC for French civil registry records and succession procedures - SCEC is located in Nantes and operates under the Ministry of Europe and Foreign Affairs --- ### `data/scenarios/corridor-lu-fr.yaml` - `scenario_type: corridor` - `countries: [LU, FR]` - `publication_status: draft` - References all 5 conditions from PR 1: `deceased-is-foreign-national`, `deceased-is-frontalier`, `survivor-resides-abroad`, `assets-in-multiple-jurisdictions`, `repatriation-of-remains` - References both EU sources from PR 1 and both FR sources from this PR **Key corridor facts documented in notes:** - Survivor pension filed via Info Retraite (single request, all French schemes) - CARSAT Alsace-Moselle coordinates with CNAP via P5000 form - Luxembourg death certificate requires SCEC transcription for French civil registry - Succession governed by Brussels IV habitual residence rule --- ## Schema compliance - Read all schemas before writing — `additionalProperties: false` respected throughout - Institution `official_site` field confirmed loading for all records - `source_ids` in institutions reference sources created in this same PR - Scenario `condition_ids` reference conditions merged in PR 1 — dependency respected --- ## What PR 3 will add - `scenario:corridor-lu-de` + 2 DE sources (DRV pages) + 1 DE institution (DRV) --- ## Verified - `python3 scripts/validate.py` — passes (24 data files, up from 19) - All 5 trailing newlines confirmed `0a` - 5 new files, 0 existing files modified - All source and institution URLs verified loading in browser before writing - `git status` confirmed no unintended changes
diff --git a/data/institutions/fr/carsat.yaml b/data/institutions/fr/carsat.yaml
@@ -0,0 +1,24 @@
+id: institution:fr:carsat-alsace-moselle
+object_type: Institution
+name: "CARSAT Alsace-Moselle (Caisse d'Assurance Retraite et de la Santé au Travail)"
+jurisdiction:
+  country: FR
+  region: null
+  municipality: null
+function: "Regional pension and health insurance body responsible for retirement pensions, survivor benefits, and occupational health. The Alsace-Moselle CARSAT specifically handles cross-border pension coordination for frontaliers working in Luxembourg, Germany, and Switzerland."
+official_site: "https://www.carsat-alsacemoselle.fr"
+contact_channels:
+  - type: website
+    value: "https://www.carsat-alsacemoselle.fr"
+    notes: "Main portal for pension services, frontalier coordination, and survivor benefit applications."
+languages:
+  - fr
+source_ids:
+  - source:fr:info-retraite-reversion
+verification_status: structured-from-source
+provenance:
+  created_at: "2026-05-29"
+  created_by: "HirenGajjar"
+  updated_at: null
+  updated_by: null
+notes: "CARSAT Alsace-Moselle is the primary CARSAT for Luxembourg frontaliers, as Alsace-Moselle directly borders Luxembourg. Organises personalised advisory sessions with Luxembourg CNAP representatives. Uses 'mixed career' form (formulaire carrière mixte) introduced in 2026 to expedite coordination with CNAP via form P5000."
diff --git a/data/institutions/fr/scec.yaml b/data/institutions/fr/scec.yaml
@@ -0,0 +1,23 @@
+id: institution:fr:scec
+object_type: Institution
+name: "Service central d'état civil (SCEC)"
+jurisdiction:
+  country: FR
+  region: null
+  municipality: null
+function: "French central civil registry responsible for transcribing foreign civil status acts (births, marriages, deaths) for French nationals. Handles transcription of death certificates issued in Luxembourg for French nationals who died abroad."
+official_site: "https://www.diplomatie.gouv.fr/fr/services-aux-francais/etat-civil-et-nationalite-francaise/"
+contact_channels:
+  - type: website
+    value: "https://www.diplomatie.gouv.fr/fr/services-aux-francais/etat-civil-et-nationalite-francaise/"
+    notes: "France Diplomatie civil status section covering transcription of foreign acts."
+languages:
+  - fr
+source_ids: []
+verification_status: discovered
+provenance:
+  created_at: "2026-05-29"
+  created_by: "HirenGajjar"
+  updated_at: null
+  updated_by: null
+notes: "SCEC is located in Nantes and operates under the Ministry of Europe and Foreign Affairs. For a French national who dies in Luxembourg, family must request transcription of the Luxembourg death certificate through SCEC. Required for succession procedures and French civil registry records."
diff --git a/data/scenarios/corridor-lu-fr.yaml b/data/scenarios/corridor-lu-fr.yaml
@@ -0,0 +1,27 @@
+id: scenario:corridor-lu-fr
+object_type: Scenario
+title: "Luxembourg — France cross-border bereavement corridor"
+description: "Cross-border bereavement scenario for families connected to both Luxembourg and France, covering approximately 120,000 frontaliers and a large resident French community."
+scenario_type: corridor
+countries:
+  - LU
+  - FR
+condition_ids:
+  - condition:deceased-is-foreign-national
+  - condition:deceased-is-frontalier
+  - condition:survivor-resides-abroad
+  - condition:assets-in-multiple-jurisdictions
+  - condition:repatriation-of-remains
+source_ids:
+  - source:eu:brussels-iv-regulation
+  - source:eu:social-security-coordination
+  - source:fr:service-public-deces
+  - source:fr:info-retraite-reversion
+verification_status: discovered
+publication_status: draft
+provenance:
+  created_at: "2026-05-29"
+  created_by: "HirenGajjar"
+  updated_at: null
+  updated_by: null
+notes: "France is the largest frontalier corridor for Luxembourg (~120,000 daily commuters). Key cross-border facts: survivor pension filed via Info Retraite (single request covers all French schemes); CARSAT Alsace-Moselle coordinates with CNAP via form P5000; Luxembourg death certificate requires SCEC transcription for French civil registry; succession governed by Brussels IV habitual residence rule."
diff --git a/data/sources/fr/info-retraite-reversion.yaml b/data/sources/fr/info-retraite-reversion.yaml
@@ -0,0 +1,26 @@
+id: source:fr:info-retraite-reversion
+object_type: Source
+title: "Info Retraite — survivor pension (pension de réversion)"
+title_fr: "Info Retraite — pension de réversion"
+description: "Official French pension information portal where surviving spouses can file a single online request covering all French base and complementary pension schemes. Coordinated by the GIP Union Retraite."
+description_fr: "Portail officiel d'information retraite permettant aux conjoints survivants de déposer une demande unique en ligne couvrant tous les régimes de retraite de base et complémentaires français. Coordonné par le GIP Union Retraite."
+source_type: institutional_page
+url: "https://www.info-retraite.fr"
+jurisdiction:
+  country: FR
+  region: null
+  municipality: null
+languages:
+  - fr
+institution_ids: []
+accessed_at: "2026-05-29"
+last_verified_at: "2026-05-29"
+evidence_locator: null
+reuse_notes: "Official French GIP Union Retraite portal. Extract only source-backed administrative facts."
+verification_status: source-checked
+provenance:
+  created_at: "2026-05-29"
+  created_by: "HirenGajjar"
+  updated_at: null
+  updated_by: null
+notes: "URL verified 2026-05-29. Key fact from issue #40 research: if filed within 1 year of death, survivor pension start date is the first day of the month after death. Single request covers all French base and complementary schemes."
diff --git a/data/sources/fr/service-public-deces.yaml b/data/sources/fr/service-public-deces.yaml
@@ -0,0 +1,26 @@
+id: source:fr:service-public-deces
+object_type: Source
+title: "Un proche est décédé"
+title_fr: "Un proche est décédé"
+description: "Official French government guidance covering the full administrative journey after a bereavement, including organising the funeral, notifying institutions, succession steps, and time-sensitive obligations."
+description_fr: "Guidance officielle du gouvernement français sur l'ensemble des démarches administratives après un décès, notamment l'organisation des obsèques, les notifications aux organismes, les étapes successorales et les obligations urgentes."
+source_type: government_portal
+url: "https://www.service-public.fr/particuliers/vosdroits/F16507"
+jurisdiction:
+  country: FR
+  region: null
+  municipality: null
+languages:
+  - fr
+institution_ids: []
+accessed_at: "2026-05-29"
+last_verified_at: "2026-05-29"
+evidence_locator: null
+reuse_notes: "Official French public-service portal source. Verified 01 janvier 2026. Extract only source-backed administrative facts."
+verification_status: source-checked
+provenance:
+  created_at: "2026-05-29"
+  created_by: "HirenGajjar"
+  updated_at: null
+  updated_by: null
+notes: "URL verified 2026-05-29 — page loads correctly, title confirmed as 'Un proche est décédé'. Primary French bereavement guidance page relevant for French nationals and cross-border families connected to France."
