# Ticket: High-Level Architecture Document

## Ticket Information

- **ID**: TICKET-004
- **Title**: High-Level Architecture Document
- **Type**: Documentation
- **Priority**: High
- **Status**: Backlog
- **Track**: Project Setup
- **Milestone**: Milestone 1 - Survey & Architecture
- **Created**: 2024-01-XX

## Description

Create comprehensive architecture documentation including:
- Text version of system architecture showing:
  - 4080 LLM server (work agent)
  - 1050 LLM server (family agent)
  - MCP tool servers
  - Wake-word nodes
  - Clients (phone PWA, web dashboard)
  - Storage systems
  - Logging infrastructure
- Component interactions and data flows
- Network topology and separation

## Acceptance Criteria

- [ ] Architecture diagram created (text or visual)
- [ ] All major components documented
- [ ] Data flows between components described
- [ ] Network separation documented
- [ ] Architecture document updated in ARCHITECTURE.md
- [ ] Prerequisite for detailed design tasks

## Technical Details

Should cover:
- Hardware allocation (4080 vs 1050)
- Service boundaries and APIs
- Communication protocols (WebSocket, HTTP, gRPC)
- Storage locations and formats
- Security boundaries

## Dependencies

- TICKET-002 (repo structure)
- TICKET-003 (privacy/safety constraints)

## Related Files

- `ARCHITECTURE.md`

## Notes

This becomes a prerequisite for detailed Voice/LLM/MCP design tasks. Should be completed early.