docs: complete agricultural history rollout

2026-07-15 16:11:44 +02:00
parent 6b996d42f5
commit 48c0d21fed
5 changed files with 66 additions and 9 deletions
@@ -8557,3 +8557,59 @@ Known limitations:
 Next:
 - Implement P2 annual agricultural-use parcels, beginning with an edition and
  code-list comparability audit before any import or trend is exposed.
+
+## Sprint 205 - Governed annual agricultural-use parcels (2026-07-15)
+
+Implemented:
+- Added an explicit ALZ operator for the definitive 2008-2025 annual
+  agricultural-use parcel GeoPackages. The operator uses a fixed official
+  allowlist, streamed archive limits, ZIP path validation and native
+  EPSG:31370 schema checks before exact regional clipping.
+- Retained each official archive, annual crop-code list and checksummed
+  manifest. Derived GeoJSON enters the application only through the canonical
+  Dataset upload service and ordinary Dataset/vector_feature persistence.
+- Added server-owned exact PostGIS metrics for total declared-use hectares,
+  official main-crop groups and feature count. Comma-separated official group
+  labels found during the live source audit remain compatible with the first
+  persisted import.
+- Added the Landbouw map theme, readable source labels, the 18-edition source
+  inventory and historical comparison UI. Parcel-level object lineage remains
+  disabled because declarations and boundaries are not stable identities.
+
+Validation evidence:
+- Full local readiness passed backend compilation, 647 backend tests, one
+  Alembic head, frontend TypeScript typecheck/build and shell syntax gates.
+- Tower deployment passed container health, PostGIS 3.6 migration/schema
+  smoke, frontend proxy and icon verification.
+- All 18 definitive editions were imported into one governed regional series
+  for the exact 28-municipality Kempen transport-region Area. Database audit
+  found 18 ready Datasets, 18 DatasetVersions, matching feature/source-id
+  counts, EPSG:4326 throughout and zero invalid geometries.
+- The 2025 source contained 594,730 Flanders features. Exact regional clipping
+  retained 54,071 features, including 411 clipped at the boundary, measuring
+  60,087.0667 ha. The 2008 edition retained 43,343 regional features and
+  measured 63,272.1152 ha.
+- Live Mol analysis measured 3,223.4983 ha declared use across 2,374 features
+  for 2025, including 934.2348 ha grassland, 874.7350 ha maize and 329.1544 ha
+  potatoes. All configured crop/use groups returned explicit hectare values.
+- The exact Mol 2008-2025 comparison returned all 18 observations: 3,343.2441
+  ha to 3,223.4983 ha, a change of -119.7458 ha (-3.5817%). The UI states that
+  declarations are not cadastral ownership and individual objects cannot be
+  followed reliably between years.
+- Browser validation confirmed the current-state metrics, complete historical
+  chart, 18-edition inventory and readable authority labels through the live
+  LAN runtime.
+
+Known limitations:
+- The current campaign remains provisional and is deliberately excluded until
+  a definitive annual edition is published.
+- Declared agricultural use includes non-crop elements such as water, hedges,
+  buildings and infrastructure; it is not ownership, cadastral area or a
+  direct measure of agricultural production.
+- Cross-year comparison is valid for governed category and area totals only,
+  not for parcel identity, causal attribution or forecasts.
+
+Next:
+- Implement P3 Buildings and Addresses Register through a governed snapshot
+  operator, preserving register lifecycle semantics separately from GRB
+  footprint geometry and excluding personal data.