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
@@ -346,7 +346,8 @@ Work tracking stays in [Redmine](https://projects.knownelement.com).
 ## Repository Layout

 ```
-dcinfra/            Data-center infra: PDU (powerman), serial console (console), UPS (ups)
+dcinfra/            Data-center infra: PDU (powerman), serial console (console), UPS (ups), sensors (temper)
+HomeAssistant/      OAM: pfv-bms ops pointer + needfromcharles asks (live config SoR = KNEL/pfv-bms repo)
 netinfra/           DNS/NTP/DHCP setup + audit; DNS cluster replication (dns-cluster-setup);
                    switch captures (switches); DHCP config (dhcp)
 k8s/                k3s cluster setup scripts (HA control plane over Tailscale) + docs/
@@ -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.
@@ -0,0 +1,44 @@
+
+> Working ask-file; knowledge docs live on Discourse: https://community.turnsys.com/c/vp-techops (audit log: https://community.turnsys.com/t/298)
+
+# needfromcharles.md — open asks from the agent (2026-09-01 night session)
+
+Answer inline below each item; the agent checks this file before asking again.
+
+## 1. Minisplit (Midea/Carrier) — blocks #614
+Your login `charles@turnsys.com` was rejected by all three Midea cloud
+backends (SmartHome / Midea Air / NetHome Plus). Likely a Carrier-specific
+backend or a different account.
+- [ ] Exact app name on your phone that controls the minisplit:
+- [ ] Account email that app uses (if different):
+- [ ] (If MSmartHome-family) password for that account:
+
+## 2. Govee — blocks #620 device data
+Cloud API sees zero devices (suspect BLE-only sensors).
+- [ ] Model numbers of your Govee temp sensors / lights:
+- [ ] Govee app account email + password (thermometer readings require it):
+
+## 3. HomeKit codes — blocks #619 (ecobee + front-door lock)
+- [ ] ecobee HomeKit setup code (8-digit, on paperwork/box if not the unit):
+- [ ] Front-door lock brand/model:
+- [ ] Lock HomeKit code (if visible in its vendor app settings):
+
+## 4. Emporia Vue 3 — blocks circuit-level power + BTU loop (#623/#614)
+- [ ] Ordered? ETA:
+
+## 5. Decisions (yes/no)
+- [ ] UniFi mDNS/multicast setting change may briefly re-provision APs
+      (short WiFi blip) — OK to apply tonight?
+- [ ] Re-enable HA core watchdog (was disabled to break the boot loop;
+      box has been stable since)?
+- [ ] Uninstall the crash-looping community SSH add-on (a0d7b954_ssh)?
+      (core_ssh on 22222 is the keeper)
+- [ ] k8s rebuild tonight or next session?
+
+## 6. Friday onsite (#629 — unchanged)
+Dongle manual/app check · minisplit nameplate photo · ecobee + lock codes
+(if not provided above) · Tripp Lite USB reseat (#372) · Emporia CT install.
+
+## 7. Small hygiene
+- [ ] Re-enroll Pi-hole TOTP in your authenticator (secret in
+      `~/.creds/pihole.env`) — password already rotated.