phaseflow/specs/dashboard.md

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