feat: add governed agricultural parcel history

2026-07-15 14:49:52 +02:00
parent 2f3445aa5b
commit 7f1064ff1e
16 changed files with 1194 additions and 5 deletions
@@ -1457,6 +1457,30 @@ pagination, retains raw JSON/checksums, clips polygon geometry in EPSG:31370
 and writes only through the Dataset upload flow. `--force` refetches source
 evidence but never silently replaces a conflicting persisted 2025 artifact.

+## Definitive agricultural-use parcel history
+
+Prepare a bounded subset of years for source review:
+
+```bash
+docker exec geointel python /app/scripts/provision_agricultural_parcel_history.py \
+  --years 2008,2019,2025 --fetch-only
+```
+
+Import all definitive annual editions for the regional workspace:
+
+```bash
+docker exec geointel python /app/scripts/provision_agricultural_parcel_history.py
+```
+
+The operator requires the optional GIS runtime already included in the Unraid
+image. It paginates GeoIntel API collections within the canonical 200-item
+limit, downloads only the fixed official archive allowlist, enforces a 250 MiB
+per-archive ceiling, validates one EPSG:31370 polygon GeoPackage and clips
+exactly to the persisted scope. Repeat runs reuse matching manifests and
+Datasets. `--force` refreshes retained evidence but cannot silently replace a
+conflicting persisted annual checksum. Use `--scope mol` for an independent
+municipal series.
+
 ## Tower deployment

 Push the local branch to Gitea, then rebuild the Unraid/Tower Docker runtime: