수업 시간 미등록 수업의 타임아웃 버튼 항상 활성화

마지막 업데이트 2026-10-21

38c2bea3 PR #1191 charles-na · 2026-10-21 Feature 5 files +53 −19

PPI-1404. 지금까지 모니터의 타임아웃 버튼은 등록된 수업 시작 시각에서 20분이 지나야 켜졌고, 시간이 없는 수업(테스트 모드 등)에서는 끝까지 꺼져 있었습니다. 이제 scheduledTime과 classTime이 모두 없는 수업은 처음부터 켜집니다. 리뷰할 때는 getLessonTimeoutAt에 새로 들어간 두 줄과, 호출부가 lesson && {...}로 로딩 중 상태를 구분하도록 바뀐 부분부터 보면 됩니다.

무엇이, 왜 바뀌었나

테스트 모드처럼 수업 시간을 등록하지 않고 진행하는 수업에서도 진행자가 타임아웃 버튼을 쓸 수 있어야 합니다. 기존 훅은 시간 정보가 없으면 null을 반환해 버튼을 꺼 두는(fail closed) 방식이었습니다.

상황이전이후
예외 시간(scheduledTime)이나 정규 시간(classTime)이 있음시작 20분 뒤 활성그대로 (테스트 모드여도 동일)
시간이 둘 다 없음 (테스트 모드 등)계속 비활성항상 활성
수업 정보 로딩 중비활성비활성 (예약 수업에서 버튼이 잠깐 켜지는 것 방지)
값은 있는데 형식이 깨짐 / 날짜 없이 시간만 있음비활성비활성

코드로 보는 핵심 지점

① 일정 없음 = 즉시 허용, 로딩 중 = 차단

apps/web/hooks/use-lesson-timeout.ts // 수업 로딩 전(undefined)은 null로 막고, 시간이 등록되지 않은 수업(테스트 모드 등)은 즉시 허용한다 export function getLessonTimeoutAt(schedule: LessonSchedule): number | null { export function getLessonTimeoutAt( schedule: LessonSchedule | null | undefined, ): number | null { if (!schedule) return null; if (!schedule.scheduledTime && !schedule.classTime) return 0; let start = schedule.scheduledTime ? Date.parse(schedule.scheduledTime) : NaN;

0은 "epoch부터 허용"이라는 뜻입니다. 기존 Date.now() >= availableAt 비교와 타이머 로직을 그대로 통과해 바로 활성 상태가 되고 타이머도 걸리지 않습니다.

② 호출부: lesson이 없으면 undefined를 넘김

apps/web/features/session/ui/session-card.tsx (page.tsx도 동일) const lessonTimeout = useLessonTimeout({ scheduledTime: lesson?.scheduledTime, classTime: lesson?.classTime, classDate: classDate ?? lesson?.classDate, }); const lessonTimeout = useLessonTimeout( lesson && { scheduledTime: lesson.scheduledTime, classTime: lesson.classTime, classDate: classDate ?? lesson.classDate, }, );

예전처럼 항상 객체를 넘기면 로딩 중에도 필드가 모두 비어 "일정 없음"으로 판정되고, 예약 수업에서 버튼이 잠깐 켜졌다가 꺼집니다. lesson이 null일 수 있어 훅 시그니처에 null도 받도록 했습니다.

레이어별 변경 요약

레이어파일핵심 변경
훅apps/web/hooks/use-lesson-timeout.ts로딩 중(null/undefined) → 비활성, 시간 없음 → 즉시 활성
카드뷰apps/web/features/session/ui/session-card.tsxlesson 로딩 전에는 undefined 전달
포커스뷰apps/web/app/monitor-dashboard/[group]/[roomId]/page.tsxlesson 로딩 전에는 undefined 전달
테스트apps/web/hooks/use-lesson-timeout.test.tsx일정 없음 2케이스 활성, 로딩 중 비활성 추가 (12/12)
Storybookapps/web/features/session/ui/session-header.timeout.stories.tsxUnknownSchedule 대신 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 이력을 다룹니다.