204 lines
4.2 KiB
Markdown
204 lines
4.2 KiB
Markdown
# 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
|