Kiosk Redesign, Calendar Reset Schedules, Dashboards and Room Editor

Date: 2026-09-24 Project: family-hub Status: blocked Tags: kiosk, apscheduler, reset-schedules, dashboards, rooms, migrations, pets, auth

Context

Recorded retrospectively: this work was done in an August 2026 session (exact date not recorded). After a house move, chore resets stopped firing and weekly chores reset at unpredictable times. That session fixed scheduling and added four features in the local codebase (D:\Hosted\familyhub\). None of it has been pushed to this repo yet, and none of the four migrations have been run — status is blocked on applying them.

Key Decisions

Wire APScheduler into FastAPI's lifespan explicitly — it does not start on its own; this was why resets never fired.
No destructive reset-on-startup — wiping completions at startup combined with --reload caused data loss.
Calendar-anchored reset types (weekly, fortnightly, monthly) with a day/time picker replace misused midnight and drifting cooldown types; cooldown anchors to completion time and drifts.
Kiosk: chore-first flow — room grid → chores in room → "who did this?" modal. Completed chores stay visible, greyed, with attribution.
Custom kiosk dashboards — each wall tablet shows a chosen subset of rooms, with per-dashboard sleep/dim schedule and tap-to-wake.
Room/category editor — rename (cascades to chores and dashboards), emoji icons, reorder, merge, delete-with-reassign, create.
Pet care split — pet chores move into per-pet categories; shared water-bowl chore handled by a configurable split / assign / keep mode.
Kiosk auth — the axios 401 interceptor must exempt public kiosk pages; token lifetime 24h so tablets don't log out mid-use.

Technical Details

Live DB: backend\data\family_hub.db (not backend\family_hub.db). Migrations resolve it with Path(__file__).parent / "data" / "family_hub.db".
Migration order (must be run in sequence): reset schedules → dashboards → pet care split → rooms.
Backend started via start.bat, venv at backend\venv; icons in frontend\public\icons\.
Household members and pets are configured in the app — names <redacted>.

Code Changes

(local only, unpushed) Scheduler lifespan wiring; new reset types + picker UI; kiosk room→chore→who flow; dashboards model/UI with sleep schedule; room editor; four migration scripts.

Open Questions / Next Steps

Back up backend\data\family_hub.db, run the four migrations in order, validate, then commit and push the local changes.
Resolve the outstanding README merge conflict in this repo.
Confirm which Gitea repo is canonical — family-hub (this one) or the private familyhub — and archive the other.
Future: Google Calendar integration (high priority), Mealie menu planning/shopping lists, Home Assistant push notifications, unified dashboard.

Artifacts

None pushed yet — last pushed commit is Phase 3.1 (11abfac).

3.0 KiB Raw Permalink Blame History