feat: add governed hydrology and historical imagery

backend/app/schemas/__init__.py

@@ -32,7 +32,7 @@ from .segmentation import (
 )
 from .health import HealthResponse, SystemCapabilities
 from .job import JobCreate, JobList, JobRead, JobStatus
-from .orthophoto import OrthophotoAcquireRequest, OrthophotoAcquisitionResult
+from .orthophoto import OrthophotoAcquireRequest, OrthophotoAcquisitionResult, OrthophotoProductRead
 from .external import (
     ExternalFetchRequest,
     ExternalFetchResponse,
@@ -134,6 +134,7 @@ __all__ = [
     "JobStatus",
     "OrthophotoAcquireRequest",
     "OrthophotoAcquisitionResult",
+    "OrthophotoProductRead",
     "VectorBBoxResponse",
     "VectorClipRequest",
     "VectorBufferRequest",

backend/app/schemas/orthophoto.py

@@ -10,13 +10,31 @@ from .operations import VectorSelectionBBox
 class OrthophotoAcquireRequest(BaseModel):
     bbox: VectorSelectionBBox
     area_id: UUID | None = None
+    product_key: str = "most_recent"
     force_refresh: bool = False
 
 
+class OrthophotoProductRead(BaseModel):
+    key: str
+    display_name: str
+    observation_label: str
+    temporal_granularity: str
+    native_resolution_m: float
+    supports_detection: bool
+    color_mode: str
+    catalog_url: str
+    limitation_message: str
+
+
 class OrthophotoAcquisitionResult(BaseModel):
     output_dataset_id: UUID
     reused: bool
     provider: str
+    product_key: str
+    display_name: str
+    observation_label: str
+    temporal_granularity: str
+    supports_detection: bool
     layer: str
     width: int
     height: int