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

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

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

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

당일 반영된 PPI 변경사항

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

#1331 chore: Dev 배포 폼에서 recorder 입력을 빼고 develop만 recorder로 고정한다

bulbanggae · 2026-11-17 19:12:01 KST

변경 기능
배포/인프라 · 녹화 recorder Dev 설정
영향받을 수 있는 사용자 흐름
Dev workflow 실행 → 브랜치 판별 → develop은 recorder/S3, 개인 브랜치는 legacy/off 설정
개선 기대
배포 폼 혼선을 없애고 공용 Dev의 녹화 설정을 일관되게 유지
회귀 위험
브랜치 판별 또는 조건식 오류 시 Dev recorder가 비활성화되거나 개인 Dev 자원 설정이 달라질 수 있음; staging·prod에는 직접 영향 없음
확인할 로그·지표
Dev Actions 결과, TF_VAR_recording_mode·recorder_sink, recorder EC2/S3 저장 상태
관련 테스트
dev-recorder-sink 및 dev-runtime-env-wiring 스크립트 테스트
당일 이슈 관련 가능성
당일 finalize 아카이브가 없어 기술이슈 signature와 직접 비교 불가; prod 수업 경로 변경 아님
배포 상태
Dev workflow 전용; prod 미배포 — 당일 운영 이슈 원인으로 연결 금지

주요 변경 파일: .github/workflows/dev.yml · scripts/dev-recorder-sink.test.mjs · scripts/dev-runtime-env-wiring.test.mjs

#1329 [PPI-1473] feat: 수업 녹화 링크 복사 추가

woooooji · 2026-11-17 17:24:41 KST

변경 기능
기타 UI/운영 · 수업 녹화 열람
영향받을 수 있는 사용자 흐름
직원 녹화 보기 → 현재 userId·lessonIndex로 수업 URL 생성 → 클립보드 복사 또는 수동 복사
개선 기대
수업 기록에 권한 경로를 유지한 녹화 링크를 빠르게 공유
회귀 위험
클립보드 권한 거절, 수업 변경 시 상태 초기화, URL 인코딩 오류로 잘못된 수업 링크가 복사될 가능성
확인할 로그·지표
녹화 보기 접근 오류, clipboard 실패 안내, recording route 403/404
관련 테스트
recording-link-copy 컴포넌트·Storybook 및 기존 recording service/proxy 회귀 테스트
당일 이슈 관련 가능성
당일 finalize 아카이브가 없어 직접 관련성 확인 불가; 수업 실시간 세션 경로는 변경하지 않음
배포 상태
병합 확인; 실제 운영 배포 시각 확인 필요 — 미배포 가능성

주요 변경 파일: apps/web/features/recording-viewer/ui/recording-link-copy.tsx · apps/web/features/recording-viewer/ui/recording-viewer-container.tsx · apps/web/features/recording-viewer/ui/recording-viewer.tsx · apps/web/features/recording-viewer/ui/recording-link-copy.test.tsx · apps/web/features/recording-viewer/ui/recording-link-copy.stories.tsx

#1328 feat: 체험 신청 완료 CAPI에 fbclid로 클릭 ID(fbc) 채우기

norununa · 2026-11-17 15:47:42 KST

변경 기능
기타 UI/운영 · 체험 전환 분석
영향받을 수 있는 사용자 흐름
체험 신청 요청 → _fbc 쿠키 우선 확인 → Referer fbclid 검증·fbc 생성 → Meta CAPI 전송
개선 기대
도메인을 건너온 광고 유입의 등록 완료 전환 측정 보강
회귀 위험
Referer 누락·형식 불일치 시 fbc가 계속 빠질 수 있고 잘못된 시간값은 전환 매칭 품질에 영향 가능
확인할 로그·지표
Meta CAPI 응답, CompleteRegistration fbc 포함률, free-trial API 지연·오류
관련 테스트
meta-capi server 및 free-trial route 테스트
당일 이슈 관련 가능성
정규 수업 S3 로그와 직접 관련 없음
배포 상태
병합 확인; 실제 운영 배포 시각 확인 필요 — 미배포 가능성

주요 변경 파일: apps/web/lib/meta-capi.server.ts · apps/web/lib/meta-capi.server.test.ts

#1327 fix: 직원 로그아웃 후 자동 재로그인 방지

DavidLee0611 · 2026-11-17 17:01:13 KST

변경 기능
인증/권한 · 진행자 진입
영향받을 수 있는 사용자 흐름
직원 로그아웃/세션 만료 → 로그인 UI → 명시적 버튼 제출 → Google 계정 선택 → 안전한 내부 경로 복귀
개선 기대
남아 있는 Google 세션으로 의도치 않게 자동 재로그인되는 동작 방지
회귀 위험
proxy의 세션·복귀주소 분기 오류 시 직원 하위 경로가 로그인 루프에 빠지거나 원래 화면으로 복귀하지 못할 수 있음
확인할 로그·지표
staff OAuth start 요청률, 로그인 redirect loop, proxy 401/redirect, returnTo 값
관련 테스트
staff page/login/proxy/dev broker/blocked UI 관련 Vitest 및 Storybook
당일 이슈 관련 가능성
당일 finalize 아카이브가 없어 진행자 로그와 직접 비교 불가; 아동 수업 세션 자체는 변경하지 않음
배포 상태
병합 확인; 실제 운영 배포 시각 확인 필요 — 미배포 가능성

주요 변경 파일: apps/web/app/main/staff/page.tsx · apps/web/app/login/page.tsx · apps/web/components/sections/staff-login.tsx · apps/web/proxy.ts · apps/web/app/api/staff/google/start/route.ts

#1326 fix: VP 프롬프트 테스트 대화 로그 저장

DavidLee0611 · 2026-11-17 15:14:53 KST

변경 기능
AI 세션/음성 인식 · 수업 진행/완료/저장
영향받을 수 있는 사용자 흐름
VP 프롬프트 테스트 대화 → transcript와 당시 세션 context 고정 → /api/session-logs 순차 저장
개선 기대
화면에만 남던 VP 테스트 대화를 선택 사용자·회차·활동·step에 영구 저장
회귀 위험
10초 timeout·저장 실패가 비차단이라 로그 누락이 조용히 발생할 수 있고 잘못된 context snapshot은 다른 step에 귀속될 수 있음
확인할 로그·지표
terra session log writer error, /api/session-logs 실패·지연, 화면 transcript와 저장 건수/ID 대조
관련 테스트
terra-session-log writer, prompt-test Terra 흐름, session-log-api 계약 테스트
당일 이슈 관련 가능성
당일 S3 finalize 아카이브가 없어 logger·이벤트 직접 일치 확인 불가; 일반 아동 수업보다 프롬프트 테스트 경로 변경
배포 상태
PR 설명상 Prod 적용 없음; 미배포 가능성 — 당일 운영 이슈 원인으로 연결 금지

주요 변경 파일: apps/web/components/pages/prompt-test.tsx · apps/web/lib/prompt-test/terra-session-log.ts · apps/web/lib/prompt-test/terra-session.ts · apps/web/lib/session-log-api.ts · apps/web/components/pages/prompt-test.terra.test.tsx

#1321 feat: 바로체험 해외 연락처 국가 선택과 번호 검증 지원

DavidLee0611 · 2026-11-17 13:27:03 KST

변경 기능
기타 UI/운영 · 바로체험 가입
영향받을 수 있는 사용자 흐름
보호자 국가 선택·현지 번호 입력 → libphonenumber 검증·E.164 변환 → free-trial API → 기존 아동 세션 진입
개선 기대
해외 보호자가 올바른 국제번호로 바로체험을 신청 가능
회귀 위험
국가/번호 불일치나 라이브러리 판정으로 유효 번호가 거절되거나 기존 국내번호 재접속 키가 달라질 가능성
확인할 로그·지표
free-trial 4xx·등록 성공률, 국가별 번호 검증 실패율, 기존 계정 재접속 성공률
관련 테스트
trial experience UI/Storybook, local-trial, trial-phone, free-trial route 테스트
당일 이슈 관련 가능성
정규 수업 S3 로그와 직접 관련 없음
배포 상태
병합 확인; 선행 API 국제번호 지원과 실제 운영 배포 확인 필요 — 미배포 가능성

주요 변경 파일: apps/web/components/local-trial/trial-experience.tsx · apps/web/lib/trial-phone.ts · apps/web/lib/local-trial.ts · apps/web/app/api/free-trial/route.test.ts · docs/immediate-trial.md