This repository was archived by the owner on Jun 6, 2026. It is now read-only.
feat: add Luxembourg–France cross-border corridor — #40 PR 2/4#48
Merged
Merged
Conversation
TommiLindfors
approved these changes
May 30, 2026
Contributor
TommiLindfors
left a comment
TommiLindfors
left a comment
There was a problem hiding this comment.
Hi Hiren!
Thank you so much for another excellent and high-quality contribution to Clarvia! ❤️
The data structure for the Luxembourg-France corridor looks incredibly clean and complies perfectly with our schemas. The inclusion of the mixed career form (formulaire carrière mixte) details in the CARSAT notes is a fantastic, highly relevant detail for cross-border frontaliers.
Everything looks good and the validation checks passed. I'll merge this PR now using squash-merge.
Thank you again for driving the cross-border corridor implementation forward so rapidly! We really appreciate your help.
TommiLindfors
pushed a commit
that referenced
this pull request
May 31, 2026
Part 4 of 4 for issue #40. Completes the cross-border corridor infrastructure with Belgium and Portugal. --- ## Context This PR adds the two remaining corridors: - **Belgium** — ~50,000 daily frontaliers, third largest corridor - **Portugal** — ~100,000 residents, the largest foreign national community in Luxembourg --- ## Files added ### `data/sources/be/belgium-be-deces.yaml` **URL verified:** https://www.belgium.be/fr/famille/deces — loads correctly, title confirmed as "Décès". - `source_type: government_portal` - `verification_status: source-checked` - `languages: [fr, nl, de]` — belgium.be is trilingual - Includes `title_fr`, `title_de`, `description_fr`, `description_de` **Key facts documented in notes (from issue #40 research):** - Death must be declared to the municipality where the person died, usually handled by the undertaker - Death certificate is then forwarded to the municipality of last residence - Succession duties in Belgium are regional and depend on fiscal residence --- ### `data/institutions/be/sfp.yaml` **URL verified:** https://www.sfpd.fgov.be — loads correctly as "Federal Pensions Service". - `id: institution:be:sfp` - `verification_status: structured-from-source` - `languages: [fr, nl, de]` — Belgian trilingual institution (SFP in French, FPD in Dutch) - References `source:be:belgium-be-deces` **Key facts documented in notes:** - Survivor pension applications submitted via mypension.be - Coordinates with CNAP via EU social security coordination for cross-border cases - Covers ~50,000 Belgian frontaliers --- ### `data/scenarios/corridor-lu-be.yaml` - `scenario_type: corridor` - `countries: [LU, BE]` - `publication_status: draft` - References all 5 PR1 conditions and both EU sources + BE source --- ### `data/sources/pt/gov-pt-obito.yaml` **URL:** https://eportugal.gov.pt/en/temas/familia/morte — identified from official ePortugal portal structure; page was inaccessible during creation. - `source_type: government_portal` - `verification_status: discovered` — honest status, URL could not be confirmed loading - `last_verified_at: null` - Notes explicitly state full content verification requires further access **Key facts encoded from issue #40 research:** - Death of a Portuguese citizen abroad must be declared in Portugal - Survivor pension (pensão de sobrevivência) requires minimum 36 months of contributions - Application via Segurança Social Direta using form RP 5075 --- ### `data/institutions/pt/seguranca-social.yaml` **URL:** https://www.seg-social.pt — confirmed loading from research. - `id: institution:pt:seguranca-social` - `verification_status: discovered` — consistent with PT source status - `languages: [pt]` **Key facts documented in notes:** - Portugal has the largest foreign national community in Luxembourg (~100,000 residents) - 36-month contribution requirement for survivor pension - Death of Portuguese national abroad must be registered in Portugal via consular services - Centro Nacional de Pensões (CNP) within ISS handles international pension coordination --- ### `data/scenarios/corridor-lu-pt.yaml` - `scenario_type: corridor` - `countries: [LU, PT]` - `publication_status: draft` - Notes explicitly flag that further source verification is needed for full PT corridor detail --- ## Verification status honesty Belgium sources are `source-checked` — URLs verified loading, content confirmed. Portugal sources are `discovered` — URL identified from official portal structure but could not be verified loading during creation. This is consistent with issue #40's own note: "Detailed survivor-pension routing and death transcription process need further verification." --- ## Issue #40 complete With this PR all four corridors are now in main: - PR 1/4 (#47) — EU foundation (conditions + EU regulations) ✅ - PR 2/4 (#48) — France corridor ✅ - PR 3/4 (#49) — Germany corridor ✅ - PR 4/4 (this PR) — Belgium + Portugal corridors Total new files across all 4 PRs: 25 files covering 2 EU regulations, 5 cross-border conditions, 4 corridor scenarios, 6 foreign sources, 5 foreign institutions. --- ## Schema compliance - All schemas read before writing — `additionalProperties: false` respected throughout - All condition IDs reference conditions from PR 1 (merged) - All EU source IDs reference sources from PR 1 (merged) - `institution_ids` and `source_ids` cross-references consistent within each PR --- ## Verified - `python3 scripts/validate.py` — passes (34 data files, up from 28) - All 6 trailing newlines confirmed `0a` - 6 new files, 0 existing files modified - `git status` confirmed no unintended changes
7 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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.yamlURL 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_portalverification_status: source-checkeddata/sources/fr/info-retraite-reversion.yamlURL verified: https://www.info-retraite.fr — loads correctly. GIP Union Retraite official portal.
source_type: institutional_pageverification_status: source-checkeddata/institutions/fr/carsat.yamlURL 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 coordinationdata/institutions/fr/scec.yamlURL verified: https://www.diplomatie.gouv.fr/fr/services-aux-francais/etat-civil-et-nationalite-francaise/ — loads correctly (general civil status section).
id: institution:fr:scecverification_status: discovered— the specific SCEC transcription page content was not fully verified; honest status applieddata/scenarios/corridor-lu-fr.yamlscenario_type: corridorcountries: [LU, FR]publication_status: draftdeceased-is-foreign-national,deceased-is-frontalier,survivor-resides-abroad,assets-in-multiple-jurisdictions,repatriation-of-remainsKey corridor facts documented in notes:
Schema compliance
additionalProperties: falserespected throughoutofficial_sitefield confirmed loading for all recordssource_idsin institutions reference sources created in this same PRcondition_idsreference conditions merged in PR 1 — dependency respectedWhat 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)0agit statusconfirmed no unintended changes