# task-88.1 대시보드 UX 심도 미팅 → 개선 도출 → 구현

## 기본 정보
- **Task ID**: task-88.1 (위임: task-89.1)
- **팀**: dev2-team (오딘)
- **작업일**: 2026-03-02
- **상태**: 완료

## 1단계: 팀원 미팅 결과

### 토르 (백엔드) — 10개 개선안 도출
- [P1] get_member_status: 팀장만 working, 팀원은 항상 standby → 정책 개선 필요
- [P1] idle 상태가 프론트엔드 stat 카드에 표시되지 않음 (15명 미표시)
- [P1] /api/org 등에서 reload_all() 미호출 → stale data 가능
- [P2] 1초 TTL + 1초 polling = 초당 20회 파일 I/O
- [P2] standby/waiting 이중 카운팅 문제
- [P2] 파일 로드 실패 시 에러 불투명
- [P2] "dev-team" fallback 매핑 위험
- [P2] FastAPI 모드에서 reload 미호출

### 프레이야 (프론트엔드) — 10개 개선안 도출
- [P1] 이름 잘림(truncation) — 거의 모든 멤버 이름이 읽을 수 없음
- [P1] 팀 상태 "대기중" 오표시 — 데이터 신뢰도 훼손
- [P1] 자동 시작 미지원 — 첫 진입 시 빈 화면
- [P2] 1초 5개 API 호출 성능 문제
- [P2] TaskHistory 팀 이름 변환 로직 오류 ("팀1", "red")
- [P2] stat 카드 수치 불일치 (20명 중 5명만 집계)
- [P2] 반응형 디자인 부재 (grid-cols-4 고정)

### 미미르 (UX/UI) — 10개 개선안 도출
- [P1] 개발실장 카드의 비효율적 공간 사용 (25%에 정보 3줄)
- [P1] 팀원 이름 잘림 해결 필요
- [P1] 상단 통계의 분모 맥락 제공 (15명 어디?)
- [P2] 기술부채+CI 섹션 과대한 공간 대비 낮은 정보 가치
- [P2] Finance 센터 빈 카드가 공간 낭비
- [P2] 색상 체계의 비일관성
- [P3] 정보 계층 재설계 — 진행중 작업 배너를 상단으로

### 헤임달 (QA) — 7개 검증 항목
- [PASS] 전체 인원 20명 일치
- [PASS] 작업중/대기 수치 정확
- [PASS] 완료 작업 수 정확
- [PASS] 팀원 이름 정확 (truncation은 UI 문제)
- [PASS] 횡단조직 4개 센터 정확
- [WARNING] 레드팀(로키) 대시보드에 미표시 — UI 누락
- [WARNING] CI warn 상태 미처리 — pass/fail만 처리, warn은 "-"로 표시

## 2단계: 종합 우선순위 및 구현

### 구현 완료 항목

| # | 개선 내용 | 우선순위 |
|---|----------|---------|
| 1 | 개발실장 카드 → 헤더에 compact 통합 | P1 |
| 2 | 팀 카드 grid-cols-4 → grid-cols-3 (팀 카드 33% 확대) | P1 |
| 3 | 이름 잘림 해결: 한국어 이름만 표시, 영문/역할은 tooltip | P1 |
| 4 | stat 카드 → "인원 현황" 바로 전면 개편 (가동률 게이지) | P1 |
| 5 | idle/유휴 인원 명시적 표시 (15명 문제 해결) | P1 |
| 6 | 완료 건수와 인원 상태 분리 표시 | P1 |
| 7 | 자동 시작 (LIVE 기본 on) | P1 |
| 8 | 진행중 작업 배너 → 최상단으로 이동 | P2 |
| 9 | 기술부채+CI → 헤더에 compact 배지로 통합 | P2 |
| 10 | 레드팀(로키) 표시 추가 | P2 |
| 11 | Finance 센터(planned) 숨김 | P2 |
| 12 | 팀 이름 매핑 수정 (teamLabels 객체) | P2 |
| 13 | CI warn 상태 처리 추가 | P2 |
| 14 | 반응형 그리드 (md/xl breakpoints) | P2 |
| 15 | 폴링 간격 1초 → 5초 | P2 |
| 16 | 모든 API 엔드포인트에서 reload_all() 호출 | P2 |

### 수정된 파일
- `/home/jay/workspace/dashboard/index.html` — 프론트엔드 전면 개편
- `/home/jay/workspace/dashboard/server.py` — API 엔드포인트 reload_all() 통일

### 서버 재시작
- `pkill -f 'python.*server.py'; nohup python3 server.py > /dev/null 2>&1 &`
- API 확인: `curl -s -u admin:changeme http://localhost:8000/api/stats` → 정상 응답

## 핵심 변경 요약

**Before:**
- 보라색 개발실장 카드가 25% 공간 차지, 팀원 이름 전부 잘림
- 20명 중 5명만 stat 카드에 집계 (15명 미표시)
- 기술부채/CI가 하단 50% 차지하며 정보 빈약
- 매번 LIVE 버튼 클릭 필요, 1초 폴링

**After:**
- 개발실장 헤더 통합, 팀 카드 3열로 확대 → 이름 온전히 표시
- 인원 현황 바 + 가동률 게이지 → 20명 전원 상태 표시
- 기술부채/CI → 헤더 compact 배지
- 자동 시작, 5초 폴링, 진행중 작업 최상단