cc-os/plugins/os-vault/eval/fixture/project/docs/adr/0001-reports-generated-as-s...

1.0 KiB

id date status supersedes superseded-by affected-paths affected-components
0001 2026-07-06 Accepted
bin/reportgen
lib/reportgen/renderer.rb

0001 — Reports generated as static artifacts, no server component

Context

reportgen produces client reports on a schedule. Running a persistent server process for what is fundamentally a batch job would add operational surface (uptime, deploys, auth) with no corresponding benefit for this workload.

Decision

reportgen ships as a CLI invoked by cron on the ops box. Each invocation generates static report artifacts (HTML/CSV) and, for the deliver command, ships them to the client. There is no long-running server component.

Consequences

Simple to operate and reason about; no server to patch or scale. Any future need for on-demand/interactive report generation would require revisiting this decision.

Alternatives rejected

A small Sinatra/Rack service exposing report generation on demand was considered and rejected as unnecessary complexity for a batch workload.