Initial GeoIntel V1 foundation

frontend/src/types.ts

@@ -0,0 +1,626 @@
+export interface ApiEnvelope<T> {
+  data: T
+}
+
+export interface ApiError {
+  code: string
+  message: string
+  details: Record<string, unknown> | unknown[]
+}
+
+export interface ApiErrorEnvelope {
+  error: ApiError
+}
+
+export interface ProjectRead {
+  id: string
+  name: string
+  description?: string | null
+  region: string
+  status: string
+  created_at?: string | null
+  updated_at?: string | null
+}
+
+export interface ProjectCreate {
+  name: string
+  description?: string | null
+  region?: string
+}
+
+export interface ProjectListResponse {
+  items: ProjectRead[]
+  total: number
+  limit: number
+  offset: number
+}
+
+export interface DemoWorkflowResponse {
+  project_id: string
+  area_id: string
+  reference_dataset_id: string
+  candidate_dataset_id: string
+  quality_check_id: string
+  metric_count: number
+  status: string
+  message: string
+  created: boolean
+}
+
+export interface AreaRead {
+  id: string
+  project_id: string
+  name: string
+  original_crs?: string | null
+  area_m2?: number | null
+  created_at?: string | null
+  geometry_type?: string | null
+}
+
+export interface AreaCreate {
+  name: string
+  geometry: GeoJSON.Polygon | GeoJSON.MultiPolygon
+  crs?: string
+}
+
+export interface AreaListResponse {
+  items: AreaRead[]
+  total: number
+  limit: number
+  offset: number
+}
+
+export interface DatasetCreateResponse {
+  id: string
+  name: string
+  dataset_type: string
+  source: string
+  dataset_role?: string
+  source_name?: string | null
+  reference_layer_name?: string | null
+  source_metadata?: Record<string, unknown> | null
+  provenance_metadata?: Record<string, unknown> | null
+  imported_at?: string | null
+  project_id: string
+  area_id?: string | null
+  storage_path?: string | null
+  original_filename?: string | null
+  stored_filename?: string | null
+  content_type?: string | null
+  size_bytes?: number | null
+  checksum_sha256?: string | null
+  crs?: string | null
+  bounds_json?: Record<string, number> | null
+  metadata_json?: Record<string, unknown> | null
+  vector_summary?: VectorSummary | null
+  status: string
+  derived_from_dataset_id?: string | null
+  created_at?: string | null
+  feature_count?: number | null
+}
+
+export interface JobRead {
+  id: string
+  job_type: string
+  status: string
+  project_id: string
+  dataset_id?: string | null
+  input_dataset_id?: string | null
+  output_dataset_id?: string | null
+  parameters_json: Record<string, unknown>
+  result_json?: Record<string, unknown> | null
+  error_message?: string | null
+  created_at?: string | null
+  started_at?: string | null
+  finished_at?: string | null
+}
+
+export interface JobListResponse {
+  items: JobRead[]
+  total: number
+  limit: number
+  offset: number
+}
+
+export interface VectorSummary {
+  feature_count?: number | null
+  geometry_types?: string[] | null
+  bounds_json?: Record<string, number> | null
+  approximate_area_m2?: number | null
+  crs?: string | null
+  feature_geometry_count?: number | null
+  invalid_features?: number | null
+  crs_assumed?: boolean | null
+}
+
+export interface VectorSummaryResponse {
+  feature_count?: number | null
+  geometry_types?: string[] | null
+  bounds_json?: Record<string, number> | null
+  approximate_area_m2?: number | null
+  crs?: string | null
+  feature_geometry_count?: number | null
+  invalid_features?: number | null
+  crs_assumed?: boolean | null
+}
+
+export interface RasterMetadataResponse {
+  driver: string
+  dataset_id?: string
+  width: number
+  height: number
+  band_count: number
+  crs?: string | null
+  bounds?: number[]
+  resolution?: number[]
+  dtype?: string[]
+  nodata?: unknown
+  transform?: string[] | number[] | null
+  path?: string
+  size_bytes?: number | null
+  checksum_sha256?: string | null
+  operation?: string | null
+  operation_parameters?: Record<string, unknown> | null
+  source_dataset_id?: string | null
+}
+
+export interface RasterInspectResponse {
+  dataset_id: string
+  ready: boolean
+  metadata: Record<string, unknown>
+}
+
+export interface RasterPreviewPayload {
+  path: string
+  format: string
+  width: number | null
+  height: number | null
+}
+
+export interface RasterPreviewResponse {
+  dataset_id: string
+  ready: boolean
+  preview: RasterPreviewPayload
+  metadata?: Record<string, unknown>
+}
+
+export interface RasterBandStats {
+  band_index: number
+  dtype: string | null
+  min: number | null
+  max: number | null
+  mean: number | null
+  std: number | null
+  nodata_count: number
+  nodata_ratio: number
+  valid_pixel_count: number
+  histogram: number[] | null
+  histogram_bins: number[] | null
+}
+
+export interface RasterStatsResponse {
+  dataset_id: string
+  source_dataset_id?: string | null
+  bands: RasterBandStats[]
+  generated_at?: string | null
+}
+
+export interface RasterNdviRequest {
+  nir_band: number
+  red_band: number
+  output_name?: string
+}
+
+export interface RasterNdwiRequest {
+  green_band: number
+  nir_band: number
+  output_name?: string
+}
+
+export interface RasterNdbiRequest {
+  swir_band: number
+  nir_band: number
+  output_name?: string
+}
+
+export interface RasterTileManifestTile {
+  path: string
+  pixel_window: number[]
+  bounds: number[]
+  transform: number[]
+  index: number
+}
+
+export interface RasterTileManifest {
+  tile_set_id: string
+  source_dataset_id: string
+  source_raster_id: string
+  bounds: number[]
+  tile_size: number
+  overlap: number
+  parameters: Record<string, unknown>
+  created_at: string
+  tile_paths: string[]
+  count: number
+  tiles: RasterTileManifestTile[]
+}
+
+export interface RasterTileResponse {
+  dataset_id: string
+  ready: boolean
+  operation: string
+  tile_set_id: string
+  tile_size: number
+  overlap: number
+  manifest_path: string
+  count: number
+  manifest: RasterTileManifest
+}
+
+export interface VectorBBoxResponse {
+  dataset_id: string
+  bounds_json: Record<string, number> | null
+  feature_count: number
+  crs?: string | null
+}
+
+export interface VectorStatsResponse {
+  dataset_id: string
+  feature_count: number
+  geometry_type_summary: Record<string, number>
+  bounds_json: Record<string, number> | null
+  crs?: string | null
+}
+
+export interface DatasetListResponse {
+  items: DatasetCreateResponse[]
+  total: number
+  limit: number
+  offset: number
+}
+
+export interface GeojsonEnvelopeResponse {
+  data: object
+}
+
+export interface ProviderCapability {
+  provider_name: string
+  display_name: string
+  authority_level: 'authoritative' | 'contextual' | 'manual' | 'fixture' | string
+  supported_layers: string[]
+  supported_geometry_types: string[]
+  supported_query_modes: string[]
+  fetch_signature: string
+  configured: boolean
+  status: string
+  limitation_message: string
+  attribution: string
+  license_note: string
+  not_configured_reason: string | null
+}
+
+export interface SystemCapabilitiesResponse {
+  status: string
+  service: string
+  version: string
+  database: string | null
+  postgis: boolean
+  rasterio: boolean
+  geopandas: boolean
+  yolo: boolean | string
+  sam: boolean | string
+  grb: string
+  sentinel: string
+  providers: ProviderCapability[]
+}
+
+export interface ProviderCapabilitiesResponse {
+  providers: ProviderCapability[]
+}
+
+export interface ProviderLayersResponse {
+  provider_name: string
+  layers: string[]
+}
+
+export interface ProviderStatusResponse {
+  provider_name: string
+  configured: boolean
+  status: string
+  limitation_message: string
+}
+
+export interface ProviderImportResponse {
+  provider_name: string
+  status: string
+  message: string
+  requested_layers: string[]
+  dataset_id: string | null
+  dataset_role?: string | null
+  source_name?: string | null
+}
+
+export interface DetectionModelCapability {
+  model_id: string
+  display_name: string
+  framework: string
+  task_type: string
+  supported_classes: string[]
+  configured: boolean
+  status: string
+  limitation_message: string
+  version?: string | null
+}
+
+export interface DetectionModelsResponse {
+  models: DetectionModelCapability[]
+}
+
+export interface DetectionRunRequest {
+  project_id: string
+  dataset_id: string
+  model_id: string
+  confidence_threshold: number
+  class_filter?: string[] | null
+  tile_manifest_path?: string | null
+  parameters_json?: Record<string, unknown>
+}
+
+export interface DetectionRunResponse {
+  analysis_run_id: string
+  job_id: string
+  project_id: string
+  dataset_id: string
+  model_id: string
+  status: string
+  detection_count: number
+  error_code?: string | null
+  message: string
+}
+
+export interface DetectionRunRead {
+  id: string
+  project_id: string
+  dataset_id?: string | null
+  job_id?: string | null
+  analysis_type: string
+  status: string
+  model_name?: string | null
+  model_version?: string | null
+  parameters_json: Record<string, unknown>
+  result_json?: Record<string, unknown> | null
+  error_message?: string | null
+  created_at?: string | null
+  started_at?: string | null
+  finished_at?: string | null
+}
+
+export interface DetectionRunListResponse {
+  items: DetectionRunRead[]
+  total: number
+}
+
+export interface DetectionRead {
+  id: string
+  project_id: string
+  dataset_id?: string | null
+  analysis_run_id?: string | null
+  job_id?: string | null
+  model_name: string
+  model_version?: string | null
+  class_name: string
+  confidence: number
+  bbox_json?: Record<string, unknown> | null
+  source_tile_path?: string | null
+  properties_json?: Record<string, unknown> | null
+  created_at?: string | null
+}
+
+export interface DetectionListResponse {
+  items: DetectionRead[]
+  total: number
+}
+
+export interface DetectionQaRequest {
+  reference_dataset_id: string
+  iou_threshold: number
+  class_name?: string | null
+  min_confidence?: number | null
+}
+
+export interface DetectionQaResult {
+  status: string
+  quality_check_id: string
+  analysis_run_id: string
+  reference_dataset_id: string
+  candidate_feature_count: number
+  reference_feature_count: number
+  matches: number
+  false_positives: number
+  false_negatives: number
+  precision?: number | null
+  recall?: number | null
+  f1_score?: number | null
+  mean_iou?: number | null
+  iou_threshold: number
+  warnings: string[]
+}
+
+export type SegmentationModelCapability = DetectionModelCapability
+
+export interface SegmentationModelsResponse {
+  models: SegmentationModelCapability[]
+}
+
+export interface SegmentationRunRequest {
+  project_id: string
+  dataset_id: string
+  model_id: string
+  confidence_threshold: number
+  class_filter?: string[] | null
+  tile_manifest_path?: string | null
+  parameters_json?: Record<string, unknown>
+}
+
+export interface SegmentationRunResponse {
+  analysis_run_id: string
+  job_id: string
+  project_id: string
+  dataset_id: string
+  model_id: string
+  status: string
+  segmentation_count: number
+  error_code?: string | null
+  message: string
+}
+
+export interface SegmentationRunRead {
+  id: string
+  project_id: string
+  dataset_id?: string | null
+  job_id?: string | null
+  analysis_type: string
+  status: string
+  model_name?: string | null
+  model_version?: string | null
+  parameters_json: Record<string, unknown>
+  result_json?: Record<string, unknown> | null
+  error_message?: string | null
+  created_at?: string | null
+  started_at?: string | null
+  finished_at?: string | null
+}
+
+export interface SegmentationRunListResponse {
+  items: SegmentationRunRead[]
+  total: number
+}
+
+export interface SegmentationRead {
+  id: string
+  project_id: string
+  dataset_id?: string | null
+  analysis_run_id?: string | null
+  job_id?: string | null
+  model_name: string
+  model_version?: string | null
+  class_name: string
+  confidence?: number | null
+  bbox_json?: Record<string, unknown> | null
+  area_m2?: number | null
+  mask_path?: string | null
+  source_tile_path?: string | null
+  tile_index?: number | null
+  properties_json?: Record<string, unknown> | null
+  provenance_json?: Record<string, unknown> | null
+  created_at?: string | null
+}
+
+export interface SegmentationListResponse {
+  items: SegmentationRead[]
+  total: number
+}
+
+export interface SegmentationQaRequest {
+  reference_dataset_id: string
+  iou_threshold: number
+  class_name?: string | null
+  min_confidence?: number | null
+}
+
+export type SegmentationQaResult = DetectionQaResult
+
+export interface QaComparisonRequest {
+  candidate_dataset_id: string
+  reference_dataset_id: string
+  iou_threshold: number
+  area_id?: string | null
+}
+
+export interface QaComparisonResult {
+  status: string
+  warnings: string[]
+  candidate_feature_count: number
+  reference_feature_count: number
+  matches: number
+  false_positives: number
+  false_negatives: number
+  precision: number | null
+  recall: number | null
+  f1_score: number | null
+  mean_iou: number | null
+  iou_threshold: number
+  unsupported_geometry: boolean
+  unsupported_geometries: string[]
+  generated_at: string
+}
+
+export interface MetricRead {
+  id: string
+  quality_check_id?: string | null
+  analysis_run_id?: string | null
+  metric_key: string
+  metric_value?: number | null
+  metric_unit?: string | null
+  label?: string | null
+  metadata_json?: Record<string, unknown> | null
+  created_at?: string | null
+}
+
+export interface QualityCheckRead {
+  id: string
+  project_id: string
+  job_id?: string | null
+  analysis_run_id?: string | null
+  candidate_dataset_id?: string | null
+  reference_dataset_id: string
+  check_type: string
+  status: string
+  score?: number | null
+  parameters_json?: Record<string, unknown> | null
+  findings_json?: Record<string, unknown> | null
+  created_at?: string | null
+  completed_at?: string | null
+  metrics: MetricRead[]
+}
+
+export interface QualityCheckListResponse {
+  items: QualityCheckRead[]
+  total: number
+  limit: number
+  offset: number
+}
+
+export type ExportKind = 'dataset' | 'detection_run' | 'segmentation_run'
+
+export interface ExportRead {
+  id: string
+  project_id: string
+  analysis_run_id?: string | null
+  export_type: string
+  storage_path: string
+  metadata_json?: Record<string, unknown> | null
+  created_at?: string | null
+  status: string
+}
+
+export interface ExportCreateResponse {
+  export_id: string
+  path: string
+  status: string
+  export_type: string
+  metadata_json?: Record<string, unknown> | null
+}
+
+export interface ExportListResponse {
+  items: ExportRead[]
+  total: number
+  limit: number
+  offset: number
+}
+
+export interface ExportContentResponse {
+  export_id: string
+  export_type: string
+  content: Record<string, unknown>
+}