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건. 병합 시각만으로 배포 완료를 단정하지 않습니다.
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
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
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
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
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
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