Federate official Belgium data sources

backend/app/services/coverage_registry_service.py

@@ -79,6 +79,7 @@ class _SourceDefinition:
     contract: CoverageSourceContract
     materialized_layer_names: tuple[str, ...] = ()
     materialized_source_names: tuple[str, ...] = ()
+    operational_themes: tuple[str, ...] = ()
 
 
 def _contract(
@@ -98,6 +99,7 @@ def _contract(
     limitation_message: str,
     materialized_layer_names: tuple[str, ...] = (),
     materialized_source_names: tuple[str, ...] = (),
+    operational_themes: tuple[str, ...] = (),
 ) -> _SourceDefinition:
     return _SourceDefinition(
         contract=CoverageSourceContract(
@@ -117,6 +119,7 @@ def _contract(
         ),
         materialized_layer_names=materialized_layer_names,
         materialized_source_names=materialized_source_names or (source_name,),
+        operational_themes=operational_themes,
     )
 
 
@@ -156,12 +159,17 @@ SOURCE_DEFINITIONS = (
         themes=("admin", "population"),
         native_layers=("statistical_sectors", "population_statistics"),
         geometry_types=("Polygon", "MultiPolygon", "Tabular"),
-        acquisition_mode="catalog_only",
-        integration_status="not_configured",
+        acquisition_mode="operator_archive",
+        integration_status="operational",
         source_url="https://statbel.fgov.be/en/open-data",
         attribution="Statbel",
         license_note="Consult the license of the selected Statbel release.",
-        limitation_message="The catalog is audited, but no national bounded acquisition adapter is configured yet.",
+        limitation_message=(
+            "National editions require the governed plan-stage-review-apply operator; "
+            "population in partially selected sectors is area-weighted."
+        ),
+        materialized_layer_names=("population",),
+        operational_themes=("population",),
     ),
     _contract(
         source_name="digitaal_vlaanderen",
@@ -219,12 +227,17 @@ SOURCE_DEFINITIONS = (
         ),
         native_layers=("PICC", "orthophotos", "MNT", "hydrography", "land_cover"),
         geometry_types=("Point", "LineString", "Polygon", "MultiPolygon", "Raster"),
-        acquisition_mode="catalog_only",
-        integration_status="not_configured",
+        acquisition_mode="bounded_api",
+        integration_status="operational",
         source_url="https://geoportail.wallonie.be/catalogue",
         attribution="Service public de Wallonie",
         license_note="Consult the license of each Geoportail Wallonie product.",
-        limitation_message="Official sources are identified, but bounded acquisition and metric adapters are not implemented.",
+        limitation_message=(
+            "Bounded PICC buildings, road axes and hydrography are operational; "
+            "other Walloon themes remain unavailable until separately governed."
+        ),
+        materialized_source_names=("spw_picc",),
+        operational_themes=("buildings", "roads", "surface_water"),
     ),
     _contract(
         source_name="urbis",
@@ -234,12 +247,17 @@ SOURCE_DEFINITIONS = (
         themes=("buildings", "roads", "surface_water", "land_cover_use", "parcels", "orthophoto"),
         native_layers=("parcels", "buildings", "roads", "hydrography", "orthophoto"),
         geometry_types=("Point", "LineString", "Polygon", "MultiPolygon", "Raster"),
-        acquisition_mode="catalog_only",
-        integration_status="not_configured",
+        acquisition_mode="bounded_api",
+        integration_status="operational",
         source_url="https://datastore.brussels",
         attribution="Brussels UrbIS",
         license_note="Consult the license of the selected UrbIS dataset.",
-        limitation_message="Official sources are identified, but bounded acquisition and metric adapters are not implemented.",
+        limitation_message=(
+            "Bounded UrbIS buildings and cadastral parcels are operational; "
+            "other Brussels themes remain unavailable until separately governed."
+        ),
+        materialized_source_names=("urbis",),
+        operational_themes=("buildings", "parcels"),
     ),
     _contract(
         source_name="rbins_marine_reporting_units",
@@ -330,6 +348,18 @@ FLANDERS_THEME_DATASETS: dict[str, dict[str, tuple[str, ...]]] = {
     "flood_climate": {"vmm_flood_hazard": ()},
 }
 
+REGIONAL_THEME_DATASETS: dict[str, dict[str, tuple[str, ...]]] = {
+    "spw_geoportail": {
+        "buildings": ("buildings",),
+        "roads": ("roads",),
+        "surface_water": ("water",),
+    },
+    "urbis": {
+        "buildings": ("buildings",),
+        "parcels": ("parcels",),
+    },
+}
+
 
 class CoverageRegistryService:
     @staticmethod
@@ -403,6 +433,11 @@ class CoverageRegistryService:
                 if dataset.source_name not in theme_sources:
                     continue
                 layer_names = theme_sources[dataset.source_name]
+            elif definition.contract.source_name in REGIONAL_THEME_DATASETS:
+                theme_layers = REGIONAL_THEME_DATASETS[definition.contract.source_name].get(theme)
+                if theme_layers is None:
+                    continue
+                layer_names = theme_layers
             metadata = dataset.source_metadata if isinstance(dataset.source_metadata, dict) else {}
             coverage_zones = metadata.get("coverage_zones") or metadata.get("coverage_zone") or []
             if isinstance(coverage_zones, str):
@@ -448,10 +483,17 @@ class CoverageRegistryService:
             materialized.extend(matches)
             if matches:
                 source_statuses.append("operational")
-            elif definition.contract.integration_status == "operational":
+            elif (
+                definition.contract.integration_status == "operational"
+                and (not definition.operational_themes or theme in definition.operational_themes)
+            ):
                 source_statuses.append("partial")
             else:
-                source_statuses.append(definition.contract.integration_status)
+                source_statuses.append(
+                    "not_configured"
+                    if definition.contract.integration_status == "operational"
+                    else definition.contract.integration_status
+                )
             limitations.append(definition.contract.limitation_message)
 
         best_status = max(source_statuses, key=STATUS_RANK.__getitem__)