geointel/docs/CODEX_PHASE_1_PROMPT.md

Codex Phase 1 Prompt — Backend Foundation

You are working in the GeoIntel Kempen repository.

Read these files first:

1. docs/PRODUCT_BLUEPRINT.md
2. docs/DEVELOPMENT_RULES.md
3. docs/DATABASE_SCHEMA.md
4. docs/API_SPECIFICATION.md
5. docs/STORAGE_ARCHITECTURE.md
6. docs/IMPLEMENTATION_BACKLOG.md

Mission

Build the backend foundation for GeoIntel Kempen without implementing fake features.

Required output

• FastAPI backend skeleton.
• Config/settings module.
• Database connection to PostgreSQL/PostGIS.
• Initial models for projects, areas, datasets, layers, analysis runs, metrics, exports and jobs.
• Alembic migrations if applicable.
• Health endpoint.
• Basic project/area/dataset CRUD endpoints where safe.
• File storage service skeleton with real path handling.
• Tests for config, health and core models where feasible.

Non-negotiable rules

• Do not fake GIS processing.
• Do not create endpoints that pretend analysis was completed.
• Every geometry field must be designed for PostGIS.
• Every dataset must support metadata.
• Keep code modular.
• Update TODO/backlog after changes.

Delivery format

At the end, report:

• Files changed.
• What works.
• How to run.
• Tests run.
• Remaining tasks.