geointel/docs/40-build-launch/SPRINT_1_SCOPE_FREEZE.md

SPRINT 1 SCOPE FREEZE

This document freezes the first implementation scope. Codex must not expand Sprint 1 beyond this boundary.

Sprint 1 goal

Build the GeoIntel foundation vertical slice: a locally runnable app that proves project, area, dataset, PostGIS and map foundations.

Must build

Backend foundation

• FastAPI app skeleton.
• Settings/config module.
• Structured logging baseline.
• Health/readiness endpoint.
• API response envelope.
• Error handling middleware or equivalent.
• CORS configuration for local frontend.

Database foundation

• PostgreSQL/PostGIS connection.
• Migration tooling.
• Core models/schemas for projects, areas and datasets.
• Geometry persistence.
• Minimal seed/fixture support.

Project and area workflow

• Create/list/read project.
• Create/list/read area.
• Store area geometry.
• Validate geometry.
• Return area metadata such as area size where practical.

Dataset workflow

• Register/upload GeoJSON dataset.
• Store original file or registered reference.
• Extract metadata:
  • dataset type;
  • feature count;
  • geometry type;
  • CRS if available;
  • bounds.
• Persist metadata.

Frontend foundation

• Vite/React/TypeScript app.
• Main shell/layout.
• MapLibre map.
• Project workspace page.
• Dataset manager page/panel.
• Minimal layer display using demo GeoJSON.
• API client.

Tooling

• Docker Compose for DB and services.
• README quickstart updated if implementation changes commands.
• make readiness remains green.
• Basic tests/smoke scripts.

Should build if Sprint 1 musts are complete

• Area import from fixture.
• GeoJSON export endpoint for area or dataset features.
• Minimal QA placeholder that validates reference vs prediction fixture schema, but does not run full QA engine yet.
• Frontend layer opacity toggle.

May build only if zero risk

• Demo fixture loader.
• Simple statistics card for feature count and area.
• Simple project status panel.

Must not build in Sprint 1

• YOLO live inference.
• SAM live segmentation.
• Sentinel/STAC integration.
• GRB live WFS client.
• DHMV integration.
• LiDAR LAS/LAZ processing.
• Training Studio.
• Model registry UI.
• AI Copilot.
• Advanced PDF reports.
• Multi-user authentication.
• Role-based permissions.
• Production Kubernetes/deployment stack.

Scope conflict rule

If a task seems useful but is not listed under Must, Should or May, Codex must not implement it in Sprint 1. Add it to backlog/open issues instead.