Expand description
§spacedb-console — the operator’s read-model
The substance of an operations console is not pixels — it is the logic that
turns raw fleet / access / audit / settlement Observations into the four
boards a SpaceDB business is run from:
- Fleet Health (
FleetHealth) — durability + availability: under-replicated, at-risk and lost shards, quorum loss, lag; one Green/Amber/Red rollup. - Access & Audit (
AccessOverview) — human vs AI-agent capabilities, expirations, revocations, per-agent activity, denials. - Economics (
Economics) — revenue, spend per customer, per-rail split, agent budget burn-down, unsettled claims. - Alerts (
Alert) — the page-me surface, severity-sorted.
Dashboard::assemble computes all four from one snapshot; Dashboard::render_text
prints them. A Dioxus/WASM shell binds the same fields to a UI:
ⓘ
// in the Dioxus shell (compiles to wasm32, not part of the tested core):
let dash = Dashboard::assemble(&observations, &Config::at(now));
rsx! {
HealthBadge { status: dash.health.status }
for alert in dash.alerts { AlertRow { alert } }
EconomicsPanel { economics: dash.economics }
}Open-core (MIT). Fed by observation DTOs, so it stays decoupled and testable.
Structs§
- Access
Overview - The security board.
- Agent
Activity - One agent’s recent footprint in the audit log.
- Agent
Budget Obs - An agent’s remaining spend against its granted budget.
- Alert
- Alert
Thresholds - Thresholds for what counts as alert-worthy.
- Audit
Obs - An audit-log entry — who did what, and whether it was allowed.
- Budget
Status - One agent’s budget burn-down.
- Capability
Obs - An issued capability (human or AI agent).
- Config
- Operator-tunable thresholds for the whole dashboard.
- Dashboard
- The four boards.
- Economics
- The business board.
- Fleet
Health - The durability + availability picture for the whole fleet.
- HomeObs
- A home computer in the fleet.
- LagObs
- A collection’s convergence lag on some replica.
- Observations
- One snapshot of everything the console observes.
- Rail
Breakdown - Revenue split across the three rails.
- Settled
Obs - A settled usage receipt — revenue credited to a hosting home for a customer.
- Shard
Obs - A stored shard and its replication standing.
- Strong
Obs - A strong-tier collection’s quorum standing.
Enums§
- Alert
Kind - Health
Status - The single-glance rollup.
- Resource
- The class of a resource — the settlement bucket.
- Severity
- Sort order is the variant order:
Critical<Warning<Info, so sorting ascending puts the worst first.
Functions§
- assess_
fleet - Assess fleet health from observations. A collection is “stale” if its lag
exceeds
lag_ops_warn. - derive_
alerts - Derive the full alert list, sorted worst-first.
- rollup_
access - Roll up active capabilities and audit activity. A capability counts as
“expiring soon” if it expires within
expiry_windowofnow. - rollup_
economics - Roll up settled receipts and agent budgets.
budget_low_pctis the remaining-percentage threshold below which an agent is flagged low.