마지막 업데이트 2026-10-21
PPI-1404. 지금까지 모니터의 타임아웃 버튼은 등록된 수업 시작 시각에서 20분이 지나야 켜졌고, 시간이 없는 수업(테스트 모드 등)에서는 끝까지 꺼져 있었습니다. 이제 scheduledTime과 classTime이 모두 없는 수업은 처음부터 켜집니다. 리뷰할 때는 getLessonTimeoutAt에 새로 들어간 두 줄과, 호출부가 lesson && {...}로 로딩 중 상태를 구분하도록 바뀐 부분부터 보면 됩니다.
테스트 모드처럼 수업 시간을 등록하지 않고 진행하는 수업에서도 진행자가 타임아웃 버튼을 쓸 수 있어야 합니다. 기존 훅은 시간 정보가 없으면 null을 반환해 버튼을 꺼 두는(fail closed) 방식이었습니다.
| 상황 | 이전 | 이후 |
|---|---|---|
예외 시간(scheduledTime)이나 정규 시간(classTime)이 있음 | 시작 20분 뒤 활성 | 그대로 (테스트 모드여도 동일) |
| 시간이 둘 다 없음 (테스트 모드 등) | 계속 비활성 | 항상 활성 |
| 수업 정보 로딩 중 | 비활성 | 비활성 (예약 수업에서 버튼이 잠깐 켜지는 것 방지) |
| 값은 있는데 형식이 깨짐 / 날짜 없이 시간만 있음 | 비활성 | 비활성 |
mode=test 여부를 보지 않고 수업 데이터의 시간 필드만 봅니다. 테스트 모드여도 수업 시간이 등록돼 있으면 20분 경과를 확인합니다.session-card.tsx)와 포커스뷰(monitor-dashboard/[group]/[roomId]/page.tsx) 두 곳 모두 같은 훅을 씁니다.0은 "epoch부터 허용"이라는 뜻입니다. 기존 Date.now() >= availableAt 비교와 타이머 로직을 그대로 통과해 바로 활성 상태가 되고 타이머도 걸리지 않습니다.
예전처럼 항상 객체를 넘기면 로딩 중에도 필드가 모두 비어 "일정 없음"으로 판정되고, 예약 수업에서 버튼이 잠깐 켜졌다가 꺼집니다. lesson이 null일 수 있어 훅 시그니처에 null도 받도록 했습니다.
| 레이어 | 파일 | 핵심 변경 |
|---|---|---|
| 훅 | apps/web/hooks/use-lesson-timeout.ts | 로딩 중(null/undefined) → 비활성, 시간 없음 → 즉시 활성 |
| 카드뷰 | apps/web/features/session/ui/session-card.tsx | lesson 로딩 전에는 undefined 전달 |
| 포커스뷰 | apps/web/app/monitor-dashboard/[group]/[roomId]/page.tsx | lesson 로딩 전에는 undefined 전달 |
| 테스트 | apps/web/hooks/use-lesson-timeout.test.tsx | 일정 없음 2케이스 활성, 로딩 중 비활성 추가 (12/12) |
| Storybook | apps/web/features/session/ui/session-header.timeout.stories.tsx | UnknownSchedule 대신 UnscheduledLesson(활성)과 LessonLoading(비활성) |
정규 수업 시간(classTime)은 수업 정보를 불러올 때 ppi-api에서 채워 넣습니다(lib/lesson-ppi-api-utils.ts). ppi-api 응답이 실패하거나 해당 수업이 매칭되지 않으면, 정규 수업도 "시간 없음"으로 보여 버튼이 바로 켜집니다(fail open). 확인 창이 한 번 더 뜨므로 영향은 제한적이라고 보고 수정하지 않았습니다.
"테스트 모드면 무조건 표시"가 아니라 "수업 시간이 없으면 표시"로 구현했습니다. 테스트 모드인데 수업 시간이 등록돼 있으면 20분 제한이 그대로 적용됩니다.
비활성일 때 툴팁("예약된 수업 시작 20분 후 사용할 수 있습니다.")은 바꾸지 않았습니다. 이제 비활성은 예약 수업이거나 로딩 중일 때만 나오므로 문구와 맞습니다.
vitest 12/12 통과(새 동작 테스트를 먼저 추가해 실패 확인), Storybook 정적 빌드 성공, mutation 점수 80.49%이며 새로 넣은 분기에서 살아남은 mutant는 없습니다. 실제 모니터 화면은 아직 확인하지 않았습니다.
관련 문서: 카드뷰 세션 변천사 — 시간종료 버튼(PPI-968)이 카드뷰에 들어온 배경과 revert 이력을 다룹니다.