2026-11-18 수업 로그 기술이슈 확인 대상

마지막 업데이트 2026-11-18

S3 수업 세션 로그 기반 · 테스트/내부 계정 및 force kick, 네트워크 경고, TURN_ANALYSIS, 진단성 미디어 경고 제외

0분석 세션
0기술이슈 후보
0정상
force kick / 네트워크 / TURN_ANALYSIS / 진단성 미디어 경고제외 기준
0긴급
0확인
목표는 원인 설명을 길게 쓰는 것이 아니라, 운영자가 바로 확인해야 할 아동 세션을 고르는 것입니다. 아래 목록은 아동명, 회기, 핵심 이슈, 원본 시그니처를 함께 보여줍니다.

당일 반영된 PPI 변경사항

GitHub develop merged PR 기준 · 총 6건. 병합 시각만으로 배포 완료를 단정하지 않습니다.

#1337 chore: Dev 배포 기본 러너를 ppi-local-build로 변경

charles-na · 2026-11-18 19:09 KST

변경 기능
배포/인프라 — 수동 Dev 배포의 기본 러너를 ppi-local-build로 변경
영향받을 수 있는 사용자 흐름
운영자가 GitHub Actions에서 Dev 배포를 수동 실행하는 흐름. 수업 사용자 흐름에는 직접 변경 없음
개선 기대
로컬 macOS 빌드 러너를 기본 선택해 Dev 배포 대기·빌드 시간을 줄일 가능성
회귀 위험
ppi-local-build 러너가 오프라인이거나 Docker 환경이 준비되지 않으면 기본 Dev 배포가 대기 또는 실패할 수 있음
확인할 로그·지표
GitHub Actions Dev workflow의 queued 시간, runner label, Docker 준비 단계와 health check 결과
관련 테스트
node --test scripts/dev-local-runner.test.mjs (PR 설명상 6/6 통과)
당일 이슈 관련 가능성
오늘 병합 수업 로그가 0건이라 기술이슈와 직접 대조 불가. 제품 런타임 로그와 직접 일치하는 변경 없음
배포 상태
병합 확인, 실제 Dev 배포 실행 시각은 확인 필요. 미배포 가능성 — 당일 이슈 원인으로 연결 금지

주요 변경 파일: .github/workflows/dev.yml · scripts/dev-local-runner.test.mjs

#1336 chore: Dev 배포를 로컬 macOS 빌드 러너에서 선택 실행할 수 있게 한다

charles-na · 2026-11-18 18:47 KST

변경 기능
배포/인프라 — Dev deploy/destroy 러너 선택과 macOS Docker·GitHub CLI 준비 지원
영향받을 수 있는 사용자 흐름
운영자가 Dev 배포 러너를 고르고 이미지 빌드·배포·삭제하는 흐름. Staging·Prod와 수업 UI에는 직접 변경 없음
개선 기대
전용 macOS arm64 러너에서 Dev 빌드를 선택 실행하고 기존 self-hosted 경로를 유지
회귀 위험
Docker Desktop socket/buildx, gh 바이너리 checksum, runner label 설정 오류가 Dev 배포를 빌드 전에 중단시킬 수 있음
확인할 로그·지표
Dev workflow runner 선택값, Prepare Docker config 오류, setup-dev-gh checksum 결과, 배포 health check
관련 테스트
node --test scripts/setup-dev-gh.test.mjs scripts/dev-local-runner.test.mjs (PR 설명상 22건 통과)
당일 이슈 관련 가능성
오늘 병합 수업 로그가 0건이라 기술이슈와 직접 대조 불가. 제품 이벤트·logger 변경은 없음
배포 상태
병합 확인, 실제 Dev 배포 실행 시각은 확인 필요. 미배포 가능성 — 당일 이슈 원인으로 연결 금지

주요 변경 파일: .github/workflows/dev.yml · scripts/dev-local-runner.test.mjs · scripts/setup-dev-gh.sh · scripts/setup-dev-gh.test.mjs

#1335 chore: 배포 빌드 시간 단축을 위한 LiveKit 의존성 key와 Web 이미지 구성 정리

charles-na · 2026-11-18 17:21 KST

변경 기능
배포/인프라 — LiveKit Agent 의존성 캐시 key와 Web runtime 이미지 레이어 최적화
영향받을 수 있는 사용자 흐름
LiveKit Agent 의존성 이미지와 Web 애플리케이션 이미지를 빌드·배포하는 흐름. 런타임 기능 코드는 변경하지 않음
개선 기대
불필요한 LiveKit 의존성 재빌드와 Web 이미지의 Next cache·재귀 chown 레이어를 줄여 빌드·push 단축 기대
회귀 위험
COPY --chown 또는 /app 디렉터리 소유권이 누락되면 컨테이너 시작·런타임 파일 접근이 실패할 수 있음
확인할 로그·지표
이미지 build/export/push 시간, LiveKit deps cache hit, Web 컨테이너 시작 로그·health check·권한 오류
관련 테스트
dependency image unittest, uv lock/mutmut, scripts/web-image-layout.test.mjs (PR 설명의 검증 항목)
당일 이슈 관련 가능성
오늘 병합 수업 로그가 0건이라 AI/LiveKit 또는 Web 오류와 직접 대조 불가. logger.js는 COPY 소유권만 변경
배포 상태
병합 확인, 실제 환경 배포 시각은 확인 필요. 미배포 가능성 — 당일 이슈 원인으로 연결 금지

주요 변경 파일: .github/actions/deploy-livekit-agent/test_dependency_image_cache.py · Dockerfile.dev.web · apps/livekit-agent/pyproject.toml · apps/livekit-agent/setup.cfg · apps/web/Containerfile · 외 1개

#1334 [PPI-1467] fix: 낮은 화면에서 입장 화면 본문이 접혀 입력칸에 닿지 못하는 문제 수정

charles-na · 2026-11-18 17:00 KST

변경 기능
아동 입장/재접속 — 낮은 viewport의 입장 준비 화면 스크롤과 포커스 입력칸 가시성 보정
영향받을 수 있는 사용자 흐름
iPad 등에서 키보드를 띄운 뒤 이름·전화번호를 입력하고 입장 버튼을 누르는 흐름
개선 기대
본문 최소 높이와 main 세로 스크롤을 보장하고 포커스 필드를 visual viewport 안으로 이동해 입력·입장 가능성 개선
회귀 위험
visualViewport resize/scroll 처리와 scrollIntoView가 화면을 예상보다 이동시키거나 데스크톱 레이아웃 스크롤을 바꿀 수 있음
확인할 로그·지표
입장 페이지 이탈률, 입장 버튼 도달·클릭, viewport/키보드별 UI 재현; 신규 제품 logger는 확인되지 않음
관련 테스트
use-keep-focused-field-visible.test.tsx 및 guest-preparation-shell Storybook 시나리오
당일 이슈 관련 가능성
오늘 병합 수업 로그가 0건이라 입장 실패 로그와 직접 대조 불가. UI 접근성 변경으로 수업 중 로그 signature와 직접 일치하지 않음
배포 상태
병합 확인, 실제 배포 시각은 확인 필요. 미배포 가능성 — 당일 이슈 원인으로 연결 금지

주요 변경 파일: apps/web/components/ui/guest-preparation-shell.stories.tsx · apps/web/components/ui/guest-preparation-shell.tsx · apps/web/components/ui/use-keep-focused-field-visible.test.tsx · apps/web/components/ui/use-keep-focused-field-visible.ts

#1333 [PPI-1454] feat: 마지막 대화 종료조건으로 남은 대화를 건너뛴다

charles-na · 2026-11-18 14:41 KST

변경 기능
수업 진행/완료/저장 및 AI 세션 — 마지막 대화의 종료 문구를 앞선 대화에도 적용해 잔여 대화를 건너뜀
영향받을 수 있는 사용자 흐름
아동이 대화형 스텝을 진행하다 마지막 대화 종료 문구를 말하면 남은 대화 스텝을 생략하고 후속 리소스 또는 수업 종료로 이동하는 흐름
개선 기대
종료 의도가 확인된 뒤 불필요한 대화를 반복하지 않고 활동 종료·다음 비대화 스텝으로 자연스럽게 전환
회귀 위험
앞선 대화에서 일반 발화가 종료 문구와 오인되면 대화 스텝이 조기 생략될 수 있고, message-only preset/전환 상태가 AI 응답 종료와 경합할 수 있음
확인할 로그·지표
Conversation-end preset sent as message only logger, 종료조건 match, step 전환 index, auto-finish, AI session 종료·활동 완료율
관련 테스트
conversation-end.test.ts, activity-utils.auto-finish.test.ts, step-navigation/use-step-navigation 및 step-transition 테스트
당일 이슈 관련 가능성
오늘 병합 수업 로그가 0건이라 신규 logger prefix·상태 전이와 직접 대조 불가. 향후 해당 logger와 조기 step 전환을 함께 확인해야 함
배포 상태
병합 확인, 실제 배포 시각은 확인 필요. 미배포 가능성 — 당일 이슈 원인으로 연결 금지

주요 변경 파일: apps/web/entities/guest-page-session/lib/step-navigation.ts · apps/web/entities/guest-page-session/model/use-step-navigation.ts · apps/web/entities/guest-page-session/model/use-step-transition.ts · apps/web/entities/guest-session/model/use-ai-session.ts · apps/web/lib/activity-utils.ts · 외 6개

#1330 [PPI-1472] feat: 녹화 링크의 지정 실제 시각으로 이동

woooooji · 2026-11-18 14:41 KST

변경 기능
진행자 모니터링 — 녹화 URL의 at 실제 시각을 연속 타임라인 위치로 변환해 최초 seek·재생
영향받을 수 있는 사용자 흐름
진행자가 공유받은 녹화 링크를 열어 특정 실제 시각으로 이동하고, 겹침·빈 구간을 포함한 녹화를 탐색·재생하는 흐름
개선 기대
문제 발생 실제 시각을 링크로 공유하고 메타데이터 준비 뒤 해당 위치를 한 번만 적용해 조사 시간을 단축
회귀 위험
겹친 녹화·빈 구간·경계 시각 변환, 자동재생 차단, 정확한 끝 위치에서 재생 시 처음으로 돌아가는 알려진 위험이 있음
확인할 로그·지표
at 파싱 안내, seek 결과와 적용 횟수, play/AudioContext 실패, 녹화 manifest startedAt·duration 및 pageerror
관련 테스트
recording-at, use-initial-recording-seek, continuous-timeline, recording-viewer-container 등 PR 설명상 31파일 289테스트 통과
당일 이슈 관련 가능성
진행자용 녹화 조사 UI 변경이며 오늘 병합 수업 로그가 0건이라 기술이슈 signature와 직접 연결할 근거 없음
배포 상태
병합 확인, 실제 배포 시각은 확인 필요. 미배포 가능성 — 당일 이슈 원인으로 연결 금지

주요 변경 파일: apps/web/app/main/staff/log/recording/page.tsx · apps/web/features/recording-viewer/model/continuous-timeline.ts · apps/web/features/recording-viewer/model/recording-at.ts · apps/web/features/recording-viewer/model/use-initial-recording-seek.ts · apps/web/features/recording-viewer/model/use-recording-player.ts · 외 6개