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
@@ -116,6 +116,23 @@ checksums, boundary checksum, page/feature counts, clipping diagnostics and
 official class totals. The final GeoJSON is the retained source artifact while
 `datasets` and `vector_features` remain the canonical queryable PostGIS state.

+Definitive agricultural-use parcel evidence lives under:
+
+```text
+storage/operator-evidence/agricultural-use-parcels/{scope}/{year}/
+  agpa_{year}_*_public.zip
+  agricultural_use_parcels_{year}_{scope}.geojson
+  agricultural_use_parcels_{year}_crop_codes.json
+  agricultural_use_parcels_{year}_{scope}.manifest.json
+```
+
+The official ZIP is immutable source evidence and is never removed by normal
+cache cleanup. The extracted GeoPackage is temporary to avoid retaining a
+second full source copy. The normalized GeoJSON is the canonical upload
+artifact; Dataset and vector_feature rows remain the queryable PostGIS state.
+The manifest binds source, crop-code list and upload artifact checksums. A
+checksum conflict with an existing annual Dataset fails closed.
+
 Offline demo export artifacts can be inspected and cleaned with:

 ```bash