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
1.2 KiB
1.2 KiB
Skill: GeoAI Backend Build
Use this skill when implementing FastAPI routers, services, schemas, domain logic, adapters or background-job entry points.
Read first
docs/governance/GEOINTEL_CONSTITUTION.mddocs/governance/ARCHITECTURE_INVARIANTS.mddocs/SERVICE_ARCHITECTURE.mddocs/API_CONTRACTS.md- active pass prompt
Backend rules
- Keep routers thin.
- Put business logic in services.
- Put external integrations behind adapters.
- Use typed request/response schemas.
- Return stable error codes from the error catalog.
- Do not let AI/model code write directly to the database.
- Do not perform long processing synchronously when it belongs in jobs.
Expected package pattern
backend/app/
api/
core/
db/
models/
schemas/
services/
workers/
adapters/
Implementation checklist
- Add/extend schemas.
- Add/extend service.
- Add/extend router.
- Add validation.
- Add tests or smoke checks.
- Update docs/log/changelog when behavior changes.
Completion report fields
- Endpoints added/changed.
- Services added/changed.
- Validation rules added.
- Tests run.
- Contract deviations, if any.