# 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.