# Family Dashboard

> A calm, shared operating system for family rhythms, date nights, roadmaps & home upkeep created by Wanessa Labs.

One permissioned Google Sheet is the single source of truth. The family curates it by hand. The application ingests the spreadsheet alongside the shared family calendar, generates the deterministic Sunday review agenda, schedules date nights, tracks school holidays, coordinates household maintenance, and runs an ambient kitchen countertop kiosk mode.

## Core Reference Links

- [System Overview](https://family.wanessalabs.com/): How Family OS provides alignment on Sunday mornings without cloud lock-in.
- [About Family OS](https://family.wanessalabs.com/about/): Design philosophy, editorial print aesthetics, and system architecture.
- [Privacy Architecture](https://family.wanessalabs.com/privacy/): Comprehensive inventory of data storage, AES-GCM encryption, and zero-AI transmission invariants.
- [Terms of Service](https://family.wanessalabs.com/terms/): Terms of use and data governance.
- [Full Technical Documentation](https://family.wanessalabs.com/llms-full.txt): Complete architectural reference, database schemas, and pure engine contracts.

## Key System Invariants

- **One Write Path & Additive Updates:** Writes touch only the cells that changed. Never overwrites a human update and never deletes rows automatically.
- **Pure Engine Architecture:** Core scheduling algorithms in `src/engine/` take date and time as deterministic parameters. Zero clock drift.
- **Local Privacy & Zero External AI:** No family financial numbers, child information, or calendar details are ever sent to external AI providers.
- **Decoupled Architecture:** Static frontend hosted on Cloudflare Pages; Google OAuth and token persistence isolated on Cloudflare Workers and D1 database.