geointel/docs/TODO.md

# GeoIntel TODO

This file now starts with the current implementation status. Older preparation/backlog sections are preserved below as historical planning context and should not be treated as the live sprint board without checking `docs/CODEX_EXECUTION_LOG.md`.

## Release hardening status

- [x] Remove Python `datetime.utcnow()` deprecation warnings from backend service paths.
- [x] Split frontend production build into app, React vendor and MapLibre vendor chunks.
- [x] Enforce Python deprecation warnings as release-readiness failures.
- [x] Fix Docker backend package install order and remove mandatory root `.env` dependency.
- [x] Add Docker build context ignores for backend and frontend.
- [x] Run Docker/PostGIS live validation on Tower/Unraid.

## Current implementation status

- [x] Backend FastAPI foundation, health endpoint and service structure.
- [x] React/TypeScript frontend foundation and MapLibre workbench.
- [x] Map layer visibility, opacity and feature property inspection.
- [x] Selected project area/AOI map overlay with visibility and opacity controls.
- [x] SQLAlchemy/PostGIS ORM models and Alembic migration chain through Sprint 9.
- [x] Dataset upload, storage metadata and vector feature persistence.
- [x] Raster metadata and raster operation service boundaries.
- [x] Vector operation service boundaries and fixture-backed tests.
- [x] Provider registry skeleton for GRB, OSM, manual and fixture providers.
- [x] Detection Lab foundation, persistence, GeoJSON output and QA integration.
- [x] Configured-YOLO optional dependency strategy and local preflight.
- [x] Segmentation Lab foundation, persistence, GeoJSON output and QA integration.
- [x] QA/QC golden benchmark fixtures and script.
- [x] Explicit offline demo workflow seed for project, AOI, fixture datasets and persisted QA metrics.
- [x] Project-scoped QA/QC result listing and frontend QA/QC Results panel.
- [x] Persisted export foundation for vector/detection/segmentation GeoJSON and project metadata JSON.
- [x] Lightweight HTML project report artifact export.
- [x] V1 readiness handoff summary in project metadata/report exports.
- [x] Browser-facing demo/export workflow smoke script with connected V1 state checks.
- [x] Compact V1 workbench status strip for project, AOI, datasets, map, QA/QC and exports.
- [x] Dry-run-first demo export artifact cleanup tooling.
- [x] Live Docker/PostGIS validation on Tower/Unraid.
- [x] Real YOLO compatibility smoke with optional AI extras and local model file.
- [x] Detection and segmentation workflow hook extraction beyond Sprint 10.
- [x] Export and QA/QC workflow hook extraction beyond Sprint 10.
- [ ] Further frontend state/module decomposition for datasets and raster/vector operations.

## Sprint 8 status

- [x] Detection foundation ORM and migration
- [x] Detection model registry capability stubs
- [x] Detection run service boundary
- [x] Detection API foundation
- [x] Detection Lab UI foundation
- [x] Segmentation Lab foundation
- [x] Configured YOLO local preflight
- [x] Real YOLO/PyTorch model compatibility smoke

## 0. Repository Foundation

- [x] Repo mappenstructuur voorbereiden
- [x] Productdocumentatie voorbereiden
- [x] Architectuurdocumentatie voorbereiden
- [x] Codex build plan voorbereiden
- [x] Masterprompt voorbereiden
- [ ] Init git repository
- [x] Voeg echte backend scaffold toe
- [x] Voeg echte frontend scaffold toe

## 1. Backend Foundation

- [x] FastAPI app aanmaken
- [x] Config systeem aanmaken
- [x] Database connectie voorbereiden
- [x] SQLAlchemy models toevoegen
- [x] Alembic migrations toevoegen
- [x] Health endpoint toevoegen
- [x] Tests voor health endpoint toevoegen

## 2. Database / PostGIS

- [x] Docker compose met PostgreSQL/PostGIS
- [x] PostGIS extensie activeren
- [x] projects tabel
- [x] areas tabel
- [x] datasets tabel
- [x] analysis_runs tabel
- [x] detections tabel
- [x] quality_checks tabel
- [x] exports tabel
- [x] spatial indexes

## 3. Frontend Foundation

- [x] React + TypeScript scaffold
- [x] Routing
- [x] Layout met sidebar
- [x] API client
- [x] Project pages
- [x] Map Workbench basis
- [x] Map layer controls
- [x] Feature property inspector
- [x] Selected area display

## 4. Project & Area API

- [ ] POST /projects
- [ ] GET /projects
- [ ] GET /projects/{id}
- [ ] POST /projects/{id}/areas
- [ ] GET /projects/{id}/areas
- [ ] GeoJSON validatie

## 5. Dataset Manager

- [ ] Upload endpoint
- [ ] Storage paths
- [ ] Raster metadata extraction
- [ ] Vector metadata extraction
- [ ] Dataset list UI
- [ ] Dataset detail UI

## 6. Raster Core

- [ ] Rasterio metadata reader
- [ ] Raster preview generation
- [ ] Clip raster by area
- [ ] Tile raster by area
- [ ] Save tile metadata

## 7. Vector Core

- [ ] GeoPandas importer
- [ ] CRS detection
- [ ] CRS transformation
- [ ] Geometry validation
- [ ] Clip vector by area
- [ ] Store features in PostGIS

## 8. Reference Data

- [ ] OSM fetcher als fallback
- [ ] GRB integration research verwerken in code
- [ ] Reference dataset cache
- [ ] Reference layer viewer

## 9. Detection Lab

- [ ] YOLO wrapper
- [ ] Model config
- [ ] Inference job
- [ ] Pixel bbox naar geo polygon
- [ ] Detections opslaan
- [ ] Detection UI
- [ ] GeoJSON export

## 10. QA/QC Lab

- [ ] Spatial matching
- [ ] IoU berekening
- [ ] Precision/recall/F1
- [ ] False positive layer
- [ ] False negative layer
- [x] QA dashboard
- [x] QA export foundation

## 11. Segmentation Lab

- [x] Segmentation service design
- [x] Mask artifact path convention
- [ ] Polygonize masks
- [x] Segmentatiekaartlaag

## 12. Change Detection

- [ ] Compare two runs
- [x] Added/removed objects
- [x] Change stats
- [x] Change layer

## 13. Tests

- [x] Unit tests GIS helpers
- [x] API tests
- [x] DB/migration smoke tests
- [x] Raster fixture tests
- [x] Vector fixture tests
- [x] QA/QC tests

## 14. Portfolio Release

- [x] Demo dataset voorbereiden
- [x] Demo workflow documenteren
- [ ] Screenshots toevoegen
- [ ] README portfolio sectie
- [ ] Full smoke test

# Repo preparation additions

- [x] Add Data Catalog.
- [x] Add Analysis Specifications.
- [x] Add QA/QC Specification.
- [x] Add Raster Operations Specification.
- [x] Add Vector Operations Specification.
- [x] Add Detection Pipeline Specification.
- [x] Add Segmentation Pipeline Specification.
- [x] Add Change Detection Specification.
- [x] Add UI Page Specifications.
- [x] Add Storage Architecture.
- [x] Add Demo Scenarios.
- [x] Add Development Rules.
- [x] Add Codex phase prompts.

# Recommended first Codex build sequence

- [ ] Phase 1: Backend foundation using `docs/CODEX_PHASE_1_PROMPT.md`.
- [ ] Phase 2: Dataset Manager using `docs/CODEX_PHASE_2_PROMPT.md`.
- [ ] Phase 3: Detection + QA/QC skeleton using `docs/CODEX_PHASE_3_PROMPT.md`.

## M2 Engineering Package

- [x] Add ADR decision records.
- [x] Add RFC placeholders for future modules.
- [x] Add API/database/event contracts.
- [x] Add model registry and class catalogs.
- [x] Add queue architecture.
- [x] Add acceptance matrix and test catalog.
- [x] Add Codex M2 build prompts.
- [ ] Start Codex Pass 01 backend foundation.

# M4 Autonomous Build Readiness

- [x] Add M4 autonomous build readiness document.
- [x] Add M4 sprint board.
- [x] Add module build contracts.
- [x] Add acceptance test catalog.
- [x] Add API example responses.
- [x] Add job lifecycle contract.
- [x] Add frontend state and route contracts.
- [x] Add backend service IO contracts.
- [x] Add model registry seed specification.
- [x] Add demo fixture manifest.
- [x] Add Codex autonomous runbook.
- [x] Add Codex pass prompts.
- [x] Add Geel demo fixtures.

# Next M5 Preparation

- [ ] Add concrete SQL migration snippets for every core table.
- [ ] Add OpenAPI YAML draft.
- [ ] Add frontend component prop contracts.
- [ ] Add backend unit-test skeleton files.
- [ ] Add frontend test skeleton files.
- [ ] Add live data connector research notes with verified endpoints.

# M5 Operational Readiness Checklist

- [x] CI/CD specification added.
- [x] Healthcheck contracts added.
- [x] Observability plan added.
- [x] Troubleshooting runbook added.
- [x] Rollback and recovery plan added.
- [x] Security checklist added.
- [x] Geospatial validation rules added.
- [x] Build governance added.
- [x] Codex pass documents added.
- [x] Smoke scripts added.
- [ ] M6: implement actual backend foundation.
- [ ] M6: implement database migrations.
- [ ] M6: implement frontend shell.

## M8 Codex Day-1 Readiness

- [x] Add Day 1 master prompt.
- [x] Add pass-by-pass Day 1 prompts.
- [x] Add autonomy boundaries.
- [x] Add failure recovery playbook.
- [x] Add quality gate matrix.
- [x] Add operator checklist.
- [x] Add smoke script scaffold.
- [ ] Let Codex execute Day 1 implementation passes.


# M10 Ultra Preparation

- [x] Add autonomous build charter.
- [x] Add Codex start-here guide.
- [x] Add M10 master autonomous prompt.
- [x] Add pass sequence.
- [x] Add geometry and CRS contracts.
- [x] Add error taxonomy.
- [x] Add feature flag strategy.
- [x] Add model adapter guide.
- [x] Add QA/QC matching algorithm.
- [x] Add frontend state machine.
- [x] Add implementation ticket index and tickets.
- [x] Add API example payloads.
- [x] Add final pre-Codex checklist.