feat: add cross-domain Mol data profile

docs/API_CONTRACTS.md

@@ -322,6 +322,53 @@ Returns a constrained transparent PNG for a persisted governed VMM flood-depth
 Dataset. It never accepts an arbitrary path or coverage id and is used by the
 existing MapLibre image-overlay path.
 
+### GET `/api/v1/projects/{project_id}/datasets/thematic-raster/products`
+
+Returns the fixed MercatorNet registry for `space_occupation_2025`,
+`open_space_2022`, `population_density_2019`, `node_value_2022` and
+`service_level_2022`. Every item includes the governed WCS coverage id, native
+resolution, source unit, observation year, legend, attribution and limitation.
+
+### POST `/api/v1/projects/{project_id}/datasets/thematic-raster/acquire`
+
+Acquires one allowlisted official coverage behind the synchronous Job
+abstraction. The request accepts only an EPSG:4326 bbox, optional project Area,
+one registry product key and an explicit refresh flag:
+
+```json
+{
+  "bbox": {"min_x": 5.03, "min_y": 51.15, "max_x": 5.25, "max_y": 51.33, "crs": "EPSG:4326"},
+  "area_id": "optional-project-area-uuid",
+  "product_key": "population_density_2019",
+  "force_refresh": false
+}
+```
+
+The backend uses native 10 m or 100 m resolution, splits requests into bounded
+WCS 1.0 tiles, validates EPSG:31370 and documented source values, masks the
+exact Area and persists an ordinary raster Dataset and DatasetVersion. It does
+not accept arbitrary URLs, coverage ids, resolutions or expressions.
+
+### POST `/api/v1/projects/{project_id}/datasets/{dataset_id}/raster/thematic/select`
+
+Returns source-correct metrics for a bbox and optional exact Area mask:
+
+- occupied/open hectares, share and valid raster area for binary products;
+- estimated inhabitants plus mean/P90 inhabitants per hectare for the 2019
+  population raster;
+- mean, P10, median and P90 source score for node value and service level.
+
+The response names estimate status, aggregation method, source unit,
+observation year, attribution, unsupported metrics and product limitation.
+Current register population, live public-transport availability and causal
+interpretations are not produced.
+
+### GET `/api/v1/projects/{project_id}/datasets/{dataset_id}/raster/thematic/image`
+
+Returns a constrained transparent PNG generated from the persisted governed
+raster. It accepts neither an arbitrary file path nor a provider URL and feeds
+the existing MapLibre image-overlay path.
+
 ### GET `/api/v1/projects/{project_id}/datasets`
 
 List datasets.