# Family System Architecture
## Architecture Document v1.0

---

## 1. Overview

### Purpose
A family command center to coordinate household logistics, shared responsibilities, kids' activities, budget, and family goals - accessible to both Assaf and Fiona.

### Core Principles
- **Shared visibility** - Both partners see everything
- **Low friction** - Voice/chat capture, smart defaults
- **Kid-aware** - School, activities, health tracking
- **Proactive** - Reminders before things slip

### Users
- **Assaf** - Via WhatsApp + Notion
- **Fiona** - Via WhatsApp + Notion (+ iMessage?)
- **Bot** - Monitoring & reminders
- **Sylvania** (housekeeper) - View shopping list?

---

## 2. Database Structure

### 2.1 Family To-Dos (existing, enhanced)
| Field | Type | Purpose |
|-------|------|---------|
| Task | Title | What needs doing |
| Category | Select | House / Kids / Admin / Shopping / Errands |
| Assigned | Select | Assaf / Fiona / Sylvania / Either |
| Status | Select | To Do / In Progress / Done |
| Priority | Select | Urgent / Normal / Whenever |
| Due Date | Date | Deadline |
| Recurring | Select | One-time / Daily / Weekly / Monthly |
| Kid | Relation → Kids | If kid-specific |
| Notes | Text | Details |

### 2.2 Shopping List (existing or new)
| Field | Type | Purpose |
|-------|------|---------|
| Item | Title | What to buy |
| Category | Select | Groceries / Household / Kids / Other |
| Store | Select | Supermarket / Pharmacy / Amazon / Other |
| Quantity | Text | How much |
| Status | Checkbox | Bought? |
| Added By | Select | Assaf / Fiona / Bot |
| Urgent | Checkbox | Need today |

### 2.3 Kids (new)
| Field | Type | Purpose |
|-------|------|---------|
| Name | Title | Léo / Daphne |
| Birthday | Date | For age calc |
| School | Text | Current school |
| Class/Year | Text | Grade level |
| Teacher | Text | Main teacher |
| Activities | Multi-select | Sports, music, etc |
| Medical | Text | Allergies, needs |
| Shoe Size | Text | Current size |
| Clothing Size | Text | Current size |

### 2.4 Activities & Events (new)
| Field | Type | Purpose |
|-------|------|---------|
| Event | Title | What |
| Date/Time | Date | When |
| Kid | Relation → Kids | Which kid(s) |
| Type | Select | School / Sport / Birthday / Medical / Trip |
| Location | Text | Where |
| Notes | Text | What to bring, etc |
| Reminder | Select | 1 day / 1 hour / Morning of |

### 2.5 Recurring Events (new)
| Field | Type | Purpose |
|-------|------|---------|
| Name | Title | Activity name |
| Kid | Relation → Kids | Which kid |
| Day | Select | Monday-Sunday |
| Time | Text | What time |
| Location | Text | Where |
| Notes | Text | What to bring |
| Active | Checkbox | Currently happening |

### 2.6 Budget & Expenses (optional)
| Field | Type | Purpose |
|-------|------|---------|
| Date | Date | When |
| Amount | Number | € spent |
| Category | Select | Groceries / Dining / Kids / House / Transport |
| Description | Text | What |
| Who | Select | Assaf / Fiona / Joint |
| Account | Select | Which card/account |

### 2.7 Meal Planning (optional)
| Field | Type | Purpose |
|-------|------|---------|
| Date | Date | Which day |
| Meal | Select | Breakfast / Lunch / Dinner |
| Recipe | Text | What we're making |
| Ingredients | Text | Shopping list items |
| Who Cooks | Select | Assaf / Fiona |

### 2.8 Important Contacts
| Field | Type | Purpose |
|-------|------|---------|
| Name | Title | Contact name |
| Role | Select | Doctor / School / Emergency / Service |
| Phone | Phone | Number |
| Email | Email | Email |
| For | Multi-select | Family / Léo / Daphne |
| Notes | Text | Context |

---

## 3. Views & Dashboards

### 3.1 Family Dashboard
- This week's calendar (all family events)
- To-do's by person
- Shopping list (quick view)
- Upcoming birthdays/events

### 3.2 Kids View
- Per-kid schedule
- Upcoming activities
- Medical/size info
- School contacts

### 3.3 House Management
- Recurring tasks (cleaning, maintenance)
- Service provider contacts
- Inventory (optional)

---

## 4. Automations & Agent Workflows

### 4.1 Morning Family Briefing (7:30am)
Bot sends (to both):
- Today's family calendar
- Kid pickups/activities
- Any urgent to-dos
- Weather for planning

### 4.2 Shopping List Management
- "Add milk to shopping list" → Bot adds
- Weekly shopping reminder (Sunday?)
- Generate list by store

### 4.3 Kid Activity Reminders
- 1 day before: "Léo has swimming tomorrow, pack bag"
- Morning of: "Daphne's ballet at 4pm today"
- Pickup reminders

### 4.4 Recurring Task Reminders
- Weekly: Take out trash (which day?)
- Monthly: Pay bills, check supplies
- Seasonal: Kids clothes check, school supplies

### 4.5 Family Coordination
- "Fiona, Assaf added: pick up dry cleaning"
- Shared visibility on who's doing what
- Conflict detection (double-booked pickups)

### 4.6 Special Dates
- Birthday reminders (2 weeks + 1 day before)
- Anniversary reminders
- School events calendar sync

---

## 5. Integrations

| System | Direction | What Syncs |
|--------|-----------|------------|
| Home Calendar (iCloud) | ↔ | Family events |
| WhatsApp (Assaf) | ↔ | Commands & alerts |
| WhatsApp (Fiona) | ↔ | Commands & alerts |
| School Calendar | ← | Import events (manual?) |

---

## 6. Voice/Chat Commands

### Quick Capture
- "Add eggs to shopping list"
- "Remind me to call school tomorrow"
- "Léo is sick, cancel his activities today"
- "What's happening this weekend?"

### Queries
- "What do we need from the supermarket?"
- "When is Daphne's next doctor appointment?"
- "What's for dinner this week?"
- "Who's picking up kids today?"

### Updates
- "I got the milk" (marks done)
- "I'll handle school pickup today"
- "Move dentist to next week"

---

## 7. Fiona's Access

### Options
1. **WhatsApp** - Same as Assaf, message the bot
2. **Notion App** - Direct database access
3. **Shared Note** - Simple shared Apple Note
4. **iMessage** - If BlueBubbles working

### Recommendation
Start with **WhatsApp group** (Assaf + Fiona + Bot) for shared visibility, plus individual DMs for personal tasks.

---

## 8. Implementation Phases

### Phase 1: Core Lists (This Week)
- [ ] Enhance Family To-Dos database
- [ ] Create Shopping List database
- [ ] Create Kids database with Léo & Daphne
- [ ] Basic chat commands working

### Phase 2: Calendar & Activities (Next)
- [ ] Sync Home calendar
- [ ] Create Activities database
- [ ] Activity reminders working
- [ ] Morning briefing includes family

### Phase 3: Coordination (Later)
- [ ] Fiona's WhatsApp connected
- [ ] Shared family group chat
- [ ] Meal planning (if wanted)
- [ ] Budget tracking (if wanted)

---

## 9. Open Questions for Assaf & Fiona

1. **Fiona's preferred interface** - WhatsApp? Notion app? Both?
2. **Shopping list sharing** - Should Sylvania see it?
3. **Budget tracking** - Want to track expenses?
4. **Meal planning** - Useful or overkill?
5. **Kids activities** - What recurring activities exist?
6. **School calendar** - How do you currently track?
7. **Cleaning schedule** - What are Sylvania's tasks?
8. **Family group chat** - Want shared bot chat?

---

*Created: January 23, 2026*
*Status: Draft for Review*