feat: complete Wallonia land cover and terrain sources

docs/API_CONTRACTS.md

@@ -484,7 +484,7 @@ the existing MapLibre image-overlay path.
 
 ### GET `/api/v1/projects/{project_id}/datasets/walous/products`
 
-Returns the fixed official WALOUS 2020/2023 registry. Each product reports its
+Returns the fixed official WALOUS 2018/2020/2023 registry. Each product reports its
 observation year, EPSG:3812 source contract, 1 m source semantics, configured
 state, attribution, licence and documented edition accuracy. `configured`
 becomes true only when the checksum-validated source GeoTIFF exists below
@@ -497,9 +497,14 @@ applies nearest-neighbour resampling to the configured analysis resolution,
 masks `bbox intersect Area`, validates the official non-contiguous class-code
 set `1, 2, 3, 4, 5, 6, 7, 8, 9, 80, 90` and persists a normal raster Dataset
 through `DatasetService`. URLs, paths, classes and resolutions are not
-caller-controlled. Equal spatial requests for 2020 and 2023 share one temporal
+caller-controlled. The 2018 source retains official stacked two-digit values;
+GeoIntel applies the published `Classe vue` mapping and explicitly groups the
+2018-only greenhouse class `62` with artificial constructions. Source value
+`0` is treated only as implicit background/nodata. Equal spatial
+requests for 2018, 2020 and 2023 share one temporal
 series key. The exact official observation ranges are retained as
-2020-04-01/2020-04-24 and 2023-05-27/2023-06-25.
+2018-01-01/2018-12-31, 2020-04-01/2020-04-24 and
+2023-05-27/2023-06-25.
 
 ### POST `/api/v1/projects/{project_id}/datasets/{dataset_id}/raster/walous/select`
 
@@ -517,8 +522,26 @@ the persisted Dataset geometry. It never proxies the source archive.
 The Map workbench acquires every configured comparable WALOUS observation for
 the same Walloon selection when current land cover is first requested. The
 latest edition drives the current result; the ordinary temporal comparison API
-then compares 2020 and 2023 semantic area metrics. Raster evolution does not
-claim individual object additions or removals.
+then compares 2018, 2020 and 2023 semantic area metrics. The response retains
+the earlier 2018 methodology and crosswalk limitation; raster evolution does
+not claim individual object additions or removals.
+
+### GET `/api/v1/projects/{project_id}/datasets/spw-terrain/products`
+
+Returns the governed official SPW 1 m MNT 2021-2022 product and its actual
+runtime provisioning state. The source is EPSG:3812; its vertical reference is
+DNG / EPSG:5710. `configured` becomes true only after the checksum-validated
+GeoTIFF exists below `SPW_TERRAIN_SOURCE_DIR`.
+
+### POST `/api/v1/projects/{project_id}/datasets/spw-terrain/acquire`
+
+Reads only `bbox intersect Area` from the operator-provisioned official MNT,
+validates the one-band EPSG:3812/1 m source contract and plausible terrain
+values, bilinearly resamples the bounded derivative to 1-10 m and persists it
+through `DatasetService`. The request cannot choose a URL or file path. Source,
+archive and derived checksums, acquisition range, CRS, DNG datum, exact bounds,
+resolution and interpolation limitations remain provenance. The ordinary
+persisted terrain selection and PNG endpoints then analyze/render this Dataset.
 
 ### GET `/api/v1/projects/{project_id}/datasets`
 
@@ -1209,6 +1232,13 @@ The strict `POST /api/v1/detection/run` contract still requires `tile_manifest_p
 
 Returns object-detection model capability descriptors.
 
+Each descriptor exposes machine-readable `training_scope`, `validation_scope`,
+`validated_regions`, `nationally_validated` and `operator_review_required`
+fields. The configured local YOLO capability remains
+`nationally_validated=false`: the runtime binds only the existing Mol/Kempen
+operator evidence and cannot be promoted to a Belgian national claim by a UI
+label or model filename.
+
 ```json
 {
   "models": [