feat: add governed nationwide AOI orchestration and CUDA enforcement

backend/app/schemas/aoi_operation.py

@@ -0,0 +1,75 @@
+from __future__ import annotations
+
+from datetime import datetime
+from uuid import UUID
+
+from pydantic import BaseModel, Field
+
+from app.schemas.operations import VectorSelectionBBox
+
+
+class AoiOperationCreate(BaseModel):
+    area_id: UUID | None = None
+    bbox: VectorSelectionBBox | None = None
+    operation_type: str = Field(min_length=1, max_length=128)
+    provider_key: str = Field(min_length=1, max_length=120)
+    product_key: str = Field(min_length=1, max_length=120)
+    coverage_zone: str | None = Field(default=None, max_length=64)
+    max_partition_side_m: float | None = Field(default=None, gt=0, le=60_000)
+    max_attempts: int = Field(default=3, ge=1, le=10)
+    parameters_json: dict = Field(default_factory=dict)
+
+
+class AoiPartitionRead(BaseModel):
+    id: UUID
+    partition_key: str
+    provider_key: str
+    product_key: str
+    ordinal: int
+    status: str
+    attempt_count: int
+    max_attempts: int
+    checkpoint_json: dict | None = None
+    result_json: dict | None = None
+    error_message: str | None = None
+
+    model_config = {"from_attributes": True}
+
+
+class AoiOperationRead(BaseModel):
+    id: UUID
+    project_id: UUID
+    area_id: UUID | None = None
+    parent_job_id: UUID | None = None
+    operation_type: str
+    status: str
+    request_json: dict
+    plan_json: dict
+    result_json: dict | None = None
+    error_message: str | None = None
+    progress: float
+    partition_counts: dict[str, int]
+    partitions: list[AoiPartitionRead] = Field(default_factory=list)
+    created_at: datetime | None = None
+    started_at: datetime | None = None
+    finished_at: datetime | None = None
+
+
+class AoiOperationList(BaseModel):
+    items: list[AoiOperationRead]
+    total: int
+
+
+class AoiPartitionCheckpoint(BaseModel):
+    checkpoint_json: dict = Field(default_factory=dict)
+
+
+class AoiPartitionComplete(BaseModel):
+    result_json: dict = Field(default_factory=dict)
+    skipped: bool = False
+
+
+class AoiPartitionFail(BaseModel):
+    error_message: str = Field(min_length=1, max_length=4000)
+    retryable: bool = True
+    details: dict = Field(default_factory=dict)

backend/app/schemas/coverage.py

@@ -65,9 +65,25 @@ class CoverageResolutionItem(BaseModel):
     status: CoverageStatus
     source_names: list[str]
     materialized_dataset_ids: list[UUID]
+    evidence: list["CoverageEvidenceItem"] = Field(default_factory=list)
     limitation_message: str
 
 
+class CoverageEvidenceItem(BaseModel):
+    dataset_id: UUID
+    source_name: str
+    authority_level: CoverageAuthority
+    source_version: str | None = None
+    observed_at: str | None = None
+    published_at: str | None = None
+    crs: str | None = None
+    resolution: dict | None = None
+    coverage_bbox_epsg4326: list[float] | None = None
+    attribution: str | None = None
+    license_note: str | None = None
+    checksum_sha256: str | None = None
+
+
 class CoverageResolveResponse(BaseModel):
     project_id: UUID
     bbox: CoverageBBox

backend/app/schemas/detection.py

@@ -141,6 +141,7 @@ class YoloPreflightChecks(BaseModel):
 
     enabled: bool
     dependencies_available: bool | None = None
+    accelerator_ready: bool | None = None
     model_path_set: bool | None = None
     model_file_exists: bool | None = None
     model_load_requested: bool
@@ -160,6 +161,8 @@ class YoloRuntimeDetails(BaseModel):
     torch_version: str | None = None
     ultralytics_version: str | None = None
     cuda_available: bool | None = None
+    configured_device: str
+    cuda_required: bool
 
 
 class YoloPreflightResponse(BaseModel):

backend/app/schemas/dhmv.py

@@ -58,7 +58,7 @@ class TerrainSelectionRequest(BaseModel):
 
 class TerrainPartitionSelectionRequest(TerrainSelectionRequest):
     product_key: str = "dtm_1m"
-    dataset_ids: list[UUID] | None = Field(default=None, min_length=1, max_length=16)
+    dataset_ids: list[UUID] | None = Field(default=None, min_length=1, max_length=4096)
 
 
 class TerrainMetric(BaseModel):

backend/app/schemas/flood_hazard.py

@@ -61,7 +61,7 @@ class FloodHazardSelectionRequest(BaseModel):
 
 class FloodHazardPartitionSelectionRequest(FloodHazardSelectionRequest):
     product_key: str = "pluviaal_current_t100"
-    dataset_ids: list[UUID] | None = Field(default=None, min_length=1, max_length=16)
+    dataset_ids: list[UUID] | None = Field(default=None, min_length=1, max_length=4096)
 
 
 class FloodHazardMetric(BaseModel):

backend/app/schemas/selection_partitions.py

@@ -8,7 +8,7 @@ from .operations import VectorSelectionBBox
 
 
 class VectorPartitionSelectionRequest(BaseModel):
-    dataset_ids: list[UUID] = Field(min_length=1, max_length=16)
+    dataset_ids: list[UUID] = Field(min_length=1, max_length=4096)
     bbox: VectorSelectionBBox
     area_id: UUID | None = None
     limit: int = Field(default=1000, ge=1, le=1000)