Files
geointel/docs/SEED_DATA_PLAN.md
Jens faeb58ef6d
GeoIntel release gates / Compile, test, contracts and builds (push) Successful in 1m49s
GeoIntel release gates / Python and npm vulnerability policy (push) Successful in 21s
GeoIntel release gates / Production AI image, SBOM and container scan (push) Successful in 5m39s
GeoIntel release gates / Deploy exact gated revision to Unraid (push) Failing after 58m43s
Initial public release
2026-08-31 21:56:53 +02:00

1.2 KiB

Seed Data Plan

Seed data exists only to make the local developer experience and Codex implementation deterministic.

Seed data rules

  • Seed data must be clearly labeled as demo or fixture data.
  • Seed data must never be presented as real GRB, OSM or official source data unless it actually comes from that source.
  • Fixture geometries should be small and simple.
  • Fixtures should support automated tests.

Required seed entities

Project

{
  "name": "Demo — Geel Building QA",
  "description": "Fixture project for building detection and QA/QC workflow."
}

Area

A small polygon near the Kempen demo viewport.

Reference buildings

Use fixtures/geojson/reference_buildings_fixture.geojson.

Predicted buildings

Use fixtures/geojson/predicted_buildings_fixture.geojson.

Required seed command

Codex should add a command similar to:

python -m app.scripts.seed_demo

or a Make target:

make seed-demo

Seed acceptance

After running seed:

  • one project exists
  • one area exists
  • reference building dataset exists
  • predicted building dataset or analysis output exists
  • QA/QC can run against the two fixture layers