Setup Ralph.

specs/dashboard.md

@@ -0,0 +1,94 @@
+# Dashboard Specification
+
+## Job to Be Done
+
+When I open the app each morning, I want to immediately see whether I should train today, so that I can make informed decisions without manual data analysis.
+
+## Components
+
+### Decision Card (`decision-card.tsx`)
+
+Displays the daily training decision prominently.
+
+**Required Elements:**
+- Large status indicator (REST / GENTLE / LIGHT / REDUCED / TRAIN)
+- Color-coded background (red for REST, yellow for GENTLE/LIGHT/REDUCED, green for TRAIN)
+- Reason text explaining why this decision was made
+- Icon matching the decision status
+
+**Data Source:**
+- `/api/today` endpoint returns current decision
+
+### Data Panel (`data-panel.tsx`)
+
+Shows the biometric data used to make the decision.
+
+**Required Elements:**
+- HRV Status (Balanced/Unbalanced/Unknown)
+- Body Battery Current (0-100)
+- Body Battery Yesterday Low (0-100)
+- Cycle Day (e.g., "Day 12")
+- Current Phase (MENSTRUAL, FOLLICULAR, OVULATION, EARLY_LUTEAL, LATE_LUTEAL)
+- Week Intensity Minutes (accumulated)
+- Phase Limit (weekly cap based on phase)
+- Remaining Minutes until limit
+
+**Visual Indicators:**
+- Color-code HRV status (green=Balanced, red=Unbalanced, gray=Unknown)
+- Progress bar for week intensity vs phase limit
+
+### Nutrition Panel (`nutrition-panel.tsx`)
+
+Displays seed cycling and macro guidance.
+
+**Required Elements:**
+- Current seeds to consume (Flax+Pumpkin OR Sesame+Sunflower)
+- Carb range for the day (e.g., "20-100g")
+- Keto guidance (OPTIONAL / No / NEVER with reason)
+- Seed switch alert on day 15
+
+**Data Source:**
+- `getNutritionGuidance(cycleDay)` from `src/lib/nutrition.ts`
+
+### Override Toggles (`override-toggles.tsx`)
+
+Emergency modifications to the standard decision.
+
+**Override Types:**
+- `flare` - Hashimoto's flare (force REST)
+- `stress` - High stress day (force REST)
+- `sleep` - Poor sleep (<6 hours) (force GENTLE)
+- `pms` - PMS symptoms (force GENTLE)
+
+**Behavior:**
+- Toggle buttons for each override
+- Active overrides persist until manually cleared
+- Active overrides override the algorithmic decision
+- Store in `user.activeOverrides[]`
+
+### Mini Calendar (`mini-calendar.tsx`)
+
+Visual cycle overview for the current month.
+
+**Required Elements:**
+- Monthly grid view
+- Today highlighted
+- Phase colors for each day
+- Period days marked distinctly
+- Quick navigation to previous/next month
+
+## Success Criteria
+
+1. User can determine training status within 3 seconds of opening app
+2. All biometric data visible without scrolling on mobile
+3. Override toggles accessible but not accidentally activated
+4. Phase colors consistent across all components
+
+## Acceptance Tests
+
+- [ ] Dashboard loads decision from `/api/today`
+- [ ] Decision card shows correct status and color
+- [ ] Data panel displays all 8 required metrics
+- [ ] Nutrition panel shows correct seeds for cycle day
+- [ ] Override toggles update user record immediately
+- [ ] Mini calendar renders current month with phase colors