feat: add governed hydrology and historical imagery

backend/app/services/dataset_service.py

@@ -422,6 +422,11 @@ class DatasetService:
         source_metadata: dict[str, Any],
         provenance_metadata: dict[str, Any],
         area_id: UUID | None = None,
+        temporal_series_key: str | None = None,
+        observed_at: datetime | None = None,
+        valid_from: datetime | None = None,
+        valid_to: datetime | None = None,
+        temporal_granularity: str | None = None,
         source_version: str | None = None,
         content_type: str = "image/tiff",
     ) -> DatasetCreateResponse:
@@ -438,6 +443,14 @@ class DatasetService:
         safe_filename = DatasetService._validate_upload_filename(filename)
         if DatasetService._extension_for_path(safe_filename) not in DatasetService.RASTER_EXTENSIONS:
             raise AppError(code="INVALID_UPLOAD", message="Raster artifacts require a GeoTIFF filename", status_code=415)
+        temporal = DatasetService._validate_temporal_metadata(
+            temporal_series_key=temporal_series_key,
+            observed_at=observed_at,
+            valid_from=valid_from,
+            valid_to=valid_to,
+            temporal_granularity=temporal_granularity,
+            source_version=source_version,
+        )
 
         dataset_id = uuid.uuid4()
         storage_info = StorageService.persist_dataset_file(
@@ -462,7 +475,7 @@ class DatasetService:
                 source_metadata=source_metadata,
                 provenance_metadata=provenance_metadata,
                 imported_at=datetime.now(timezone.utc),
-                source_version=source_version,
+                **temporal,
                 storage_path=storage_info["storage_path"],
                 original_filename=storage_info["original_filename"],
                 stored_filename=storage_info["stored_filename"],
@@ -483,6 +496,9 @@ class DatasetService:
                     version=1,
                     storage_path=dataset.storage_path,
                     source_version=dataset.source_version,
+                    observed_at=dataset.observed_at,
+                    valid_from=dataset.valid_from,
+                    valid_to=dataset.valid_to,
                     checksum_sha256=dataset.checksum_sha256,
                     source_metadata=dataset.source_metadata,
                     provenance_metadata=dataset.provenance_metadata,