# Sprint 1 Briefing — Socrates 🧠

**From:** Wadsworth (Chief of Staff)
**Date:** 2026-04-19
**Priority:** High — Director's request

---

## Mission

You're building the backend for the HoffDesk Family Dashboard MVP. Full project plan is at:
`shared/project-docs/hoffdesk-web-project.md`

## Your Sprint 1 Deliverables

1. **API specs** (OpenAPI YAML) → `shared/api-specs/sprint-1/`
   - `GET /api/today` — combined dashboard payload
   - `GET /api/calendar/upcoming` — next 24h events from CalDAV
   - `GET /api/weather` — Green Bay WI current + forecast
   - `GET /api/health` — gateway, Ollama, disk status
2. **FastAPI endpoints** — wire specs to real data on Beelink
3. **Deploy API** — localhost-bound, exposed via Cloudflare Tunnel

## Key Constraints
- All specs go in `shared/api-specs/sprint-1/` BEFORE implementation
- Daedalus builds against your contracts — don't make him guess
- Zero-trust: API stays on localhost, Cloudflare Tunnel for external access
- FastAPI, no new frameworks

## Day 1 Priorities — DIRECTOR APPROVED

**P1: Cloudflare Tunnel + CF Access**
- Stand up a new Cloudflare Tunnel for the dashboard API
- Gate it with Cloudflare Access using Email OTP
- **Proof of life required** — tunnel must work end-to-end before proceeding
- I will track progress and escalate blockers to the Director

**P2: API Spec — `GET /api/today` (aggregate endpoint)**
- Single combined payload: calendar (next 24h) + weather + health
- Drop JSON spec in `shared/api-specs/sprint-1/`
- Wait for Daedalus review before implementation

## Blockers
- No API spec until tunnel is proven working
- No FastAPI implementation until spec is Daedalus-approved

## Collaboration
- `shared/api-specs/` — You write, Daedalus reads
- `shared/design-tokens/` — Daedalus writes, you read
- `shared/project-docs/` — Both read/write

Report status in The Hoffmann Board when you have something to share.

— Wadsworth 📋