districtr/districtr-v2

backend-endpoints

Adding or changing a backend route or endpoint, a SQLModel data model, a request dependency, or a database query in backend/app.

deploy-authority

Editing infrastructure code, deploy workflows, or anything that could apply changes to live AWS infrastructure — Pulumi, GitHub Actions deploy/preview workflows, deploy roles.

map-edit-sync

Changing how map edits are saved, loaded, or synced — local IndexedDB persistence, server sync of assignments and document metadata, optimistic concurrency, and sync-conflict resolution.

map-rendering

Changing what the interactive map shows or how painting, shattering, or map interaction behaves — MapLibre rendering, feature-state, Zustand map stores, undo/redo, and the geometry/parquet Web Workers.

performance-memory

Investigating a slow endpoint or high memory, or making a change that could affect backend memory usage, request latency, or where a heavy computation runs (database, server process, or browser worker).

run-api-contract-audit

Runs a static, name-matching heuristic diff between backend Pydantic/SQLModel response fields and the frontend's hand-written API TypeScript interfaces, to surface likely drift after either side changes. Use after editing a FastAPI endpoint's response model,…

run-dependency-audit

Surveys outdated and vulnerable dependencies across the frontend (Bun) and backend (pip/uv) toolchains and triages findings by severity and exposure. Use when a dependency manifest or lockfile changes, or when asked to check for outdated packages, security…

run-map-onboarding

Walks through onboarding a new geographic layer (a state's blocks/VTDs, a new district plan's base geography, or a COI-module geography) into a usable Districtr map module — from raw GeoPackage through GerryDB import, tileset and graph generation, map-record…

run-migration

Authors and validates an Alembic migration for this repo's SQLModel schema — generating it from model changes, reviewing the autogenerated script for dangerous operations, and running the upgrade/downgrade/upgrade validation loop. Use whenever a SQLModel…

run-quality-gate

How to verify changes in this repo — which of the quality gates (pre-commit lint, frontend type-check and build, backend pytest) a situation actually calls for, and the commands to run them. Use when about to push a branch, hand off or merge work, open a PR,…