Edit Checklist (Build + QA)

Use this checklist for every code or workflow change.

1) Scope + Contracts

• [ ] Confirm affected APIs in contracts/openapi/*.yaml.
• [ ] Confirm DB change needs migration (db/migrations/versions/*).
• [ ] Confirm UI control IDs match JS bindings in apps/client-web/index.html and apps/client-web/app.js.

2) Implementation

• [ ] Keep changes modular (API, worker, UI, docs separated by file).
• [ ] Preserve tenant isolation and role boundaries.
• [ ] For CRS/ECEF changes, include deterministic validation output.
• [ ] For source ingestion, preserve provider URL + hash metadata when available.

3) Required Validation

• [ ] python3 scripts/ci/validate_contracts.py
• [ ] python3 scripts/ci/validate_migrations.py
• [ ] python3 scripts/ci/validate_docs.py
• [ ] python3 -m pytest -q
• [ ] node --check apps/client-web/app.js

4) Manual UI Verification

• [ ] Upload/listing works in **Uploads** panel.
• [ ] Finder/tree browsing works in **Bucket + Jobs** panel.
• [ ] Audited Sources and Direct Download URL work in **Open Data Scraper**.
• [ ] ECEF Consistency Audit and JSON export work in **Metadata + 3D**.
• [ ] Run Audit Validation and report downloads work in **Well Data Processing Visibility**.

5) Docs Update Rule

• [ ] Update docs/CHANGELOG.md.
• [ ] Update docs/OPERATIONS_AND_OUTPUT_GUIDE.md.
• [ ] Update docs/URL_INVENTORY.md for new/changed endpoints.
• [ ] Update docs/INDEX.md if new manuals were added.