From 0c7dd2e352571293b1b7a6c9aad8afbe5166fee5 Mon Sep 17 00:00:00 2001 From: jessikitty Date: Thu, 24 Sep 2026 01:32:57 +1000 Subject: [PATCH] docs: add .claude-context project overview --- .claude-context/00-overview.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 .claude-context/00-overview.md diff --git a/.claude-context/00-overview.md b/.claude-context/00-overview.md new file mode 100644 index 0000000..7b8bd19 --- /dev/null +++ b/.claude-context/00-overview.md @@ -0,0 +1,27 @@ +# FamilyHub + +Self-hosted household management app: chores, points and leaderboards, reports, and wall-tablet kiosks, with Home Assistant and Discord integrations planned/partial. + +**Repository:** https://gitea.hideawaygaming.com.au/jessikitty/family-hub + +## Architecture +- **Backend:** FastAPI, SQLAlchemy, SQLite; APScheduler (must be started in FastAPI lifespan) for chore resets +- **Frontend:** React 18, TypeScript, Tailwind +- **Kiosk:** public (unauthenticated) pages for wall tablets; chore-first room → chore → "who did this?" flow +- **Deploy:** Windows host, `D:\Hosted\familyhub\`, `start.bat`; live DB at `backend\data\family_hub.db` + +## Chore Model +- Completion log (Phase 3.1) drives reports, stats, leaderboards and verification +- Reset types: `weekly`, `fortnightly`, `monthly` (calendar-anchored, preferred); avoid `cooldown` for fixed-day chores + +## Current State +- Phase 3.1 is the last pushed state +- Kiosk redesign, reset schedules, custom dashboards and room editor exist locally only; four migrations pending (order: reset schedules → dashboards → pet care split → rooms) +- README merge conflict unresolved + +## Session Log +- 2026-02-05 — Phase 3.1 — Chore Completion Logging and Reports — Completion log, weekly/user stats API, verification, Reports page +- 2026-09-24 — Kiosk Redesign, Calendar Reset Schedules, Dashboards and Room Editor — Retrospective record of Aug 2026 local work; scheduler fix and four features awaiting migrations and push + +--- +*Created by: Jess Rogerson (yelling commands at Claude.AI)*