Document the manual, admin-set application timezone (task e9aa78f3) #286

Merged
approver_agent merged 2 commits from task/document-manual-timezone_e9aa78f3-d762-48ef-ae52-a8db73791b4b into dev 2026-09-30 11:13:25 -04:00
Member

Documentation-only task for the Manual application timezone control feature. Updates docs/ARCHITECTURE.md and timezone docstrings/comments to state that the application timezone is set manually by an admin from the admin app, that the stored value is the single source of local-time truth for the whole application (panel snapshot overdue/today, both panel cards, completion timestamps, the missed-sweep scheduler, admin reads), that empty means the API host local zone, and that an admin save re-plans the sweep scheduler. No behavioural code; no schema change.

Documentation-only task for the Manual application timezone control feature. Updates docs/ARCHITECTURE.md and timezone docstrings/comments to state that the application timezone is set manually by an admin from the admin app, that the stored value is the single source of local-time truth for the whole application (panel snapshot overdue/today, both panel cards, completion timestamps, the missed-sweep scheduler, admin reads), that empty means the API host local zone, and that an admin save re-plans the sweep scheduler. No behavioural code; no schema change.
dev_agent added 1 commit 2026-09-30 10:41:21 -04:00
Add an "Application timezone" section to docs/ARCHITECTURE.md: the
timezone is set only by an admin from the admin app (GET/PATCH
/api/v1/admin/settings), is the single source of local time for the
panel, completions, the missed-sweep scheduler and the admin app, means
the API host's local zone while empty (published as the effective zone),
and an admin save of timezone or day_rollover_time re-plans the sweep.

Correct docstrings and comments that still described the local date as
Home Assistant's ("HA-local", read from hass.config.time_zone by the
integration) or the stored zone as reported from Home Assistant.
Comment and docstring changes only; no behaviour change.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
overseer added 1 commit 2026-09-30 10:54:29 -04:00
The CONF_TIMEZONE comment claimed the integration always uses Home
Assistant's time_zone and ignores the field; it actually relays the
API's effective application timezone. Also reword two materialize.py
docstrings that described the household date as HA-derived.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
review_agent left a comment
Member

Independent Codex gpt-5.6-terra review completed for this exact commit.

Independent Codex gpt-5.6-terra review completed for this exact commit.
approver_agent merged commit 52895199be into dev 2026-09-30 11:13:25 -04:00
Sign in to join this conversation.
No Reviewers
No labels
3 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Maniacs_Mansion/NestQuest#286