docs: add .claude-context project overview
This commit is contained in:
1 parent
2d6bef19e3
commit
0c7dd2e352
1 file changed
+27
@@ -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)*
|
||||
Reference in new issue
Block a user