# RTSport — Coach Dashboard Retool + AD View Spec

**Date:** 2026-05-03
**Status:** Design Decision — Pending Implementation
**Owner:** Daedalus (frontend), Socrates (backend API update)

---

## Problem

Current Coach dashboard shows multi-sport roster. Real coaches only manage ONE sport.

## Solution: Two Views

### 1. Retooled Coach Dashboard (Single-Sport)

**Scope:** One sport, one team, all athletes in that sport

**Header:**
```
RTSport                          🏈 Football (Coach)
                                 ↓ sport selector (dropdown)
```

**Quick Stats:**
```
[ 3 Out ] [ 2 Modified ] [ 45 Cleared ]
```

**Roster Section:**
```
Varsity Football — 50 athletes

Jake Larson          🚫 Out      Ankle - Right
Marcus Johnson       🚫 Out      Left Knee ACL Tear
Tyler Wilson         ⚠️ Modified  Knee - Left
Brandon Davis        ✓ Cleared
Connor Miller        ✓ Cleared
...
```

**Tap athlete → detail overlay:**
```
┌─────────────────────────────┐
│ Jake Larson                 │
│ Varsity · Grade 11 · WR     │
│                             │
│ 🚫 OUT — Ankle - Right      │
│ Severity: Moderate          │
│ Phase: Active Rehab (2/4)   │
│                             │
│ Milestones:                 │
│ ✓ Initial Assessment        │
│ → Active Rehab (current)    │
│ ○ Return to Play            │
│ ○ Full Clearance            │
│                             │
│ [Message AT] [View Timeline]│
└─────────────────────────────┘
```

**Actions:**
- Message AT (opens chat/email)
- View full timeline (scroll)

**Sport Selector:**
- If coach has multiple sports assigned, show dropdown
- Default to primary sport
- Switching reloads roster

---

### 2. AD View (Multi-Sport Overview)

**Scope:** All sports in school, summary level

**Header:**
```
RTSport                          👤 AD Overview
```

**School Stats:**
```
Total Athletes: 340
Active Cases: 12
Out Today: 3
Modified: 5
```

**Sport Cards:**
```
┌──────────────┐ ┌──────────────┐
│ 🏈 Football  │ │ 🏀 Basketball│
│   50 ath     │ │   15 ath     │
│   3 Out      │ │   0 Out      │
│   2 Modified │ │   1 Modified │
└──────────────┘ └──────────────┘
```

**Tap sport card → drill to that sport's coach view**

**Recent Activity Feed:**
```
• 10 min ago — Jake Larson (FB) marked Out
• 2 hr ago — Tyler Wilson (FB) restriction modified
• Yesterday — Marcus Johnson (FB) case opened
```

---

## API Changes Required

### Coach Model Update
```python
class User(BaseModel):
    id: str
    email: str
    role: Literal["at", "coach", "parent", "ad"]
    school_id: str
    assigned_sports: List[str]  # NEW — coach's sports
    assigned_teams: List[str]   # NEW — coach's teams
```

### New Endpoints
```
GET /api/v1/dashboard/coach?sport=Football
→ Returns roster for that sport

GET /api/v1/dashboard/ad
→ Returns all sports summary

GET /api/v1/roster?school_id=X&sport=Football&team=Varsity
→ Already supported, use it
```

### Seed Data Update
Add test coaches:
```
coach_football@preble.k12.wi.us — Football only
coach_basketball@preble.k12.wi.us — Basketball only
coach_multi@preble.k12.wi.us — Football + Basketball
```

---

## Implementation Order

1. **Backend:** Update User model + seed data + new endpoints
2. **Coach Dashboard:** Retool to single-sport
3. **AD View:** Create new page
4. **Test:** Verify with different coach logins

---

## Questions for Matt

1. **Coach sport assignment:** Manual by AT? Self-selected? Imported from SIS?
2. **Assistant coaches:** Do they see full team or position group only?
3. **AD permissions:** Can AD edit cases, or view-only?
4. **Phase 1 priority:** Coach retool first, AD view second?