release: include Feature 17 (API deployment) in the 0.7.0 notes

This commit is contained in:
2026-09-24 10:02:16 -04:00
parent 03ee131c6e
commit 7887d16f11
+32 -16
View File
@@ -4,9 +4,21 @@
### Scope ### Scope
Seventh release of NestQuest, promoting the admin surface from `dev` onto Seventh release of NestQuest, promoting the re-imagined architecture's admin
0.6.0: the standalone admin PWA and the admin-plane API work it depends on. surface from `dev` onto 0.6.0: the API deployment and identity layer, the
admin-plane API work, and the standalone admin PWA that uses them.
- **Feature 17 — API Deployment and Identity:** the NestQuest API is packaged as
a container (`Dockerfile`, `deploy/compose.yaml`, pinned base image and exact
dependencies) and deployed behind a TLS reverse proxy (the shared Traefik, ACME
via the Cloudflare DNS-01 challenge); the Authentik application, OIDC provider
and `nestquest-admins` group are wired and the API validates the provider's
issuer/audience/JWKS (RS256); the panel plane is restricted to the Home
Assistant box while the admin plane is internet-facing behind Authentik;
continuous backup runs as a contained Litestream sidecar over SFTP to a NAS and
a restore is proven; a deployment runbook (`deploy/RUNBOOK.md`) and the
host-firewall unit (`deploy/systemd/nestquest-api-firewall.service`) ship.
(PRs #183, #214, #215, #216, #218.)
- **Feature 19 — Admin PWA:** the parent-facing admin surface is now a - **Feature 19 — Admin PWA:** the parent-facing admin surface is now a
standalone mobile-first React progressive web app (`admin/`), implementing standalone mobile-first React progressive web app (`admin/`), implementing
`design/ADMIN-SPEC.md`: Authentik OIDC authorization-code + PKCE login with `design/ADMIN-SPEC.md`: Authentik OIDC authorization-code + PKCE login with
@@ -44,12 +56,14 @@ Seventh release of NestQuest, promoting the admin surface from `dev` onto
- Minimum Home Assistant version: **2024.6.0**. - Minimum Home Assistant version: **2024.6.0**.
- A running NestQuest API service, reachable at the base URL and panel service - A running NestQuest API service, reachable at the base URL and panel service
token configured in the integration options. The API service source ships in token configured in the integration options. The deployable ships in this
`api/`; there is still **no container image, compose file or deployment release: `Dockerfile`, `deploy/compose.yaml` (API + a contained Litestream
runbook in this release** because Feature 17 is not part of it. backup sidecar), `api/requirements.txt`, the host-firewall unit and
- The admin PWA is built to run at `https://nestquest.cubecraftlabs.com` `deploy/RUNBOOK.md`. Deploying it needs a host, the DNS/TLS path and the
behind Authentik; hosting it is part of the Feature 17 deployment, which is Authentik/Synology services described in the runbook.
**not** in this release. - The admin PWA is built to run at `https://nestquest.cubecraftlabs.com` behind
Authentik. Serving the built `admin/` static bundle at that hostname is part of
the deployment described in the runbook.
### Breaking changes ### Breaking changes
@@ -65,14 +79,16 @@ Seventh release of NestQuest, promoting the admin surface from `dev` onto
### Known Limitations ### Known Limitations
- **Feature 17 (API deployment and identity) is not in this release.** There - **The API and its identity/backup layer are deployed by the owner's
is no API box, TLS reverse proxy, Authentik application/provider/ infrastructure, not by this release alone.** The deployment artifacts and
`nestquest-admins` group, proven network separation, or backup/restore. The runbook ship here, but a running service still requires the host, the shared
integration and the admin PWA therefore cannot run end-to-end yet; Feature reverse proxy, the Authentik application/provider/`nestquest-admins` group, the
19's end-to-end Authentik/HTTPS acceptance remains **unverified** until backup target and the panel/admin network separation to be in place as the
Feature 17 is deployed. runbook describes.
- **The admin PWA is not hosted.** `admin/` builds and is unit/integration - **Serving the admin PWA is still outstanding.** `admin/` builds and is
tested, but there is no deployment for it (it depends on Feature 17). unit/integration tested and the API it talks to is live, but the built static
bundle must still be hosted at `https://nestquest.cubecraftlabs.com` behind
Authentik; until then the PWA is not reachable end-to-end.
- **Feature 12's TouchHub/DAKOS runbook task remains physically unverified** - **Feature 12's TouchHub/DAKOS runbook task remains physically unverified**
(needs the wall panel). (needs the wall panel).
- Moving the household database from Home Assistant to the API box is a manual - Moving the household database from Home Assistant to the API box is a manual