🎬 영상 기획 AX

패키지부터 결과까지 한 흐름으로 확인합니다. 기준·테스트 도구는 보조영역에 보존했습니다.
기준 원장 확인 중
개발 도구 · 투입 파일/피드백 확인 본 분석 아님 · 필요할 때만 펼침
TEST MODE · ONE CLICK RUN

테스트 실행 허브

입력할 것 없음. Downloads\weolbu ax 결과물 폴더를 자동으로 읽고, 영상·교재·커리큘럼·고객 정의 재료 목록만 확인합니다. 실제 Main 테스트 실행은 이 보조영역에서만 제공합니다.
투입함
Downloads\weolbu ax 결과물
실행 방식
원본 보존 · 임시 샘플 복사
진행판
아래에 실시간 표시
LEARNING LOOP CHECK
피드백 반영 검증
저장된 피드백이 다음 분석 프롬프트에 어떻게 들어가는지, B 스탠다드보완 적용을 카드로 비교합니다. 기본은 저장 없이 안전 검증입니다.
패키지 먼저 · 영상 넣기 전 준비

영상 패키징

영상 넣기 전 패키지를 만들거나 불러오고, 불러온 패키지는 바로 분석 시작 단계로 이어집니다.
기존 패키지 목록 0개
강의명 추가/수정/삭제
보통 1~2개월 선택 · 예: 5월 또는 5, 6월
강의명과 기간 선택 대기
패키지 먼저 만들기 또는 기존 패키지 불러오기 가능 · 업로드 후에는 파일명 기반 후보를 자동으로 제안합니다.
선택 설정 열기 · 즉석/패키지 분석 모드 현재: 즉석 분석 가능
ANALYSIS ENTRY

분석 진입 모드

패키지 없이 올리면 즉석 분석으로 제작PD 공정재감만 바로 봅니다. 패키지를 선택하면 같은 분석 결과가 패키지 저장함에 누적되고, 강사 복기는 기존 결과를 재사용해 별도 생성합니다.
현재: 즉석 분석 가능

업로드

영상·교재·텍스트·업무 문서를 한 번에 넣습니다. 파일 유형으로 1차 구분하고, AI가 들어갈 패키지/강의/일하는 방식 후보를 보여준 뒤 적용합니다.
영상/음성강의명·강차·강사·파트 추론 → 영상 분석 후보
PDF/PPT교재·강의자료 후보 → 어느 패키지/강의인지 분석
TXT/문서본문 preview 해석 → 고객 정의/중요 명령/일하는 방식 후보
표/기타업무 일정·운영표 후보 → 확인 필요로 분리
📥
영상·교재·텍스트·업무 문서를 드래그하거나 클릭해서 업로드
MP4/MOV/MKV, MP3/WAV, PDF/PPT/PPTX, TXT/MD/DOCX, CSV/XLSX 지원 · 한 번에 여러 파일 가능
영상은 분석 후보로, 문서는 AI 분류 후보로 먼저 보여주고 적용 전 확정하지 않습니다.
AI 분류 후보
파일을 바로 저장하지 않고, 들어갈 패키지와 자료칸을 먼저 보여줍니다. 맞으면 적용, 애매하면 패키지 불러오기/수정 후 다시 확인합니다.

이번에 넣은 파일

AI 판단

📌 처리 대기열

🕑 이전 작업 불러오기

처리 중...

02   전사 진행

준비 중...

03   영상별 스크립트

작업 현황

AI 분석 결과

🛒 0개 선택
패키지 자료 관리

자료 관리

실제 원본 삭제 없이 패키지 표시와 대표 기록만 정리합니다.
영상 표시 정리

📦 영상 기획 AX 시작

weolbu AX → 영상 기획 AX. 영상 분석이 메인이고, 강의 복기미팅은 이 패키지 안에서 파생되는 하위 업무입니다.

1단계 · 패키지 불러오기/정의하기

분석이 끝난 뒤 포장하는 단계가 아닙니다. 패키지를 만드는 순간부터 강의·차수·강사·VOC·만족도·OCR·공정재감 자료가 이 패키지 안에 누적되고, 저장·백업이 시작됩니다.
백업 시작점
① 기존 패키지 불러오기
진행 중인 영상 기획 패키지를 이어서 작업
② 새 패키지 정의하기
정규강의명·과정 월 입력 즉시 로컬 저장
③ 자료 넣기
강의/차수/VOC/OCR/공정재감이 같은 패키지에 누적
④ 백업 상태 확인
로컬 저장 완료 · Supabase 백업은 테이블 연결 시 완료
-전체 패키지
-진행 중
-완성 후보
-보관함

새 패키지 정의하기

여기가 작업의 시작점입니다. 빈 패키지만 만들어도 즉시 로컬 저장이 시작되고, 이후 VOC·만족도·OCR·제작PD·강사 복기 데이터가 같은 패키지 안에 누적됩니다.
대기 중

패키지에 강의·주차·강사·차시 넣기

대기 중

선택 데이터 붙이기

대기 중

회의록 raw 넣기

회의록 원문을 붙이면 조건칩에 맞는 항목은 위에 우선 선별하고, 전체 나열도 함께 남깁니다. 기본 조건은 제작PD · 영상 · 토니입니다.
대기 중

패키지 내부 현황판

패키지를 불러오는 중...

보관함

보관된 패키지를 불러오는 중...

📂 분석 결과 불러오기

📖 빠른 참조 서버 켜기 / 끄기 / 긴급 명령
🚀 시작
서버 켜기 (택 1):
· 바탕화면 start_server.bat 더블클릭
C:\Users\user\AppData\Local\Programs\Python\Python313\python.exe -m uvicorn main:app --host 0.0.0.0 --port 8000
Claude Code 켜기 (복붙 2번):
cd C:\Users\user\Documents\video-transcriber
claude
🏁 종료 / 긴급
종료: 각 터미널 창 Ctrl+C
포트 점유 시 (복붙 2번):
netstat -ano | findstr ":8000"
Stop-Process -Id [PID] -Force
안전 복귀:
git checkout v2.2-final

결과 확인

결과 확인 운영판
완료 결과만 보는 곳이 아니라 이어서 볼 작업, 피드백 반영, 오류/삭제까지 함께 정리하는 작업 운영판입니다.

📊 요약 대시보드

데이터를 불러오는 중...

이어서 볼 작업

작업 상태를 불러오는 중...
전사만 끝난 작업은 `이어서 분석`, 결과 없는 실패만 `삭제 추천`으로 표시합니다. 원본 파일명은 상세를 펼칠 때만 봅니다.

피드백 반영 현황

저장된 피드백이 다음 분석 기준에 실제로 들어갔는지 여기서 확인합니다.
결과 확인 안에서 피드백 반영 상태를 볼 수 있게 이동했습니다.
기존 별도 이동 화면 대신 결과 확인 안에서 피드백 반영 여부를 확인하는 탭입니다.

오류/삭제 관리

결과가 하나도 없는 실패만 오류로 보고, 중복/개발 테스트 의심 작업은 삭제 후보로 따로 판단합니다.
삭제는 원본 영상 삭제가 아니라 AX 작업 기록 정리 기준으로 다룹니다. 원본 투입함은 건드리지 않습니다.
0개 그룹 선택됨 Ctrl·Shift 클릭 / 드래그로 선택
📊 정리된 뷰
불러오는 중...
weolbu AX → 영상 기획 AX → 일정 관리

📅 일정 관리 AX

다운로드했던 강의 일정 관리 시스템 기능을 AX 안으로 옮겼습니다. CSV/XLSX/엑셀 복붙을 넣으면 촬영·편집·수정편집·라이브·업로드를 분류하고 테디/토니 R&R·공수를 계산합니다.

총 일정0
테디 공수0
토니 공수0
균형도-
확인 필요0
원본 연결원본 확인 전

자료 넣기

📂
CSV/Excel/TXT 파일 선택 또는 드래그드롭
첨부 index.html 기능 기준 · .csv/.xlsx/.xls/.txt 지원
───── 또는 ─────

엑셀에서 복사하여 붙여넣기

입력 대기 중

확인 필요/리스크

분석 후 담당자 미정, 라이브 겹침, 휴무 충돌, 공수 과중을 보여줍니다.

연결

1순서: 강의 커리큘럼 시트를 API로 읽고, 오늘 기준 AX 초안 캘린더를 만듭니다. 원본 시트는 수정하지 않습니다.

강의 커리큘럼 시트불러오기 전
제작PD 시트불러오기 전
아직 불러오지 않았습니다. 버튼을 누르면 샤샤 탭과 제작PD 캘린더를 읽고 AX 초안을 생성합니다.

Google Calendar 리소스

토니/최현제/테디/스튜디오/회의실 후보 이벤트를 읽고, 촬영 일정 카드 상세에 구캘 근거를 연결합니다. 읽기 전용입니다.

아직 읽지 않았습니다. 버튼을 누르면 Google Calendar 리소스 후보를 가져옵니다.

원본 시트형 보기

선택한 커리큘럼/제작PD 탭을 날짜 열과 행 카테고리 구조로 다시 봅니다. 원본은 수정하지 않습니다.

제외한 일정

원본은 삭제하지 않고 리소스 캘린더 화면에서만 숨긴 일정입니다.

검수판

AX가 분류한 이유를 보고 포함/숨김/보류로 확정합니다. 숨김은 삭제가 아니라 캘린더 표시 여부입니다.

오분류 스캔 / AI분석 후보

돈버는독서모임, 본/예 표시 누락, 콘텐츠팀/클래스팀 키워드, 담당 미정 같은 후보를 삭제 없이 제안합니다.

스캔 버튼을 누르면 오분류 후보와 추천 액션을 보여줍니다.
일정 설정
콘텐츠팀/클래스팀/보류/숨김 키워드와 R&R, 공수, 반복 일정 규칙을 관리합니다.

불러올 탭 체크

커리큘럼/제작PD 링크를 저장하고, 각 링크 안에서 캘린더에 반영할 탭을 여러 개 체크합니다.

설정 구분 표 동기화

토니/테디 R&R, 공수, 필터 정책을 로컬 AX에서도 표로 보고 수정합니다. 저장하면 Google Sheet 설정 탭과 같은 7열 표로 동기화됩니다.

분류 규칙

색상은 쓰지 않고 텍스트/행/강의명/키워드로만 분류합니다.

R&R/은어 기준

강의명/은어/강사 예외를 수정하면 다음 분석부터 자동 분배 기준에 반영됩니다.

공수 기준

기본 편집은 1 또는 2로 바꿀 수 있고, 수정편집은 0.5로 둡니다. 오전/오후 단위 수정편집도 표시합니다.

반복 일정

매일/매주 고정 회의·책무회의·주간 일정을 기간 지정해서 캘린더에 반영합니다.

구글 연결 현황

연결 현황은 작게만 표시합니다. 마우스를 올리면 연결된 시트명을 확인할 수 있습니다.

상태 계기판

전사 · Gemini · 교재/OCR · 저장 상태
설정 탭을 열면 자동으로 확인합니다...
복구 상태 확인 전

🔑 Gemini API 키 관리

여러 키를 등록하면 429 일일 한도 초과 시 다음 키로 자동 전환됩니다. aistudio.google.com에서 발급.

📁 Google Drive 폴더 설정

Google Drive 폴더 URL 끝부분 ID를 입력하세요

🔗 스프레드시트 연결 상태 & 미리보기

미확인

🤖 프롬프트 설정

현재 프롬프트 (스프레드시트 > 프롬프트설정 시트에서 수정):
📚 강의명 인식 목록
쉼표로 구분

🔒 비밀번호 변경

스프레드시트 프롬프트설정 시트의 admin_password 행에 저장됩니다

🧹 캐시 정리

화면에 이상한 데이터(자른구간, 오래된 작업)가 표시될 때 로컬 캐시를 지우세요.
localStorage 전체 초기화 후 페이지 새로고침

📦 데이터 관리

대시보드 데이터를 일괄 정리합니다. 영구 삭제 후에는 복구할 수 없습니다.
🧪 베타 기능 — 디벨롭 중. 사용 중 짚는 사항 알려주면 개선됩니다.

🔍 프롬프트 정리

불러오는 중...
🧪 베타 기능 — 디벨롭 중. 사용 중 짚는 사항 알려주면 개선됩니다.

📝 학습 데이터 공장

분류
카테고리
📂 영상 또는 텍스트 파일 드래그 & 드롭
영상(mp4/mov 등) → 자동 전사 후 입력 / txt·md → 내용 바로 입력
⚙️ 처리 상태
⏳ raw 수집 ⏳ AI 분류 ⏳ 시트 저장 다음 분석부터 자동 반영
📊 누적 현황 (최근 10개)
불러오는 중...
🧪 베타 기능 — 디벨롭 중. 사용 중 짚는 사항 알려주면 개선됩니다.

🎯 방향성 하네스

회의 raw → AI 정리 → 시트 반영
📋 회의 정보
📝 raw 발화 입력
📜 정책 변천사
버튼 눌러서 불러오기

🎯 업무 하네스

RAW 명령 → 확인 질문 → 업무 프로세스 원장 → AX 캘린더/외부 동기화 대기

영상 분석 기준 관리

공정재감·피드백·프롬프트 원장을 확인하고 다음 분석 기준에 반영되는지 관리합니다.
🧠 영상 분석 기준 상세 보기 영상 분석 계열 기준만 표시 · 양식 계열 기준 제외 · 실제 분석 프롬프트 주입 지도 · prompt_learning 원장
영상 분석 기준 상세판
영상 분석에 쓰는 공통 체크 기준과 예시만 보여줍니다. 양식 작성 기준은 이 화면에서 숨깁니다.
열면 현재 기준을 불러옵니다.
영상 분석 기준 관리
영상 분석 품질을 좌우하는 기준판입니다. 피드백 반영 확인, 기준 후보, 프롬프트 원장, 공정재감 기본 기준을 여기서 확인합니다. 실제 영상 실행 버튼과 분리해 기준만 관리합니다.
자동 분류 모드가 기본입니다
목실감 작성 피드백처럼 공감/정보/재미/감동에 바로 안 들어가는 raw도 먼저 ⚡ 자동 분류로 넣으면 됩니다.
AI가 영상 분석 / 양식 작성 / 업무 일정 / 하네스 지식으로 알아서 나눈 뒤, 토니 컨펌 후 Supabase에 반영합니다.
기존 학습 흐름도 유지: raw 입력 → AI 정리 → 토니 피드백/재정리 → 컨펌 → Supabase 반영
기준판은 criteria/좋은예/나쁜예/prompt_learning/실제 주입 여부를 한 번에 보여줍니다
🎬 영상 관련 전체 기준판 · 공감/정보/재미/감동/예시/추가학습/주입지도
버튼을 누르면 현재 영상 기준판을 불러옵니다.
학습 진단 대기 중
🧩 업무 프로세스
RAW에 “CX/PD 책무회의 6월 11일 목요일 11:30~12:00로 변경”처럼 넣으면, 기존 일정을 바꾸려는지 확인 질문을 만든 뒤 확답 시 AX 원장에 반영합니다.
기본 업무: 매일 가중목 회의 · CX/PD 책무회의
RAW 일정 명령
AX 캘린더 업무표
구글 캘린더·노션 동기화 대기
🧠 오늘 뽀갤 3개: 목실감 역설계 + RAW 통합 분류 + 텍스트 덤프 분석
실제 목실감 양식을 주면 자동화에 필요한 고정값/유동값/필수 질문을 역으로 뽑고, 강사 복기 미팅·가중목 회의·목실감 프로세스 변경이 섞인 RAW는 씽크업 카드로 분리합니다. 1000~2000자 텍스트 덤프는 저장 위치와 분석 수준까지 바로 판정합니다.
확정 전 씽크업 단계
목실감 실제 양식 역설계
RAW 통합 분류
텍스트 덤프 분석 하네스
강의 영상/복기 raw를 1000자든 2000자든 붙여넣으면 공정재감·저장 위치·누적 수준을 판정하고 로컬+Supabase 후보로 보관합니다.
저장: harness_history + prompt_learning + local JSON
하네스/영상 분석 누적 현황
Supabase prompt_learning·harness_history와 로컬 텍스트 덤프 백업을 한 번에 확인합니다.
아직 안 불러옴
카테고리 선택
목실감/가중목/영상 피드백 등 raw를 넣으면 AI가 영상·양식·일정·하네스 지식으로 알아서 나눕니다
raw 입력
적용 축
📂 텍스트 파일 드래그 & 드롭 (선택사항)
카테고리와 공정재감 축을 먼저 고른 뒤 raw를 붙여넣고 AI와 정리 → 최종 합의본만 업데이트합니다.
⚙️ 처리 상태
⏳ raw 수집 ⏳ AI 정리/재정리 ⏳ Supabase 저장 → 다음 분석부터 자동 반영
🧭 AI 학습 명령 흐름
입력한 피드백이 어떤 API와 저장소를 거쳐 다음 분석 프롬프트에 들어가는지 보여줍니다
불러오는 중...
📜 정책 변천사 운영판
목실감/가중목/강사 복기/양식 기준을 불러오기·적용·보류·삭제합니다
불러오는 중...
🧠 Supabase 학습 규칙 운영판
지금 AX가 읽는 prompt_learning 이력과 적용 상태를 확인합니다
불러오는 중...
📊 누적 현황 (최근 10개)
불러오는 중...
🧪 베타 기능 — 디벨롭 중. 사용 중 짚는 사항 알려주면 개선됩니다.

📈 도메인 학습 데이터

도메인별 분석 현황
불러오는 중...
강의 평가 기준 현황 Google Sheets "강의평가기준" 탭에서 직접 편집
불러오는 중...

⚙ 강의 평가 기준 관리

강의 타이틀별 평가 기준을 등록하세요. 등록된 기준은 영상 분석 시 자동 적용됩니다.
Google Sheets "강의평가기준" 탭에서 직접 편집 가능합니다.
+ 평가 기준 추가/수정
불러오는 중...

🗂️ 데이터 운영판

분석 결과와 저장소 상태를 한곳에서 확인함

🧭 저장소 운영 상태

Sheet와 Supabase가 같은 내용을 들고 있는지 확인함
저장소 상태 확인 전

🎯 하네스 반영 상태

raw 입력이 어느 대상에 업데이트됐는지 확인함
하네스 상태 확인 전
불러오는 중...

📖 시스템 매뉴얼

🚀 A. 시스템 시작

1. 서버 켜기
가장 쉬운 방법: 바탕화면 start_server.bat 더블클릭
또는 PowerShell에서 복붙 2번:
cd C:\Users\user\Documents\video-transcriber
C:\Users\user\AppData\Local\Programs\Python\Python313\python.exe -m uvicorn main:app --host 0.0.0.0 --port 8000
성공 시: INFO: Started server process [숫자] 메시지 뜸
브라우저: http://localhost:8000
2. Claude Code 켜기
새 PowerShell 창 열고 복붙 2번:
cd C:\Users\user\Documents\video-transcriber
claude

🏁 B. 시스템 종료

서버 끄기: 서버 실행 중인 PowerShell 창 → Ctrl+C
Claude Code 끄기: Claude Code 실행 중인 터미널 창 닫기

💻 C. 자주 쓰는 명령어 (복붙용)

C-1. 자동 테스트 실행
가장 쉬운 방법: 바탕화면 run_tests.bat 더블클릭
python -m pytest tests/regression/ -v --tb=short
C-2. 서버 재시작
서버 PowerShell 창에서 Ctrl+C → 바탕화면 start_server.bat 더블클릭
C-3. 포트 점유 시 (서버 안 뜸) — 복붙 2번
netstat -ano | findstr ":8000"
→ 출력된 마지막 숫자(PID) 확인 후:
Stop-Process -Id [PID 숫자] -Force
→ 다시 start_server.bat 더블클릭
C-4. 안전 복귀 (사고 시)
git checkout v2.5-final
→ 더 옛날 버전: v2.4-final  /  v2.3.1-final  /  v2.2-final  /  v1.4-final  /  v1.1-final

🆘 D. 흔한 사고 + 해결

"각 소켓 주소는 하나만 사용" 에러
→ 포트 8000 이미 점유됨. 위 C-3번 명령 실행
start_server.bat 깨짐 / 실행 안 됨
→ 위 A-1번 PowerShell 명령으로 직접 서버 실행
브라우저 무한 로딩
→ F12 콘솔 확인 → 빨간 에러 있으면 Claude Code에 보고 → Ctrl+Shift+R 강력 새로고침
AI 분석 실패 — Not Found
→ 서버가 구버전으로 실행 중. 위 C-2번 서버 재시작

🛡️ E. 안전망 현황 (사고 시 어느 시점으로 돌아갈지)

태그 내용
v2.5-final V2 UX 시정 동결 — 현재 최신 안전망
v2.4-final V2 2차 완전 동결
v2.3.1-final V2 1차 완성 + 전수 점검
v2.3-final V2 1차 완성
v2.2-final V2 2차 — 하네스+§23
v2.1-final V2 1차
v1.4-final V1 자동 테스트 인프라
v1.3-final V1 시트 감지 + 클립 포맷
v1.2-final V1 자유기획 + UX
v1.1-final V1 기본 동작
master 가장 보수적 안전선
📄 F. 보고서 작성 사용법 ▼ 클릭해서 펼치기
사이드바 📄 보고서 작성 탭 → 아래 순서로 사용
  1. 양식 선택 — 드롭다운에서 보고서 양식 선택. 처음엔 비어있음 → [+ 새 양식] 버튼으로 등록
  2. raw 입력 방식 선택 — 텍스트 직접입력 / 분석 결과 선택 / 회의록 파일(.txt/.md) 중 하나
  3. [🤖 보고서 생성] 클릭 — Gemini가 양식 구조대로 보고서 작성
  4. 결과 확인 + 저장 — [↺재생성] [📋복사] [⬇다운로드] [💾저장] 버튼 사용
저장한 보고서는 이력 섹션에서 클릭해서 다시 불러오기 가능 (최대 100건 보관)
📋 양식 관리 (V3 4차 신규)
  1. 보고서 작성 탭 상단 [📋 양식 관리] 버튼 클릭 → 인라인 패널 펼침
  2. 각 양식 카드에서 [편집] — 이름/구조/톤 등 수정 후 저장
  3. [복제] — 새 이름 입력 → 기존 양식 복사본 생성
  4. [삭제] — 확인 후 영구 삭제 (시트 + 로컬 JSON 동시 삭제)
⚡ F-2. 프롬프트 정리 원클릭 조치 사용법 ▼ 클릭해서 펼치기
사이드바 🔍 프롬프트 정리 탭 → 점검 실행 → 미적용 항목에서 조치
  1. [점검 실행] 버튼 → 7개 항목 자동 점검 (✅ 적용 / ❌ 미적용)
  2. ❌ 항목의 [⚡ 조치] 버튼 클릭 → 즉시 조치 모달 열림
  3. 시트 링크 버튼 — 해당 구글 시트 탭 새 창으로 열림 (직접 편집)
  4. 인라인 입력 폼 (분석기준·분석예시만) — 카테고리 + 내용 입력 후 [시트에 추가] 클릭
  5. 추가 완료 후 다시 [점검 실행] → ✅ 변경 확인
키콘텐츠 시트는 구조 상이로 인라인 입력 미지원 → 링크 버튼으로 시트에서 직접 편집
📈 G. 도메인 학습 데이터 사용법 ▼ 클릭해서 펼치기
  1. 사이드바 📈 도메인 학습 데이터 탭 클릭
  2. 도메인별 분석 현황 — 분석된 영상 수 + 평균 공정재감 점수 확인
  3. 강의 평가 기준 현황 — 시트에 등록된 기준 목록 확인
  4. ⚙ 평가 기준 관리 버튼 → 강의 타이틀별 평가 기준 추가/수정
  5. 등록 후 다음 영상 분석 시 해당 기준이 자동 주입
Google Sheets "강의평가기준" 탭에서 직접 편집도 가능 (시트 열어서 행 추가/수정)
⚙ H. 그룹 정의 + 교재 첨부 사용법 ▼ 클릭해서 펼치기
강의 기획 입력 (그룹 감지 단계에서)
  1. 새 분석 탭에서 업로드 → 그룹 자동 감지 후 그룹 카드 표시
  2. 그룹 카드의 [⚙ 그룹 정의] 버튼 클릭 → 그룹 정의 모달 열림
  3. 강의 타이틀 / 커리큘럼 / 고객 정의 입력 (모두 선택사항)
  4. 교재 파일(PDF/PPTX) 첨부 시 → Gemini OCR 추출 후 시트에 자동 저장
  5. 저장 후 다음 분석 시 기획 데이터 + 교재 내용이 자동 주입
교재 비교 (용도 B — 독립 기능)
  1. 사이드바 📐 강의 도구 그룹 → 📚 교재 비교 클릭
  2. 교재 1 (지난 기수) + 교재 2 (이번 기수) 각각 업로드
  3. 비교 시작 → 추가/삭제/변경 항목 자동 분석 + 결과 시트 저장
용도 A (분석 참고용 교재) vs 용도 B (교재 비교 전용)는 완전 분리됨
사이드바 구조 안내 (V3 5차 기준)
📹 영상 분석: 새 분석 / 분석 결과 / AI 진단 / AI 학습
📐 강의 도구: 교재 비교 / 공유용 정리
📋 결과 활용: 정리된 뷰 / 보고서 작성
📖 가이드: 사용 설명서 / 로드맵
BETA 배지: 디벨롭 중 기능 (분석 결과·AI 학습은 정식 기능)
⚙️ Claude Code 세션 시작/종료 절차 ▼ 클릭해서 펼치기
🚀 시작 5단계
  1. git status / git pull
  2. uncommitted 변경 확인
  3. 시트 최신 상태 확인
  4. HANDOFF.md 확인
  5. plan/프롬프트 작성
🏁 종료 5단계
  1. WIP 커밋
  2. HANDOFF.md 갱신
  3. 재개 위치 명시
  4. _scratch/ 30일 초과 정리
  5. git push (선택)

🔙 중단 후 복귀 방법

  1. 새 채팅 열기
  2. 첫 메시지: "프로젝트 인계. CLAUDE.md → DECISIONS.md → ARCHITECTURE.md → BACKLOG.md → HANDOFF.md 순서대로 읽고 작업 이어가자"
  3. HANDOFF.md "현재 멈춰있는 곳" 확인 → 이어서 진행
컨텍스트 한도 만나면 → 메모장에 복사 후 잠깐 쉬었다가 새 채팅

🗺️ 로드맵

📍 현재 위치

V2 시리즈 · 태그: v2.5-final (완전 동결) · V2 UX 시정 완성
최신 안전망: v2.5-final · 안전망 11겹 확보

✅ 완료 시안

V1 · v1.0-pipeline
방식 B 파이프라인 정상
분석 본 게임 통과
1차 시안 · v1.1-final
AI 자동 정리 시스템
학습 입력 인터페이스
정리된 뷰 탭
2차 시안 · v1.2-final
자유 기획 입력
세부내용 제거
UX 개선 8개
3차 시안 · v1.3-final
시트 자동 감지
클립 포맷 선택
큰 영상 타임아웃
4차 시안 · v1.4-final
자동 테스트 인프라
V2 진입 준비
V2 1차 · v2.1-final
버그 픽스 13개
매뉴얼·로드맵 3겹
§17-22 룰 신설
V2 2차 · v2.2-final
방향성 하네스 (AX 본질)
#13 그룹 삭제
#16 휴지통 30일
§23 작업 누락 차단
V2 3차 · v2.3.1-final
📄 보고서 작성
§11 자동 감지 강화
전수 점검 27/27 완료
V2 2차 시안 1단계 · v2.4-dev
사이드바 영상 분석 그룹화
그룹 삭제 모달 버그 픽스
§11 4차 강화
V2 2차 시안 2단계 · v2.4-dev
강의 기획 = 새 분석 통합 카드
기획 입력 모달 (선택사항)
강의기획 시트 자동 저장
V2 2차 시안 3단계 · v2.4-dev
분석 시 기획 데이터 자동 주입
3축 분석 (커리큘럼/고객/도메인)
전체 텍스트 다운로드
V2 2차 시안 4단계 · v2.4-dev
교재 비교 Gemini OCR
PDF/PPTX → 추가/삭제/변경 분석
교재비교 시트 자동 저장
V2 2차 시안 5단계 · v2.4-dev
그룹 vs 그룹 비교
대시보드 비교 모드 + 체크박스
그룹비교 시트 + 이력 카드
V2 2차 시안 6단계 · v2.4-dev
학습 사이클 + 공유용 정리
강의평가기준 시트 + 분석 주입
도메인 학습 데이터 페이지
하네스 영역 C 자동 연동
🏁 V2 2차 동결 · v2.4-final
강의 라이프사이클 OS 완성
기획→분석→비교→학습 통합
안전망 10겹 확보
270 tests passed ✅
🏁 V2 UX 시정 동결 · v2.5-final
강의 기획 입력 위치 이동
교재 용도 A/B 분리
강의 도구 사이드바 그룹
안전망 11겹 확보
277 tests passed ✅
🏁 V3 1차 동결 · v3.1-final
즉시 버그 픽스 + 명칭 직관화
BETA 배지 + 베타 페이지 배너
사이드바 툴팁 + 가이드 그룹
PDF 30페이지 자동 잘라내기
안전망 12겹 · 277 tests ✅
🏁 V3 2차 동결 · v3.2-final
AI 학습 자료 + 방향성 하네스 통합
카테고리 5종 동적 UI
nav-ai-learn 단일 진입점
안전망 13겹 · 281 tests ✅
🏁 V3 3차 동결 · v3.3-final
대시보드 디벨롭
다중 선택 + 드래그 삭제
회차/만족도/강사별 시각화
정리된 뷰 인라인 통합
안전망 14겹 ✅
🏁 V3 4차 동결 · v3.4-final
프롬프트 원클릭 조치 (⚡ 시트 링크+인라인 입력)
보고서 양식 CRUD (편집/복제/삭제)
양식 구성 미리보기 + 동적 입력
신규 API 5개 · 287 tests ✅
🏁 V3 5차 동결 · v3.5-final
AI 메타 UX 검토 완성
사이드바 재편 (결과 활용 그룹 신설 · AI 학습 그룹 편입)
BETA 정식화 (분석 결과 · AI 학습)
navigate() 레거시 정리
안전망 16겹 · 295 tests ✅
🚀 V4 1차 진행중 · v4.0-dev ← 현재
Supabase 안전 마이그레이션 1단계
supabase-py 클라이언트 박힘
16개 테이블 스키마 설계
시트 → DB 마이그레이션 스크립트
코드 변경 없음 · 대시보드 정상 유지

🔄 시스템 흐름도

업로드 ↓ Whisper 전사 (faster-whisper) ↓ _extract_candidates (후보 추출 · Gemini) ↓ _score_candidates (점수 산정 · Gemini) ↓ select_top5 → _prep_scored_segments ↓ Dashboard / 클립 분할 / Sheets 저장

📋 V2 2차 시안 — 토니 자연 피드백 기반 디벨롭

🏁 v3.2-final 동결 완료 — V3 2차 AI 학습 통합
  • ✅ 사이드바 "영상 분석" 그룹화 + 그룹 삭제 모달 버그 픽스 + §11 4차 강화
  • ✅ 분석 시 기획 데이터 자동 주입 + 3축 분석 + 텍스트 다운로드
  • ✅ 교재 비교 Gemini OCR (PDF/PPTX → 추가/삭제/변경 + 시트 저장)
  • ✅ 그룹 vs 그룹 비교 + §15 AT 4단계 영구 차단
  • ✅ 학습 사이클 + 공유용 정리 + 하네스 영역 C 자동 연동
  • ✅ UX 시정: 강의 기획 위치 이동 + 교재 용도 A/B 분리 + 강의 도구 그룹
  • ✅ V3 1차: 명칭 직관화 + BETA 배지·배너 + 툴팁 + PDF 개선 + 가이드 통합
  • ✅ V3 2차: AI 학습 자료 + 방향성 하네스 → 단일 AI 학습 페이지 통합 (v3.2-final 동결)
안전망 13겹 · 현재 위치: v3.2-final · 복귀선: v3.2-final

⚖️ 핵심 의사결정 기록

TOP 5 (TOP 10 아님) — 결과 집중도 유지
잘린 클립 재생 (원본+시작점 이동 아님) — 공유 편의
영상별 독립 폴더 (공용 폴더 아님) — 데이터 격리
방식 B 파이프라인 (방식 A 아님) — 품질 + 일관성
토니=raw 입력, AI=정리 100% — 근본 원칙 (변경 불가)
전체 목록 → docs/DECISIONS.md

📄 양식 작성

양식 선택 → raw 입력 → AI 생성
양식 작성은 3대 이벤트의 2번 출입구입니다.
영상 분석 결과, 회의록, raw 텍스트를 선택한 양식에 맞춰 목실감·가중목·만족도 복기·강사 강의 복기로 정리합니다.
1. 업무 선택
업무를 고르면 아래 양식 선택과 연결됩니다.
양식 작성 흐름
1 업무 선택 2 결과 확인 3 피드백 4 수정본 최종
📋 양식 선택
📝 raw 입력
📊 보고서 이력
버튼 눌러서 불러오기
📌 양식 작성 적용 기준 보기 목실감/양식 계열만 표시
영상 분석 기준과 분리했습니다. 여기에는 목실감/가중목/양식 작성 계열 Supabase 적용 규칙만 표시됩니다.
열면 양식 기준을 불러옵니다.

📋 그룹 정의

기획 입력 → 분석 시 자동 활용
📂 기존 기획 불러오기
🏷️ 강의 타이틀 (영역 5 — 평가 기준 분류 키)
같은 타이틀 강의 여러 기수 → 학습 데이터 통합
📚 커리큘럼 (영역 2 — 차시 vs 목차 매칭)
👤 고객 정의 (영역 4 — 소구 평가 기준)
저장 시 Google Sheets "강의기획" 탭 자동 생성 + 누적. 같은 타이틀 = 덮어쓰기.
📋 저장된 기획 목록
↺ 버튼으로 불러오기