feat: add Belgium and Portugal cross-border corridors — #40 PR 4/4 (#50)

HirenGajjar · web-flow · commit 5e65f62011c6 · 2026-05-31T14:42:34.000+02:00
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
diff --git a/data/institutions/be/sfp.yaml b/data/institutions/be/sfp.yaml
@@ -0,0 +1,26 @@
+id: institution:be:sfp
+object_type: Institution
+name: "Service fédéral des Pensions (SFP) / Federale Pensioendienst (FPD)"
+jurisdiction:
+  country: BE
+  region: null
+  municipality: null
+function: "Belgian federal pension authority responsible for retirement and survivor pensions for employees, self-employed workers, and civil servants. Handles survivor pension (pension de survie) claims for bereaved spouses and orphans."
+official_site: "https://www.sfpd.fgov.be"
+contact_channels:
+  - type: website
+    value: "https://www.sfpd.fgov.be"
+    notes: "Main SFP portal for pension information, survivor pension claims, and mypension.be online services."
+languages:
+  - fr
+  - nl
+  - de
+source_ids:
+  - source:be:belgium-be-deces
+verification_status: structured-from-source
+provenance:
+  created_at: "2026-05-30"
+  created_by: "HirenGajjar"
+  updated_at: null
+  updated_by: null
+notes: "SFP is the Belgian federal pension authority (trilingual: SFP in French, FPD in Dutch). Covers ~50,000 frontaliers who commute daily from Belgium to Luxembourg. Survivor pension applications can be submitted via mypension.be. Coordinates with CNAP via EU social security coordination for cross-border cases."
diff --git a/data/institutions/pt/seguranca-social.yaml b/data/institutions/pt/seguranca-social.yaml
@@ -0,0 +1,23 @@
+id: institution:pt:seguranca-social
+object_type: Institution
+name: "Instituto da Segurança Social (ISS) — Segurança Social"
+jurisdiction:
+  country: PT
+  region: null
+  municipality: null
+function: "Portuguese social security authority responsible for survivor pensions, death grants, and social protection coordination. Handles cross-border pension claims for Portuguese nationals who worked abroad, coordinating with foreign pension authorities via EU social security rules."
+official_site: "https://www.seg-social.pt"
+contact_channels:
+  - type: website
+    value: "https://www.seg-social.pt"
+    notes: "Main Segurança Social portal. Online claims via Segurança Social Direta at segurancasocialdirecta.pt."
+languages:
+  - pt
+source_ids: []
+verification_status: discovered
+provenance:
+  created_at: "2026-05-30"
+  created_by: "HirenGajjar"
+  updated_at: null
+  updated_by: null
+notes: "Portugal has the largest foreign national community in Luxembourg (~100,000 residents). Survivor pension (pensão de sobrevivência) requires 36 months of contributions; apply via Segurança Social Direta using form RP 5075. Death of a Portuguese national abroad must also be registered in Portugal via consular services. Centro Nacional de Pensões (CNP) within ISS handles international pension coordination."
diff --git a/data/scenarios/corridor-lu-be.yaml b/data/scenarios/corridor-lu-be.yaml
@@ -0,0 +1,26 @@
+id: scenario:corridor-lu-be
+object_type: Scenario
+title: "Luxembourg — Belgium cross-border bereavement corridor"
+description: "Cross-border bereavement scenario for families connected to both Luxembourg and Belgium, covering approximately 50,000 frontaliers who commute to Luxembourg from Belgium daily."
+scenario_type: corridor
+countries:
+  - LU
+  - BE
+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:be:belgium-be-deces
+verification_status: discovered
+publication_status: draft
+provenance:
+  created_at: "2026-05-30"
+  created_by: "HirenGajjar"
+  updated_at: null
+  updated_by: null
+notes: "Belgium is the third largest frontalier corridor for Luxembourg (~50,000 daily commuters). Key cross-border facts: death declared to municipality where death occurred, usually by undertaker; death certificate forwarded to municipality of last residence; succession duties are regional in Belgium and depend on fiscal residence; Brussels IV governs cross-border succession; SFP handles survivor pension coordination with CNAP via EU social security rules."
diff --git a/data/scenarios/corridor-lu-pt.yaml b/data/scenarios/corridor-lu-pt.yaml
@@ -0,0 +1,26 @@
+id: scenario:corridor-lu-pt
+object_type: Scenario
+title: "Luxembourg — Portugal cross-border bereavement corridor"
+description: "Cross-border bereavement scenario for families connected to both Luxembourg and Portugal, covering the largest foreign national community in Luxembourg at approximately 100,000 Portuguese residents."
+scenario_type: corridor
+countries:
+  - LU
+  - PT
+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:pt:gov-pt-obito
+verification_status: discovered
+publication_status: draft
+provenance:
+  created_at: "2026-05-30"
+  created_by: "HirenGajjar"
+  updated_at: null
+  updated_by: null
+notes: "Portugal represents the largest foreign national community in Luxembourg (~100,000 residents). Key cross-border facts: death of a Portuguese national in Luxembourg must be registered in Portugal via consular services; survivor pension (pensão de sobrevivência) requires 36 months of contributions and form RP 5075 via Segurança Social Direta; Brussels IV governs succession under habitual residence rule; further source verification needed for full PT corridor detail — see issue #40 notes."
diff --git a/data/sources/be/belgium-be-deces.yaml b/data/sources/be/belgium-be-deces.yaml
@@ -0,0 +1,30 @@
+id: source:be:belgium-be-deces
+object_type: Source
+title: "Décès"
+title_fr: "Décès"
+title_de: "Todesfall"
+description: "Official Belgian government guidance on administrative steps following a death, covering declaration, burial, incineration, succession, inheritance, and international aspects including procedures for deaths occurring abroad."
+description_fr: "Guidance officielle du gouvernement belge sur les démarches administratives après un décès, couvrant la déclaration, l'inhumation, l'incinération, la succession, l'héritage et les aspects internationaux."
+description_de: "Offizielle belgische Regierungsanleitung zu den Verwaltungsschritten nach einem Todesfall, einschließlich Meldung, Beerdigung, Einäscherung, Erbfolge und internationalem Kontext."
+source_type: government_portal
+url: "https://www.belgium.be/fr/famille/deces"
+jurisdiction:
+  country: BE
+  region: null
+  municipality: null
+languages:
+  - fr
+  - nl
+  - de
+institution_ids: []
+accessed_at: "2026-05-30"
+last_verified_at: "2026-05-30"
+evidence_locator: null
+reuse_notes: "Official Belgian federal public service portal. Available in French, Dutch, and German. Extract only source-backed administrative facts."
+verification_status: source-checked
+provenance:
+  created_at: "2026-05-30"
+  created_by: "HirenGajjar"
+  updated_at: null
+  updated_by: null
+notes: "URL verified 2026-05-30 — page loads correctly, title confirmed as 'Décès'. Key fact from issue #40 research: death must be declared to the municipality where the person died (usually handled by the undertaker); the death certificate is then forwarded to the municipality of last residence. Succession duties in Belgium are regional and depend on fiscal residence."
diff --git a/data/sources/pt/gov-pt-obito.yaml b/data/sources/pt/gov-pt-obito.yaml
@@ -0,0 +1,27 @@
+id: source:pt:gov-pt-obito
+object_type: Source
+title: "Death"
+title_fr: "Décès"
+description: "Official Portuguese government portal covering administrative procedures following a death, including death declaration, death certificate, survivor pension, death grant, and procedures for Portuguese nationals who die abroad."
+description_fr: "Portail officiel du gouvernement portugais sur les démarches administratives après un décès, notamment la déclaration de décès, l'acte de décès, la pension de survie, le subside de décès et les procédures pour les ressortissants portugais décédés à l'étranger."
+source_type: government_portal
+url: "https://eportugal.gov.pt/en/temas/familia/morte"
+jurisdiction:
+  country: PT
+  region: null
+  municipality: null
+languages:
+  - pt
+  - en
+institution_ids: []
+accessed_at: "2026-05-30"
+last_verified_at: null
+evidence_locator: null
+reuse_notes: "Official ePortugal portal source. Available in Portuguese and English. Extract only source-backed administrative facts."
+verification_status: discovered
+provenance:
+  created_at: "2026-05-30"
+  created_by: "HirenGajjar"
+  updated_at: null
+  updated_by: null
+notes: "URL identified from official ePortugal portal structure. Full content verification requires further access — marked discovered. The death of a Portuguese citizen abroad must be declared in Portugal. Survivor pension (pensão de sobrevivência) requires minimum 36 months of registered contributions; application via Segurança Social Direta (form RP 5075) or online at seg-social.pt."
