feat: add temporal Mol explorer

2026-07-14 15:19:42 +02:00
parent 0ec1ab4970
commit c0943fe7d4
39 changed files with 3065 additions and 163 deletions
@@ -236,3 +236,22 @@ GRB and OSM live imports are intentionally `not_configured` in Sprint 7B. Manual
 - Multi-tenant row-level security.
 - User accounts.
 - Full model registry tables.
+
+## Temporal dataset foundation
+
+Historical observations remain normal `datasets` and `vector_features`; there
+is no parallel temporal feature store. Snapshots are grouped by
+`datasets.temporal_series_key` and carry `observed_at`, `valid_from`,
+`valid_to`, `temporal_granularity` and `source_version`. Observation time is
+kept separate from ingestion time (`imported_at`).
+
+`dataset_versions` records immutable storage provenance for every upload and
+derived output: dataset-local `version`, storage path, source version,
+observation/validity dates, checksum and source/provenance JSON. The
+`(dataset_id, version)` pair is unique. Temporal series lookup is indexed by
+`(project_id, temporal_series_key, observed_at)` and source-feature lookup by
+`(dataset_id, source_feature_id)`.
+
+Time-series comparison is read-only and aggregates persisted geometry inside a
+requested bbox. Object-level added/removed/modified evidence is only valid for
+sources that explicitly declare stable source feature identifiers.