Initial public release

docs/specs/ERROR_CATALOG.md

@@ -0,0 +1,54 @@
+# Error Catalog
+
+Use stable error codes across backend and frontend.
+
+## Dataset errors
+
+- `DATASET_001_INVALID_FILE`: file cannot be read.
+- `DATASET_002_UNSUPPORTED_TYPE`: file type is unsupported.
+- `DATASET_003_MISSING_CRS`: CRS cannot be determined.
+- `DATASET_004_INVALID_GEOMETRY`: geometry validation failed.
+- `DATASET_005_METADATA_FAILED`: metadata extraction failed.
+- `DATASET_006_STORAGE_FAILED`: artifact could not be stored.
+
+## Raster errors
+
+- `RASTER_001_NOT_GEOREFERENCED`: transform/CRS missing.
+- `RASTER_002_BAND_OUT_OF_RANGE`: selected band does not exist.
+- `RASTER_003_CLIP_FAILED`: clipping failed.
+- `RASTER_004_TILE_FAILED`: tiling failed.
+- `RASTER_005_REPROJECT_FAILED`: reprojection failed.
+
+## Vector errors
+
+- `VECTOR_001_EMPTY_LAYER`: no features found.
+- `VECTOR_002_SCHEMA_UNSUPPORTED`: attribute schema unsupported.
+- `VECTOR_003_CRS_TRANSFORM_FAILED`: reprojection failed.
+- `VECTOR_004_OPERATION_FAILED`: spatial operation failed.
+
+## Analysis errors
+
+- `ANALYSIS_001_INVALID_INPUT_STATE`: input not ready.
+- `ANALYSIS_002_JOB_FAILED`: background job failed.
+- `ANALYSIS_003_TIMEOUT`: processing timed out.
+- `ANALYSIS_004_PARTIAL_OUTPUT`: output incomplete.
+
+## Detection errors
+
+- `DETECTION_001_MODEL_UNAVAILABLE`: configured model unavailable.
+- `DETECTION_002_INFERENCE_FAILED`: inference failed.
+- `DETECTION_003_GEOREFERENCE_FAILED`: output could not be mapped to coordinates.
+- `DETECTION_004_NO_DETECTIONS`: valid run produced no detections.
+
+## QA/QC errors
+
+- `QAQC_001_REFERENCE_MISSING`: reference layer missing.
+- `QAQC_002_CANDIDATES_MISSING`: candidate features missing.
+- `QAQC_003_MATCHING_FAILED`: matching algorithm failed.
+- `QAQC_004_THRESHOLD_INVALID`: threshold invalid.
+
+## Export errors
+
+- `EXPORT_001_NO_OUTPUTS`: nothing to export.
+- `EXPORT_002_FORMAT_UNSUPPORTED`: unsupported export format.
+- `EXPORT_003_GENERATION_FAILED`: export failed.