chart/bible-local/architecture/system-overview.md

System Overview

Product

Reanimator Chart is a small Go web viewer for Reanimator hardware JSON snapshots.

It is designed to be embedded as a module in other Go applications that already collect audit data and emit Reanimator-compatible JSON.

Active Scope

• Render one Reanimator JSON snapshot as HTML
• Read-only presentation of top-level metadata and hardware sections
• Tabular rendering for arrays such as cpus, memory, storage, pcie_devices, power_supplies, and sensor subsections
• Status color coding for fast scanning
• Lightweight section navigation
• Standalone HTML rendering or embeddable HTTP handler

Explicitly Out Of Scope

• Parsing vendor logs or archives
• Collecting hardware data
• Converting non-Reanimator formats
• Editing or mutating snapshot data
• Derived health analytics not present in the input JSON
• Timeline/history reconstruction
• Database storage
• Background jobs, upload pipelines, or batch processing UI

Product Rules

• The viewer must display the input snapshot as-is.
• The viewer may format values for presentation, but may not invent new data.
• Unknown fields must still be visible in the UI.
• Known sections may have a preferred visual order, but payload content remains authoritative.

Tech Direction

• Go HTTP server / embeddable handler
• Server-rendered HTML
• Minimal client-side JavaScript only for presentation helpers such as expand/collapse and sticky section navigation
• No SPA framework unless a concrete need appears later

Local Run

Expected future command:

• go run ./cmd/reanimator-chart