# 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.