geointel/docs/17-max-prep/M9_PASS_SCORECARDS.md

M9 Build Pass Scorecards

Use these scorecards after every Codex pass. A pass is not considered complete until its scorecard is mostly green.

Pass 0 — Audit

• Repository tree inspected.
• Existing docs summarized.
• Missing implementation listed.
• Build blockers listed.
• Next pass selected.
• No feature code added.

Pass 1 — Backend Foundation

• FastAPI app starts.
• Health endpoint exists.
• Settings load from environment.
• CORS configured for local frontend.
• API envelope helper exists.
• Error handler exists.
• Backend tests run.

Pass 2 — Database Foundation

• SQLAlchemy or approved ORM configured.
• Alembic migrations initialized.
• PostGIS extension migration exists.
• Project model exists.
• Area model exists with geometry.
• Dataset model exists.
• Local database connection documented.

Pass 3 — Project/Area APIs

• Create/list/read project.
• Create/list/read area.
• GeoJSON polygon validation.
• Area size calculation.
• Envelope responses.
• Error responses for invalid geometry.
• Tests for happy and failure paths.

Pass 4 — Dataset Manager Skeleton

• Dataset upload endpoint.
• File stored under documented storage root.
• Metadata extraction placeholder with real file inspection when possible.
• Dataset list/read APIs.
• Status lifecycle present.
• Tests with fixtures.

Pass 5 — Frontend Foundation

• React app starts.
• Route shell exists.
• API client uses envelope.
• Error/loading/empty states exist.
• Project list page exists.
• Workspace shell exists.

Pass 6 — Map Workbench Shell

• MapLibre or approved map abstraction installed.
• Area polygon can be displayed.
• Demo GeoJSON can be loaded.
• Layer panel shell exists.
• No hardcoded fake analysis results.

Pass 7 — Raster/Vector Core Skeleton

• Raster metadata endpoint skeleton.
• Vector metadata endpoint skeleton.
• CRS field exposed.
• Bounds field exposed.
• UI metadata panels exist.

Pass 8 — QA/QC Skeleton

• QA service interface exists.
• IoU function unit-tested with fixtures.
• Precision/recall formulas implemented.
• QA endpoint accepts reference and predicted layer IDs or fixture IDs.
• QA result card exists.

Pass 9 — Stabilization

• All smoke commands documented.
• Changelog updated.
• Known limitations updated.
• Next advanced module recommendation written.