Initial public release

docs/BUILD_TICKETS_M3.md

@@ -0,0 +1,203 @@
+# Build Tickets M3
+
+This file converts the implementation epics into concrete Codex-ready tickets.
+
+## Ticket format
+
+Each ticket must be implemented with:
+
+- backend changes if applicable
+- frontend changes if applicable
+- tests where applicable
+- documentation updates
+- changelog entry
+
+## T-001 Backend package scaffold
+
+Create FastAPI package structure:
+
+```text
+backend/app/main.py
+backend/app/api/router.py
+backend/app/core/config.py
+backend/app/core/database.py
+backend/app/models/
+backend/app/schemas/
+backend/app/services/
+backend/app/workers/
+backend/tests/
+```
+
+Acceptance:
+
+- `GET /health` returns status ok.
+- backend imports cleanly.
+- tests can run without external geospatial data.
+
+## T-002 Database and Alembic scaffold
+
+Add SQLAlchemy and Alembic setup for PostgreSQL/PostGIS.
+
+Acceptance:
+
+- database URL comes from environment.
+- migrations directory exists.
+- first migration creates PostGIS extension if available.
+- migration plan documented.
+
+## T-003 Project model and API
+
+Implement project entity.
+
+Acceptance:
+
+- create project
+- list projects
+- read project
+- update project
+- soft delete or archive project
+- response envelope followed
+
+## T-004 Area model and geometry API
+
+Implement areas linked to projects.
+
+Acceptance:
+
+- create polygon area as GeoJSON
+- validate geometry
+- store geometry in PostGIS
+- calculate area in square meters using projected CRS
+- return bounds and centroid
+
+## T-005 Frontend foundation
+
+Create React + TypeScript app structure.
+
+Acceptance:
+
+- app boots
+- route layout exists
+- API client exists
+- error/loading components exist
+- navigation includes Workspace, Map, Datasets, Raster, Vector, Detection, QA/QC, Exports
+
+## T-006 Map workbench foundation
+
+Implement map page and area drawing contract.
+
+Acceptance:
+
+- map displays Kempen default viewport
+- user can draw or load an example polygon
+- polygon can be submitted to backend as area
+- active area can be selected
+
+## T-007 Dataset upload API
+
+Implement dataset registration and upload.
+
+Acceptance:
+
+- accepts GeoTIFF, GeoJSON, ZIP shapefile, GPKG placeholder handling
+- stores original file under storage/originals
+- creates dataset row
+- status starts as uploaded
+- returns metadata extraction job status
+
+## T-008 Raster metadata service
+
+Implement Rasterio metadata extraction.
+
+Acceptance:
+
+- CRS
+- bounds
+- width/height
+- band count
+- resolution
+- nodata
+- dtype
+- transform
+- summary stats for small rasters or sampled stats for large rasters
+
+## T-009 Vector metadata service
+
+Implement GeoPandas metadata extraction.
+
+Acceptance:
+
+- CRS
+- bounds
+- feature count
+- geometry types
+- columns
+- invalid geometry count
+- area summary where applicable
+
+## T-010 GRB reference fetcher skeleton
+
+Implement service contract for GRB WFS fetch.
+
+Acceptance:
+
+- service accepts area geometry
+- builds BBOX or polygon filter request
+- stores retrieved features as dataset/layer
+- if live WFS unavailable, returns a clear source_unavailable status without crashing
+
+## T-011 Detection pipeline interface
+
+Implement detection run model and interface.
+
+Acceptance:
+
+- request creates analysis_run
+- job lifecycle status exists
+- deterministic fixture inference can populate detections for demo fixtures
+- output geometries are stored and exported as GeoJSON
+
+## T-012 QA/QC engine v1
+
+Implement reference-vs-prediction matching.
+
+Acceptance:
+
+- IoU threshold configurable, default 0.5
+- precision, recall, F1 calculated
+- false positives and false negatives classified
+- QA result stored
+- fixture test passes with known expected metrics
+
+## T-013 Export API
+
+Implement export registry and GeoJSON export.
+
+Acceptance:
+
+- export detection results as FeatureCollection
+- export QA false positives/negatives as FeatureCollection
+- export analysis summary JSON
+- exports have stable file paths under storage/exports
+
+## T-014 Frontend dataset and analysis panels
+
+Implement visible pages for dataset, detection and QA workflows.
+
+Acceptance:
+
+- dataset list shows status and metadata
+- detection page starts run and shows result state
+- QA page shows metrics and error classes
+- map overlays are connected to available GeoJSON outputs
+
+## T-015 Stabilization pass
+
+Acceptance:
+
+- no broken navigation
+- no unhandled promise rejections
+- backend health green
+- core tests green
+- README quickstart updated
+- CHANGELOG updated