chore: HomeAssistant ops dir (config-repo pointer, needfromcharles asks); tidy test junk [#344]

2026-09-01 17:35:13 -05:00
parent adfdcafeab
commit 3b1bf0adcb
6 changed files with 81 additions and 1 deletions
@@ -0,0 +1,35 @@
+# HomeAssistant/ — pfv-bms operational notes
+
+**Config source of truth: [KNEL/pfv-bms](https://git.knownelement.com/KNEL/pfv-bms)**
+(private). Everything live (YAML, dashboards, packages) is deployed by
+pushing that repo — the `core_git_pull` add-on on pfv-bms polls every 300s,
+pulls, and auto-restarts Home Assistant on config changes.
+
+## Where things live
+
+| Thing | Location |
+|---|---|
+| HA configuration (live) | KNEL/pfv-bms repo → /config on pfv-bms (VM 100, pfv-tsys1, 4 vCPU / 6GB) |
+| Deploy pipeline | core_git_pull add-on (deploy key `~/.creds/pfv-bms-gitpull`, read-only) |
+| Host shell access | `VM_IP=pfv-bms-lan.knel.net VM_USER=root VM_PORT=22222 bash tests/remote.sh vm '...'` |
+| HA REST API | `~/.creds/homeassistant.env` (token) |
+| Global/Cloudron instance | https://building-management.knownelement.com (`~/.creds/cloudron-ha.env`) |
+| Samba (interactive edits) | add-on; creds `~/.creds/pfv-bms-samba.env` |
+| Custom components | on-box only, gitignored (HACS 2.0.5, Govee lasswellt v2026.8.7) |
+| Reference packs (this dir) | `packs/` — see statuses below |
+
+## packs/ status
+
+| File | Status |
+|---|---|
+| automations-ups-alerts.yaml | SUPERSEDED — live copy in KNEL/pfv-bms (retargeted to companion app) |
+| sensors-snmp-plant.yaml | DEAD — legacy snmp sensor platform creates nothing in HA 2026.8; migration tracked in #618 |
+| energy-plant-kwh.yaml | PENDING — Riemann-sum helper reference for the energy dashboard (#439) |
+
+## Related tickets
+
+#344 (umbrella) · #439 (UPS/alerts) · #614 (minisplit/BTU) · #618-#628 (roadmap) · #629 (Friday onsite)
+
+Knowledge docs live on
+[Discourse VP TechOps](https://community.turnsys.com/c/vp-techops) — this
+file is the repo-side operational pointer.