From 3b24d98b1800d332a367521fc5f807a8ec79b95e Mon Sep 17 00:00:00 2001 From: claude-code Date: Sun, 19 Apr 2026 12:29:12 -0600 Subject: [PATCH] docs: refresh wiki for /healthz, JSON logs, deploy-prep status --- Home.md | 23 ++++++++++++++++++++--- 1 file changed, 20 insertions(+), 3 deletions(-) diff --git a/Home.md b/Home.md index e7e2ab1..2953625 100644 --- a/Home.md +++ b/Home.md @@ -13,7 +13,7 @@ real spending on the applied side. * [DevelopmentGuide](DevelopmentGuide) — prerequisites, setup, run, test, project layout, conventions, throwaway-DB pattern * [Operations](Operations) — backup script, restore, DB safety rule, - alembic hook + alembic hook, /healthz endpoint, structured JSON logs * [Roadmap](Roadmap) — shipped features and what's deferred ## At a glance @@ -28,6 +28,10 @@ real spending on the applied side. its backing ledger of transactions (postings) and add more. Applied is always `sum(postings.amount)`, never typed directly. Rows carry deviation tags when edited or added post-snapshot. +* `/healthz` — unauthenticated health probe. Returns 200 `{"status":"ok"}` + when the DB is reachable, 503 `{"status":"error","detail":}` + otherwise. Targets the Docker `HEALTHCHECK` and the platform's + container-down alert. * **Zero Amount header** on both pages. Green when every dollar is assigned, amber when unassigned income remains, red when over-budget. The logo anchors the left of the hero; Applied / Planned flank the big @@ -72,8 +76,21 @@ Shipped: initial scaffold, monthly snapshot with deviation tags, database backup script with alembic auto-hook, zero-amount header, section groups with collapsible headers, sinking funds section, per-entry notes, month lifecycle with the balance gate, UI redesign in Barlow Condensed + logo, -backing transaction ledger with `applied` derived from postings. See the -[Roadmap](Roadmap) for what is next. +backing transaction ledger with `applied` derived from postings, +budget-side inline edit of entry name and amount, `/healthz` endpoint, +structured JSON logs on stdout with five seed application events for +Loki. See the [Roadmap](Roadmap) for what is next. + +## Deploy + +Production is home-ctr-onyx (homelab). The deploy contract with the +homelab platform is documented on the platform wiki as +[PlatformContractQuartermaster](https://forgejo.labbity.unbiasedgeek.com/homelab/homelab-IaC/wiki/PlatformContractQuartermaster). +Platform-side provisioning (DNS for `quartermaster.unbiasedgeek.com`, +Traefik basic-auth + rate-limit middlewares, `/mnt/quartermaster/` bind +mount with nightly restic) is complete. Container side (Dockerfile, +`compose.yml`, Forgejo Actions workflow) is tracked under open issues +and will land in a follow-up session. ## Code