Files
geointel/docs/18-ultra-prep/FRONTEND_STATE_MACHINE.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

609 B

Frontend State Machine

Every async module must model these states explicitly:

  • idle
  • loading
  • empty
  • ready
  • error
  • unavailable
  • disabled

Dataset Card

  • idle: not selected
  • loading: metadata extraction running
  • empty: no datasets uploaded
  • ready: dataset metadata available
  • error: upload/extraction failed
  • unavailable: operation unsupported for this dataset type
  • disabled: feature flag off

Analysis Run

  • queued
  • running
  • succeeded
  • failed
  • cancelled

UI Rule

Never leave users with a blank panel. Every panel must explain what is happening or what to do next.