geointel/docs/ACCEPTANCE_TEST_CATALOG.md

Acceptance Test Catalog

Foundation

• Health endpoint returns application status.
• API error responses follow the standard envelope.
• CORS is configured for frontend local development.
• Database connection failure is reported but does not crash import-time tests.

Projects

• Create project with valid payload.
• Reject empty name.
• List projects sorted by newest first.
• Get missing project returns 404 envelope.

Areas

• Create area from valid Polygon GeoJSON.
• Reject invalid geometry.
• Store geometry with expected SRID.
• Return FeatureCollection for project areas.

Datasets

• Upload supported vector file.
• Extract geometry type, feature count, bounds and CRS when available.
• Reject unsupported extension with explicit error code.
• Dataset status transitions: uploaded -> metadata_extracted -> ready or failed.

Raster

• Read raster metadata when valid raster available.
• Return band count, bounds, CRS, width, height and resolution.
• Clip request creates a processing job.
• Tile request creates deterministic tile manifest.

Vector

• Read vector metadata from GeoJSON fixture.
• Clip vector features to area.
• Buffer vector features by distance in meters.
• Intersect two vector layers.

Detection

• Create detection analysis run.
• Demo-mode detector creates stable predictions.
• Detections include class, confidence, geometry and source tile.
• Detection outputs are exportable as GeoJSON.

Segmentation

• Create segmentation analysis run.
• Demo-mode segmenter creates stable polygons.
• Segmentations include class, area_m2, confidence and optional mask path.

QA/QC

• Match detection to reference by IoU threshold.
• Calculate TP, FP, FN.
• Calculate precision, recall and F1.
• Generate false positive and false negative layers.

Frontend

• Every route has loading, empty, error and success states.
• Project creation navigates to workspace.
• Map page can render GeoJSON area fixture.
• Dataset detail shows extracted metadata.
• Analysis status updates are visible.

Export

• GeoJSON export returns downloadable file.
• CSV metrics export includes metric key, value and unit.
• Export records are listed in project exports.