DEV Hermes Workspace
76 pages 76 clean 0 need attention
Page navigation 76

Project

Domains

Folders · apps/

Folders · docs/

Folders · knowledge/

Folders · ops/

Folders · packages/

Folders · scripts/

Folders · tests/

Folders · pods/

Folders · tools/

Shared

Metadata clean
Route
/knowledge/portal/domains/dashboard-runtime
Source
knowledge/portal/domains/dashboard-runtime.md
Covered files
11
Last generated
2026-04-13T15:08:52.578776+00:00

Dashboard Runtime Domain

State: deterministic sync completed

Dashboard Runtime Domain

This page is deterministic and regenerated from code headers.

Generated coverage map

  • apps/portal/app.py
  • apps/portal/dashboard/log_retention.py
  • apps/portal/dashboard/sampler.py
  • apps/portal/requirements.txt
  • apps/portal/templates/dashboard/dashboard.html
  • apps/portal/templates/dashboard/placeholder.html
  • apps/portal/templates/dashboard/token_statistics.html
  • apps/portal/templates/dashboard/usage_cost_performance.html
  • apps/portal/tests/test_log_retention.py
  • apps/portal/tests/test_telemetry_api.py
  • apps/portal/wsgi.py

Generated file map

app.py

  • Path: apps/portal/app.py
  • What: Flask entrypoint for Portal v2 pages and APIs.
  • Does: Serves dashboard/knowledge/scrumai/tzenboard routes, exposes JSON endpoints used by UI surfaces, and binds runtime helpers (sampler/wiki/tzenboard).
  • Why: Keeps web delivery, route contracts, and UI integration in one operator-owned service boundary so agents can reason about behavior without scanning every template first.

log_retention.py

  • Path: apps/portal/dashboard/log_retention.py
  • What: Structured log retention and recycling policy for Portal runtime logs.
  • Does: Applies age-based movement from active logs to recycle bins per severity tier and purges recycle data after retention cutoff.
  • Why: Enforces predictable disk hygiene and recoverability while matching project WoW retention rules (INFO/WARN/CRITICAL windows plus recycle cleanup).

sampler.py

  • Path: apps/portal/dashboard/sampler.py
  • What: Runtime metrics sampler and summary builder for Portal dashboard APIs.
  • Does: Collects host/service health snapshots, stores time-series in SQLite, and assembles the dashboard payload consumed by live UI cards and charts.
  • Why: Centralizes operational telemetry so the dashboard can stay fast, deterministic, and auditable across degraded and normal runtime states.

requirements.txt

  • Path: apps/portal/requirements.txt
  • What: Source artifact for requirements in apps/portal/requirements.txt.
  • Does: Contributes implementation or support behavior for this runtime surface.
  • Why: Maintains explicit ownership boundaries for faster agent orientation.

dashboard.html

  • Path: apps/portal/templates/dashboard/dashboard.html
  • What: Template for dashboard UI surface in apps/portal/templates.
  • Does: Defines rendered structure, states, and UI hooks consumed by Portal routes.
  • Why: Keeps operator-facing behavior predictable and discoverable without digging into route code.

placeholder.html

  • Path: apps/portal/templates/dashboard/placeholder.html
  • What: Template for placeholder UI surface in apps/portal/templates.
  • Does: Defines rendered structure, states, and UI hooks consumed by Portal routes.
  • Why: Keeps operator-facing behavior predictable and discoverable without digging into route code.

token_statistics.html

  • Path: apps/portal/templates/dashboard/token_statistics.html
  • What: Template for token statistics UI surface in apps/portal/templates.
  • Does: Defines rendered structure, states, and UI hooks consumed by Portal routes.
  • Why: Keeps operator-facing behavior predictable and discoverable without digging into route code.

usage_cost_performance.html

  • Path: apps/portal/templates/dashboard/usage_cost_performance.html
  • What: Template for usage cost performance UI surface in apps/portal/templates.
  • Does: Defines rendered structure, states, and UI hooks consumed by Portal routes.
  • Why: Keeps operator-facing behavior predictable and discoverable without digging into route code.

test_log_retention.py

  • Path: apps/portal/tests/test_log_retention.py
  • What: Test log retention module for apps/portal/tests.
  • Does: Implements TestLogRetention used by this runtime surface.
  • Why: Keeps behavior boundaries explicit so wiki maps stay useful without reading full files.

test_telemetry_api.py

  • Path: apps/portal/tests/test_telemetry_api.py
  • What: Tests for lane telemetry APIs.
  • Does: Validates shape, empty fallback behavior, and deterministic non-empty aggregation.
  • Why: Locks TASK-132/TASK-133 initial telemetry contract.

wsgi.py

  • Path: apps/portal/wsgi.py
  • What: Wsgi module for apps/portal/wsgi.py.
  • Does: Implements module routines used by this runtime surface.
  • Why: Keeps behavior boundaries explicit so wiki maps stay useful without reading full files.
  • (no explicit Tests headers found)