문서 검증·불일치·남은 실행 확인

기능 마스터 · 기존 문서 전체 원장

문서 작업에서 확인한 코드·실행 결과·미확인 항목을 관리합니다. 작업은 codex/product-feature-docs의 별도 worktree에서 진행했습니다.

확인 수준

표기	뜻
코드 대조	실제 화면의 조작에서 상태·SDK·API·입력 검증·저장 경로까지 확인
참고 화면·측정	저장소에 이미 있던 자료를 읽고 현재 설명과 차이를 표시. 새 실행 아님
새 로컬 실행	이번 작업에서 해당 리비전을 실행해 직접 확인한 구체적 경로
미확인	적절한 계정·조직·DB·외부 연동 또는 기기 조건으로 실행하지 않은 경로

신규 기능 24개 문서의 대부분은 코드 대조입니다. 전체 역할·기기·경로를 실제로 사용해 검증한 매뉴얼이라고 표시하지 않습니다. 개발·기록 문서 4개는 규칙·과거 측정·운영 참고의 연결입니다. 외부 동기화 사양과 정책 문서의 모든 내용을 현재 법령·운영 환경으로 재검증한 것은 아닙니다.

기존 설명에서 정정한 내용

기능	기존 설명과 현재 코드의 차이	반영 위치
메뉴	2026-05 계획 경로·메뉴와 현재 LNB가 다름. 해시 없는 루트는 마지막 탭 복원	현재 메뉴 구조와 관리자 기능 문서
급여 시트	현재 HR 주화면은 워크북. 기존 별도 급여대장·요약 탭 설명은 현재 진입과 다름	HR 소개·가이드 원본·급여 시트
명세서	sendToEmployee는 공개 시각·작성자 저장. 메일/SMS/전자서명 발송을 보장하지 않음	급여 배포·직원 가이드
근무표	AI 생성 버튼 비활성, 직원 희망 UI 숨김. 관리자는 설정 조건 아래 대리 입력	스케줄러 소개·원본·기능 문서
근무표 편집	Delete/Backspace는 칸 지우기이며 도움말의 OFF 배정과 차이	스케줄러 현재 사용·제약
직원 휴가	대기 신청 취소 조작 존재. 기존 '취소 불가' 설명과 다름	직원 가이드 원본·근태·휴가
직원 내 정보	전화·OTP 읽기 전용과 관리자 편집 화면의 차이, 사진 등록 두 경로	직원 내 정보·원본 가이드
조직 설정	Organization 및 settings JSONB 소유이며 과거 organization_parameters 설명과 다름	관리자 소개·조직 설정
총무	관리자 메뉴는 공지만 활성. 교육·반복 업무는 준비 중이며 직접 경로와 구분	총무 소개·원본·기능 문서
재고	활성·유효기간 일부 필터는 API에만 있음. 반품은 후보 표시, 처리 워크플로 아님	재고 소개·원본·기능 문서
경영	청구 금액은 RevenueEntry 서버 저장, 기본 상시 데모/localStorage 설명과 다름	경영 소개·원본·기능 문서
모듈 매니저	테스트 조직 생성 기능 없음. 현재 조직의 월 급여 집계 호출이며 선택 모듈 단독 실행 아님	앱 소개·기능 문서
임포터	32개 등록 탭, 고정 기간과 부분 필터 제약. 모든 47개 시트 자동 이관 보장 삭제	소개·원본 도구 가이드·기능 문서
드라이브	한 번 클릭 미리보기, 댓글 저장 미구현, 상단 폴더 권한 관리 추가	신규 기능 문서
AI	이력·도킹·오류 시 메시지 보존의 실제 동작. 평가 메서드는 있지만 평가 버튼 없음	신규 기능 문서
메신저	직원 앱과 위젯의 검색·방 진입 경로가 다름. 채널 행 열기 미연결, 필수 팀방의 위임 후 퇴장 제약	신규 기능 문서
신고	내 신고 최신 20건·공개 답변, 취소 API는 있지만 사용자 위젯 버튼 없음	신규 기능 문서
시스템 관리자	현재 도구 위치와 9개 LNB, 계정 기반 관리자 생성. 첫 로그인 변경 강제 보장과 차이	콘솔 소개·기능 문서

위 차이 중 제품 결함은 문서에 현재 상태를 기록했으며 제품 코드를 수정하지 않았습니다. 문서 수정과 기능 결함 해결을 혼동하지 않습니다.

확인이 필요한 실제 구현 제약

경로	확인한 제약·후속 검증
일반 인센티브 /incentives 추가	UI가 필수 category/totalAmount를 보내지 않아 스키마 거절 가능. 메뉴의 /treatment와 구분
계약 연결 시트 행 삭제	삭제 확인 전에 계약 비활성화 Promise가 시작되는 경로가 있어 취소가 무변경을 보장하지 않음
급여 확정 취소	API의 undefined 필드 갱신·기존 sentAt 유지 때문에 명세서 비공개 복귀를 추정하지 않음
외근 승인	출퇴근 반영은 best-effort여서 승인 성공과 근태 동기화 성공을 따로 확인
연차촉진 완료 내역	일부 버튼이 실제로 통지 폼을 여는 연결. 버튼 이름만으로 완료 상세라고 설명하지 않음
임포터 필터	grades/education/settlement/resignation 단독 실행이 상위 분기를 통과하지 못함. 현재 고정 귀속 기간·부분 저장·행 교체 확인 필요
랜딩 푸터	관리자 바로가기가 문서 빌드 제외 페이지 getting-started를 가리킴. 실제 관리자 접속 경로로 안내하지 않음
정산 원천	교육·연말·퇴직 전용 CRUD 화면은 현재 미연결. 연말 원천 셀 writer·퇴사 추가 수당의 요약 반영·취소 API 삭제 범위 제약을 인사 기록 문서에 명시
모듈 테스트	CONFIRMED가 없으면 해당 기간 기존 급여를 상태 필터 없이 삭제·재생성. 초안만 바뀌는 안전한 테스트라고 설명하지 않음
플랫폼 콘솔	일부 조작의 endpoint 전달 누락, CS 최신 30건·페이지 없음, 재오픈 사유 입력 미연결 등 콘솔 문서의 제약 확인
알림 푸시	신고 ID 전달 누락 등 벨·앱 목록과 다른 경로의 차이를 실제 기기에서 확인 필요

새 실행과 미확보 화면

정리에서 실행한 제품 경로는 로컬 공개 랜딩의 데모입니다. 추가한 앱별 실행은 아래 촬영 기록에 구분합니다. 「AI 근무표」 탭 선택·생성 후 N/D/E/휴 셀, 제약 3건 반영, 생성 완료 상태를 확인했습니다. 새 캡처는 생성 전 화면입니다. 상담 전송은 실행하지 않았습니다.

드라이브·신고의 번호·화살표 안내는 기존 캡처에 문서 UI로 표식을 추가한 것입니다. 원본 픽셀과 UI 결과는 바꾸지 않았습니다. 급여 영상도 저장소에 이미 있던 녹화입니다. 저장 완료·다른 사용자 접근·실기기 푸시를 새로 검증한 자료가 아닙니다.

필요한 실행 세트	아직 확보하지 못한 장면·이유
로그인·초대·워크스페이스	계정/메일/OTP·다른 역할 진입·조직 전환. 해당 테스트 인증 환경 미확보
직원·급여·공제·마감·명세서	저장 후 재진입·부분 실패·반영·확정·공개·취소·직원 화면 대조. 현재 기준 DB와 역할별 테스트 데이터 미확보
근태·휴가·결재·연차촉진	직원 신청에서 관리자 승인/반려·취소·촉진 통지/서명까지. 실제 데이터·외부 전달 실행하지 않음
근무표·인센티브	드래그·되돌리기·게시·대리 희망·환자 수·실제 인센티브 추가/승인. 테스트 조직에서 녹화 필요
총무·재고·경영	공지 확인과 대리 확인, 수량 변경, 청구 저장·취소 후 재진입. 테스트 조직과 데이터 미확보
드라이브	업로드 전후·파일 중간 실패·역할별 접근·링크 폐기·폭 드래그. 새 실행 계정 미확보
알림·메신저·AI·신고	다른 사용자/기기와 수신·회신·대화·도킹·신고 가림 및 접수 완료. 다중 세션·연동 실행하지 않음
임포터·플랫폼 콘솔	격리 DB 이관·부분 실패 복구·관리자 변경·외부 연동. 데이터 변경 작업 실행하지 않음
FE 성능	같은 데이터·장비·CPU·네트워크·캐시의 전후 trace·영상. 이번에는 과거 측정만 정리

새로운 실행 결과가 확보되면 해당 기능 절차의 캡처를 교체하고 이 표에 역할·실제 확인 결과를 남기고 촬영 날짜·리비전은 원본 메타데이터에서 관리합니다. 코드 대조와 문서 빌드만으로 이 표의 미확인을 지우지 않습니다.

문서·저장소 검사

통합 결과입니다. Node 24.15.0, pnpm 11.21.0에서 실행했습니다.

검사	실제 결과와 확인 범위
pnpm build	성공. Turbo 23개 작업 모두 성공, 마지막 전체 실행 41.247초. 21개 작업은 캐시 재사용
pnpm --filter @hereby/docs build	옛 사양의 배포 제외 경로 10개를 고친 뒤 다시 성공. 클라이언트·서버 번들 및 정적 페이지 생성 확인
pnpm gen:docs-guides	8개 앱 가이드와 인덱스·온보딩을 합한 10개 페이지 생성. 변경은 HTML 원본에서 반영
pnpm lint:check	실패: 오류 56개, 경고 1,576개, 정보 2개. 오류가 있는 기존 문서 데모 컴포넌트 16개는 기준 커밋과 파일 내용이 모두 동일함을 SHA-256 및 직접 내용 대조로 확인
pnpm exec biome check docs/.vitepress/config.mts docs/.vitepress/theme/components/FeatureWalkthrough.vue	이번 문서 설정과 이미지 안내 컴포넌트 2개 파일 통과
Markdown·소스 경로 검사	기능·원장 30개와 마스터·메뉴 구조를 합한 32개 파일, 링크 1,658개, 기준 커밋에 고정한 소스 경로 435개, 이미지·영상·컴포넌트 import 8개 검사. 누락 없음
생성 HTML 검사	위 32개 페이지 본문의 로컬 링크·앵커·자산 참조 1,546개 검사. 이미지·영상·포스터 참조 16개 포함, 누락 없음. 외부 사이트의 HTTP 응답까지 검증한 것은 아님
브라우저 문서 확인	사이드바·기능 링크·이미지 로딩, 드라이브 4개와 신고 3개 표식의 위치·본문 대응 확인. 랜딩 새 캡처도 표시 확인
기존 급여 영상 표시	83.272초 영상 메타데이터 로딩, 약 43초 장면까지 실제 재생 및 일시정지 확인. 새로 녹화한 급여 실행 증거는 아님
git diff --check	공백 오류 없음

빌드의 500 kB 초과 청크 안내와 Turbo의 docs output 설정 경고는 남아 있습니다. 이 결과를 성능 개선이나 전체 lint 통과로 표시하지 않습니다. 소스 경로·문서 렌더 검사는 제품의 저장·권한·다중 사용자 동작 검증을 대신하지 않습니다.

커밋·푸시·PR·문서 사이트 배포는 수행하지 않았습니다. 현재 문서 수정은 로컬 작업 브랜치에 있습니다.

급여 영상 연결 검증

후속 변경입니다. 기존 급여 시트 영상 한 편을 공통 SheetVideoGuide로 묶어 핵심 기능 소개·HR 소개·HR 사용자 가이드·고객사 온보딩·FE 기록에 배치했습니다. 사용자 가이드 개요에는 HR 영상으로 가는 링크를 추가했습니다. 영상의 동작 번호와 글 설명을 1 월·셀 값, 2 공제 계산식, 3 셀 메모, 4 템플릿 사용으로 맞췄습니다.

확인	결과
실제 브라우저 재생	첫 로딩 전 3번 선택 후 해당 구간 재생, 2번 20.099초·4번 49.126초로 이동, 1번 0.243초로 재시작 및 일시정지 확인
키보드·예외	Enter로 번호 선택 후 즉시 일시정지할 때 AbortError가 재생 안내로 잘못 표시되는 상황을 재현하고 수정. 같은 조작 뒤 불필요한 상태 문구가 사라진 것을 확인
글 설명·화면	영상·4개 번호 버튼·번호별 설명 표시, 가로 넘침 없음, 버튼 높이 약 48px, 셀 메모의 상세 가이드 절 링크 이동 확인
생성·절 링크	사용자 가이드 10개의 기존 명시적 절 ID 목록 유지. HR 원본의 영상 표식이 생성 Markdown의 공통 컴포넌트로 변환됨
정적 결과 검사	37개 페이지의 로컬 링크·앵커·자산 참조 1,754개, 공통 플레이어 5곳 검사. 누락 없음
영상 자산	정적 문서 결과에는 WebM 1개만 포함. SHA-256이 기존 원본과 동일. 5곳 모두 자동 재생 없음·preload="none" 확인
저장소 검증	전체 빌드 23개 작업 통과. 전체 lint는 기존 오류 56개로 실패하며 경고는 1,583개. 새 Vue 파일의 템플릿 참조를 미사용으로 보는 경고 7개가 포함됨. 변경한 플레이어·테마 등록·생성기 3개 파일의 오류 수준 Biome 검사 통과

브라우저 열기의 자동 승인 검토가 한 번 시간 초과됐지만 도구가 허용한 재시도는 성공했습니다. 새로운 업무 영상 촬영, 실제 급여 수정·반영, 휴대기기 재생 및 파일 로딩 실패 화면의 실행 검증은 이번 범위에 포함하지 않았습니다. 독립 HTML 배포 파이프라인에는 VitePress 전용 플레이어가 추가되지 않습니다. 커밋·푸시·배포는 수행하지 않았습니다.

앱별 영상 촬영과 형식 통일

관리자 패널·직원 앱·팀 관리자·간호 스케줄러·총무 관리·경영 대시보드·재고 관리·모듈 매니저의 대표 작업 8개를 새로 녹화했습니다. 기존 개요의 어두운 반투명 자막, 주황색 사각 번호, 제목·설명, 클릭 대상 강조와 실제 텍스트 확대를 공통 촬영 표식으로 재현했습니다. 가려지는 입력란은 자막 위치를 조정해 다시 촬영했습니다.

환경은 6fbaee7f 코드의 로컬 앱·API와 별도로 만든 PostgreSQL DB입니다. 저장소 seed와 촬영용 예제 병원·병동·품목·금액을 사용했으며 고객 DB를 사용하지 않았습니다. 관리자 테스트 계정으로 작업하고 직원 앱에서는 같은 예제 직원의 본인 화면을 조회했습니다. 직원 앱 390×844, 나머지 1440×900의 격리 Chrome 브라우저입니다. 실기기·배포 환경 검증은 아닙니다.

영상	실행해 확인한 결과	남은 확인
관리자 패널	팀 만들기	직원 배정·초대 메일·다른 역할의 접근·조직 전환은 이 영상에 포함하지 않았습니다.
직원 앱	급여명세서 조회	HR의 공개 전후 비교, 본인 확인 오입력, 타인 접근, 인쇄와 실기기 사용은 이 영상에 포함하지 않았습니다.
팀 관리자	휴가 승인	휴가 한 건의 승인과 상태 필터 결과를 확인했습니다. 직원 앱 재진입·알림 수신·다른 결재 유형·일괄 승인·반려는 별도 검증 대상입니다.
총무 관리	미게시 공지 작성	미게시 공지 작성·무기한 선택·목록 결과를 확인했습니다. 실제 게시와 직원 수신·확인·대리 확인은 실행하지 않았습니다.
경영 대시보드	월 청구 금액 입력	9월 청구 금액을 81,000,000원으로 수정하고 표시 결과를 확인했습니다. 다른 계정·기기의 동시 조회, 실패 시 롤백, 삭제와 재진입은 별도 검증 대상입니다.
재고 관리	입고 수량 반영	소독 알코올 수량을 28개에서 48개로 변경하고 목록 결과를 확인했습니다. 출고·음수 결과 거절·실패 복구·다른 기기 재진입은 별도 검증 대상입니다.
간호 스케줄러	근무 배정과 확정	예제 A병동의 2026-09-16~10-15 근무표에서 조은별의 9월 16일 근무를 N에서 D로 변경하고 확정 표시를 확인했습니다. 제출·공유·후속 휴가/교육 동기화 결과·직원 수신은 별도 검증 대상입니다.
모듈 매니저	계산기 정의 조회	근로계약과 초과근무 계산기의 원천·대상 테이블과 출력 정의를 조회했습니다. 조직의 급여를 생성하는 Test Calculator 실행은 촬영·검증하지 않았습니다.

영상은 무음·원래 재생 속도이며 로딩 구간을 잘라내거나 UI 결과를 합성하지 않았습니다. 종료된 WebM에 길이·탐색 정보가 없어 재인코딩 없이 컨테이너를 다시 저장했습니다. 공개 자산의 날짜·리비전·화면 크기·단계·길이·SHA-256은 docs/public/tutorials/2026-09-11/manifest.json에 기록합니다. API 비밀키나 촬영용 환경 파일은 미디어 자산에 포함하지 않습니다.

공지의 직원 게시, 외부 메일 발송, 근무표 제출·후속 동기화 결과, 모듈 매니저 급여 생성은 촬영하지 않았습니다. 영상의 성공 화면만으로 전체 권한·조직 분리·실패 복구·재접속·동시 사용을 검증했다고 표시하지 않습니다. 실행 검증 범위는 각 영상에 명시한 조작으로 한정합니다. 다른 권한·실패 경로까지 확인한 것으로 확대하지 않습니다.

공통 영상은 앱 소개 8곳과 기능 문서 8곳, 현재 공개되는 사용자 가이드 5곳에 직접 표시합니다. 기존 급여 영상 5곳을 유지하고, 핵심 개요·사용자 가이드 개요·고객 온보딩·기능 마스터·사이드바에서 영상 목록으로 연결합니다. 생성 대상 10개 문서의 기존 절 ID는 유지합니다. 커밋·푸시·배포는 수행하지 않았습니다.

최종 확인 결과

검사	결과
실제 녹화	8편·35단계. 전체 영상 스트림 디코딩, 화면 크기·길이·포스터·체크섬 확인. 번호별 시작은 최종 프레임의 자막과 0.5초 간격으로 대조
공통 플레이어	앱 소개 8곳에서 최초 로딩 전 마지막 번호를 선택해 실제 재생·탐색·일시정지 확인. 자동 재생 없음, preload="none", 유한한 재생 길이 확인
작은 화면	390×844 문서에서 긴 모듈 번호 버튼과 직원 앱 영상 확인. 가로 넘침 없음, 버튼 높이 48px, 직원 본인 확인 구간 실제 재생. 화면 밖 영상은 번호 선택 시 다시 보이도록 이동
기존 영상 회귀	개요의 3번을 Enter로 선택해 32.88초 재생, 일시정지 확인. 빠른 재생·일시정지 뒤 잘못된 오류 안내 없음
미디어 실패	존재하지 않는 영상 경로를 브라우저에서 요청해 실제 실패 발생. 읽을 수 있는 포스터·오류 안내·4단계 글 설명 유지, 재생 번호 비활성 확인
사용자 가이드	관리자 원본 표식이 공통 영상으로 렌더됨. 기존 s1-1 진입점 유지. 생성 대상 10개 파일의 기존 절 ID 목록 일치
정적 링크	앱·기능·가이드·마스터 등 51개 페이지의 본문 참조 2,254개 검사. 사이트에서 제외된 팀 관리자 독립 가이드 링크를 발견해 공개된 결재 기능 문서로 수정
빌드·lint	전체 빌드 23/23 통과. 변경한 컴포넌트·테마·설정·생성기·촬영 표식 9개 파일의 오류 수준 Biome 검사 통과. 전체 lint는 기존 오류 56개로 실패, 경고 1,586개·정보 2개. 오류 파일 16개는 기준 커밋과 동일함을 대조

이번 영상 추가는 FE 성능 개선이나 신규 성능 측정이 아닙니다. 모바일 브라우저 크기 검증은 iOS/Android 실기기 재생을 대신하지 않습니다. 공개 사이트 배포는 수행하지 않았습니다.

사용자 가이드 항목별 영상 — 53편 확인 시점

Codex가 앱 개요의 대표 영상과 별도로 사용자 가이드 세부 항목별 실제 조작을 촬영하고 각 기능 기록을 직접 갱신했습니다. 촬영 환경은 앞 절과 같은 격리 예제 DB·로컬 앱이며 고객 조직은 사용하지 않았습니다. 현재 범위는 88개 항목 촬영 원장, 영상 진입은 기능별 따라 하기에서 확인합니다. 한 절에 영상이 있어도 그 절의 모든 예외와 권한이 검증된 것은 아닙니다.

검증	확인 결과
실제 동작	이 시점 53편·237개 번호 동작. 저장·신청·취소·설정·조회 절차를 직접 실행. 관리자 12편, 직원 14편, HR 10편, 간호 10편, 총무 2편, 경영 5편
영상 재생	공개 가이드 6페이지, 53개 고유 영상의 54개 배치에서 마지막 번호를 눌러 실제 로딩·재생·탐색·일시정지 확인. 실패 0
정적 결과	54페이지의 로컬 참조 2,642개, 전체 플레이어 86개 검사. 링크·앵커·자산 누락 0. 생성 가이드 10개의 기존 절 ID 유지
영상 데이터 검사	자산 누락, 잘못된 절 배치, 존재하지 않는 영상 표식, 영상 끝을 넘거나 겹치는 동작 시각을 거부하는 Node 테스트 6개 통과
빌드	전체 pnpm build 23/23 통과, 22개 캐시 사용, 30.339초. 이 행은 53편 연결 시점의 결과
전체 lint	pnpm lint:check는 기존 오류 56개·경고 1,585개·정보 2개로 실패. 기존 Demo Vue 오류 파일은 기준 커밋과 동일하며 이번 영상 추가로 수정하지 않음
화면	새 영상 포스터를 열어 입력란·선택 대상·번호 자막을 대조. 가려지는 조작과 결과 확인이 빠진 촬영본은 재촬영했으며 실패본은 연결하지 않음

촬영 중 발견한 직원 인센티브의 날짜 없는 기존 자료 표시와 짧은 공지의 확인 버튼 활성화 문제는 각각 인센티브, 공지에 별도 기록했습니다. 원인을 확정하거나 제품 코드를 수정한 완료 건으로 표시하지 않았습니다. 조직 데이터가 갱신되는 촬영과 영상 플레이어 기능 검증은 구분합니다. 실제 푸시·문자·메일·전자서명 발송, 고객 환경 및 iOS/Android 실기기는 미검증이며 공개 사이트 배포도 수행하지 않았습니다.

사용자 가이드 항목별 영상 — 90편 최종 확인

Codex가 각 기능 기록과 마스터를 직접 갱신했습니다. 게시 중인 6개 사용자 가이드의 88개 세부 항목 모두에 관련 영상을 연결했습니다. 개별 기능 영상은 90편·382개 번호 동작이며 기존 앱 대표 영상 8편과 구분합니다. 관리자 29편, 직원 21편, HR 21편, 간호 12편, 총무 2편, 경영 5편입니다. 일부 영상은 두 절에서 재사용하므로 개별 영상의 실제 배치는 92개입니다.

검사	결과와 범위
브라우저 재생	6개 공개 가이드의 92개 배치에서 마지막 동작 번호 클릭 후 실제 로딩·재생·탐색·일시정지 확인. 실패 0
번호·생성 원본	실제 영상 프레임의 자막 시각을 OCR로 대조. 촬영 JSON·HTML 절 표식의 위치, 자산 누락·빈 파일·범위 밖/중복 시각을 검사하는 Node 테스트 6개 통과
정적 산출물	90편 연결 시점의 기능·앱·가이드·마스터 등 54페이지, 로컬 참조 2,823개, 전체 플레이어 124개 검사. 누락 0, 생성 가이드 10개의 기존 절 ID 유지. 최종 기록 추가 후 문서 빌드와 정적 검사 재실행
전체 빌드	90편 연결 후 pnpm build 23/23 통과. 22개 캐시, 38.154초. 최종 기록 추가 후 문서 빌드도 다시 검사
전체 lint	pnpm lint:check는 기존 오류 56개·경고 1,585개·정보 2개로 실패. 오류가 난 16개 파일을 기준 커밋과 바이트 비교해 모두 동일함을 확인. 기존 Demo Vue 오류를 이 문서 작업에서 일괄 수정하지 않음
변경 코드	생성기·검증 로더/테스트·테마 등록·공통/항목별 재생기·생성 레지스트리 7개 파일의 오류 수준 Biome 검사 통과. git diff --check HEAD 통과
모바일 폭	390×844에서 관리자 가이드 31개, 직원 가이드 23개 전체 플레이어의 넘침과 번호 버튼 높이 확인. 범위 밖 플레이어·44px 미만 버튼 0, 각 가이드 첫 개별 영상 재생 통과. 실기기 검증은 아님
영상 화면	새 포스터와 동작 결과 스크린샷을 확인. AI 도크의 오른쪽 잘림은 실제 Chrome 창 크기를 맞춰 재촬영하고 완성 프레임에서 해결 확인
로딩 실패	테스트용 누락 영상으로 오류 안내·대체 포스터·글 설명 유지와 번호 버튼 비활성화 확인 후 정상 페이지로 복원

격리 예제 DB에서 실행했으며 고객 환경의 기록을 변경하지 않았습니다. 급여는 중복 집계 조건을 발견하여 기록했고, 수당 한 항목 실습에서 확정 1건·건너뜀 19건, 지급/실수령 136,000원·공제 0원, XLSX 한 행과 내부 공개 시각을 대조했습니다. 해당 직원 계정의 공개 후 조회·복수 수당/공제·법정 계산·취소는 완료로 표시하지 않습니다.

실제 SMS·메일·AI 질문·신고 접수·전자서명 전송, 이카운트 시스템 업로드, iOS/Android 설치·실기기 재생은 미검증입니다. 한 항목에 영상이 있다는 사실을 그 항목의 모든 세부 조작·권한·실패 복구를 촬영했다는 뜻으로 사용하지 않습니다. 남은 조작은 항목별 영상 원장에 남겼습니다. 스크롤/라우터 코드는 수정하지 않았고 커밋·푸시·공개 사이트 배포도 하지 않았습니다.

사용자 문서 탐색 분리 검증

Codex가 한국어 홈·핵심 기능·사용자 가이드·온보딩·영상 목록의 검색·본문·영상 링크를 사용자 문서로 연결했습니다. 처음에는 상단 메뉴도 제한했으나, 개발자의 진입 경로를 유지해야 한다는 사용자 피드백에 따라 공통 상단 메뉴를 복원했습니다. 개발 기록·FE 성능·내부 임포터·시스템 관리자는 사용자 본문 연결과 검색에서 제외하며, 개발 가이드 등 전체 문서 영역은 모든 페이지의 공통 상단 메뉴로 접근합니다. 개발 페이지에서는 전체 문서 검색을 유지합니다. 가이드 HTML 원본과 공통 영상 목적지를 함께 수정하고 팀 관리자 승인·재고 수량 조정·모듈 조회의 고객용 절차를 보완했습니다. 구조와 유지보수 기준을 따릅니다.

새 경로 분류·메뉴·검색 필터 테스트 2개와 기존 영상 연결 테스트 6개를 통과했습니다. 실제 인앱 브라우저에서 사용자 페이지의 「FE 성능」 검색에는 결과가 없고 「급여」 검색 결과는 사용자 가이드 안에서 연결되는 것을 확인했습니다. 같은 탭으로 개발 기록에 진입하면 전체 메뉴와 FE 성능 검색 결과가 복원됩니다. 팀 관리자·관리자 영상의 「자세히 따라 하기」를 직접 눌러 사용자 절차의 주소·본문·스크롤 위치를 확인했습니다.

전체 빌드 23개 작업을 통과했습니다. 상단 메뉴를 복원하기 전 사용자용 24개 페이지의 메뉴·본문 링크 1,182개를 검사해 내부 문서 연결과 누락된 목적지·앵커가 없음을 확인했습니다. 공통 메뉴 복원 후에는 상단 메뉴의 개발 문서 연결과 사용자 본문의 연결 범위를 구분해 검사합니다. 사용자 가이드 13개 페이지의 본문 참조 841개와 용어 검사도 통과했습니다. 원본·생성 가이드 28개 파일의 제목·영상 표식·이미지를 변경 전과 대조했고, 기능 문서를 포함한 54개 페이지에서 재생기 124개·기능 영상 90편·382개 번호 동작 및 기존 가이드 10개의 제목 주소를 확인했습니다.

상단 메뉴 복원은 메뉴 보존 테스트가 먼저 실패하는 것을 확인한 뒤 필터 제거로 통과시켰습니다. 관련 테스트 2개, 변경 코드 2개 파일의 Biome 검사, 전체 빌드 23개 작업을 통과했습니다. 사용자용 24개 페이지에 공통 상단 메뉴 7개가 동일하게 노출되며 링크 1,302개에서 누락된 목적지·앵커와 상단 메뉴 밖의 개발 문서 연결이 없음을 확인했습니다. 실제 브라우저의 한국어 홈에서 「개발 가이드」를 눌러 개발 문서와 제품 개발 기록의 진입점을 확인했습니다. Codex가 마스터와 작성 규칙도 이 구분에 맞춰 직접 갱신했습니다.

앞선 변경 코드 6개 파일의 Biome 검사와 경로·검색 필터의 TypeScript 검사를 통과했습니다. 저장소 전체 pnpm lint:check는 오류 56건으로 실패했으며, 오류가 있는 16개 파일 모두 기준 커밋과 동일한 기존 파일임을 대조했습니다. 관련 없는 데모 코드는 수정하지 않았습니다.

이 변경은 문서 탐색을 분리한 것으로 접근 제어나 제품 업무 동작의 추가 검증이 아닙니다. 기존 녹화·번호·재생 시각·가이드 제목 주소를 보존하며 신규 촬영과 공개 사이트 배포는 수행하지 않았습니다. 실제 브라우저 확인은 데스크톱 폭의 메뉴·검색·링크 이동이며, 모바일 메뉴와 실기기 재생을 새로 검증한 작업은 아닙니다.

사용 설명 문구 정리 검증

Codex가 기능 문서·앱 소개·사용자 가이드 원본·이미지 캡션·영상 설명의 작성 및 촬영 시점 안내를 정리했습니다. 번호별 사용법과 구체적인 화면 차이·미확인 조작을 유지하고, 촬영 날짜는 원본 JSON에서 관리합니다. 신청일·급여월·기한 등 업무에 쓰이는 날짜와 원본 자산 경로는 보존했습니다.

가이드 원본의 제목·영상 표식·이미지 및 연결 주소, 기능 문서의 자산 import가 변경 전과 같은지 비교했습니다. 영상 생성기의 기존 자동 테스트 6개를 통과했습니다. 문구 정리는 제품 동작이나 영상의 실행 검증 범위를 확장한 변경이 아닙니다.

문서 빌드와 생성 결과 54개 페이지의 로컬 링크·앵커 2,832건 검사를 통과했습니다. 기능 영상 90편·382개 동작, 전체 재생기 124개와 기존 가이드 10개의 앵커가 유지됩니다. 생성 HTML 58개 페이지에서도 불필요한 시점 안내가 남지 않았는지 검사했습니다. 생성기·영상 정의·공통 시트 영상의 Biome 검사에는 오류가 없고, Vue 템플릿에서 사용하는 import·변수에 대한 기존 경고 3건이 남아 있습니다.

사용자 가이드 용어 정리

Codex가 사용자 가이드 원본·온보딩·영상 목록·영상의 글 설명을 업무 용어로 정리했습니다. 근무표의 파일 읽기와 저장, 기기별 임시 저장, 급여 반영과 확정·공개를 구분했습니다. 버튼·메뉴·입력란의 실제 이름은 유지하고 필요한 뜻을 덧붙였습니다. 제품의 기능이나 녹화 영상 자체를 변경한 작업은 아닙니다.

영상 생성기 테스트 6개와 영상 정의 2개 파일의 Biome 검사를 통과했습니다. 가이드의 제목 단계·영상 배치 표식·이미지와 연결 주소, 촬영 JSON의 ID·파일 경로·재생 시각은 변경 전과 비교했습니다. 문서 빌드와 링크·앵커 검사도 통과했으며 기존 가이드 10개의 절 주소, 기능 영상 90편·382개 동작, 재생기 124개를 유지합니다. 실제 인앱 브라우저에서 HR의 소개·목차·영상 제목과 간호 가이드의 파일 저장·기기별 임시 저장 설명을 확인했습니다. HR 화면의 가로 넘침은 없었습니다.

관련 설명 링크 정리

Codex가 사용자 가이드·앱 소개·기능 문서의 절 번호 및 상대 위치 참조를 검토했습니다. 관리자·HR·간호 가이드와 조직 권한·연차사용촉진 기능 문서에서 작업 이름을 보여 주는 링크로 정리했습니다. 수식 수정 사유의 참조는 잘못된 급여대장 항목에서 셀 메모 항목으로 수정했습니다. 기존 제목·절 주소·영상의 동작 번호는 유지하고, 팀 멤버 추가와 근무표 제출·공유에는 해당 조작으로 바로 이동하는 주소를 추가했습니다.

문서 빌드와 영상 연결 테스트 6개를 통과했습니다. 생성 결과 54개 페이지의 본문 로컬 참조 2,876개와 사용자 가이드 13개 페이지의 본문 참조 843개에 누락이 없었습니다. 기존 생성 가이드 10개의 제목 주소와 영상 90편·382개 동작·재생기 124개를 유지했습니다. 실제 인앱 브라우저에서 불편·기능 신고, 팀 멤버 추가, 셀 메모, 근무표 제출·공유 링크를 눌러 목적지 주소·본문·스크롤 위치를 확인했습니다. 제품 동작과 녹화 영상의 실행 범위를 새로 검증한 작업은 아닙니다.

업무 시작 안내 표

Codex가 사용자 가이드 원본 8개의 사용 대상·시작 위치 안내 89곳을 두 열의 표로 정리했습니다. 관리자 26곳, 직원 22곳, HR 2곳, 간호 12곳, 총무 2곳, 경영 7곳, 재고 8곳, 팀 관리자 10곳입니다. 시작 조건과 다른 진입 방법이 한 문장에 섞인 안내도 해당 내용을 별도 행으로 분리했습니다. 권한·메뉴 이름·번호별 조작과 기존 제목·링크·영상 위치를 유지했습니다.

원본과 생성 문서 16개 파일의 제목·절 주소·본문 링크·영상 표식·이미지 경로를 변경 전과 비교했습니다. 문서 빌드, 영상 연결 테스트 6개, 54개 페이지의 본문 로컬 참조 2,880개 검사를 통과했습니다. 실제 인앱 브라우저의 1,706px 너비에서 게시 중인 6개 가이드의 안내 표 71개와 행 구성을 확인했으며 표의 가로 넘침은 없었습니다. 재고·팀 관리자 원본의 18개 표는 생성 결과로 확인했고 공개 경로를 새로 활성화하지 않았습니다. 모바일 폭과 제품 동작은 이 문서 형식 변경에서 새로 검증한 범위가 아닙니다.

주제별 사용자 변경 이력

Codex가 변경 원본 한 건을 여러 가이드 절에 연결하고, 각 주제 끝의 최근 공개 이력 2건과 전체 변경 이력 페이지를 생성하도록 추가했습니다. 실제 적용일·배포 근거·문서와 영상 검토 결과를 기록하며 적용 확인 전·내부 항목과 기술 근거는 고객 이력에서 제외합니다. 사용법 원본, 기능 개발 문서, 마스터, 작성 규칙도 함께 갱신합니다.

첫 원본은 직원 홈 구성 설정의 코드·기존 문서를 대조한 보완 기록입니다. 고객 적용일과 해당 설정 영상은 확인되지 않아 적용 확인 전·영상 확인 대기 상태입니다. 이번 작업은 이력 관리 기능의 검증이며 제품 업무의 신규 실행·재촬영·고객 배포 확인은 포함하지 않습니다.

검사	실제 확인 결과
자동 테스트	변경 이력 10개·영상 연결 6개·사용자 문서 분류 2개, 총 18개 통과. 주제 끝 배치, 최신 2건, 오래된 이력 보존, 여러 절 연결, 비공개 상태 제외, 누락된 근거·절·영상 거부, HTML 처리와 변경 파일 갱신 누락을 확인했습니다.
실제 브라우저	임시 검증 예시 3건을 같은 생성 함수로 렌더링해 본문 끝의 최근 2건, 다음 주제의 위치, 전체 3건 보관, 직원 홈 사용법 복귀를 확인했습니다. 적용 전 항목·기술 근거는 출력하지 않았고 데스크톱 화면에 가로 넘침이 없었습니다. 예시 페이지 2개는 확인 후 삭제해 빌드에 포함하지 않았습니다.
실제 사용자 페이지	개요와 사이드바에서 전체 이력으로 이동했습니다. 적용이 확인된 기록이 없어 빈 상태 안내를 표시하며, 기존 가이드에는 빈 이력 표를 넣지 않습니다.
생성 결과 보존	사용자 가이드 17개를 변경 전과 대조해 제목·주소·영상·Markdown 이미지 배치를 유지했습니다. 기존 생성 가이드 10개의 절 주소, 기능 영상 90편·382개 동작, 재생기 124개를 보존했습니다.
링크·문장·탐색	사용자 페이지 25개의 공통 상단 메뉴 7개·링크 1,349개와 기존 검증 범위 54페이지의 참조 2,888개에 오류가 없었습니다. 사용자 가이드 14개의 참조 844개에 끊어진 링크·검사 대상 기술 용어가 없었습니다.
빌드·정적 검사	전체 빌드 23개 작업 통과. 이번 변경의 스크립트·설정·원본 JSON 8개 파일의 Biome 검사와 변경 파일 검사를 통과했습니다. 전체 lint는 기존 오류 56개·경고 1,585개·정보 2개로 실패했으며, 기존 오류가 있는 Demo 컴포넌트를 포함한 73개 파일은 HEAD와 내용이 같았습니다.

변경 파일 검사는 기본 HEAD와 실제 검토 기준 커밋을 사용합니다. 문서·영상 검토 선언과 파일 연결을 대조할 뿐 촬영 내용이나 배포 근거의 진위를 자동 판정하지 않습니다. CI·커밋 훅 연결, 모바일 화면, 제품의 새 동작 검증, 커밋·푸시·공개 사이트 배포는 수행하지 않았습니다.

PR 검토에서 남은 사항

이력 관리 검토에서 가이드 제목을 순서대로 s1, s2로 지정하는 구조의 문제를 재현했습니다. 첫 주제 앞에 새 주제를 추가하면 이전 s1 이력이 새 주제에 붙어도 주소 존재 검사는 통과합니다. 현재 공개 이력은 없으며, 주제별 고정 주소와 기존 주소의 호환 처리는 후속 수정 대상입니다. 기존 영상 위치 검사 통과만으로 이력의 의미상 연결이 유지된다고 판단하지 않습니다.

이력 검사는 PR 필수 검사에 연결하지 않았고, 사용법 본문·영상의 공개 시점을 제품 적용 성공에 종속시키는 배포 변경도 포함하지 않았습니다. 일부 업무 영상의 승인 후 직원 화면 반영 등 남은 조작은 항목별 영상 원장에서 계속 관리합니다. 고객 적용일이 확인되지 않은 기존 기록은 적용 확인 전 상태로 보관합니다. 앱 소개에 동일한 변경 이력 표와 추가 이동 링크를 반복 배치하는 확장은 진행하지 않습니다.

최신 develop의 사용자 가이드 변경을 병합하면서 비공개 팀 관리자·재고 가이드는 관리자 화면의 결재 위치 안내와 준비 안내로 축약한 원본을 유지했습니다. 공개 6개 가이드의 71개 안내 표와 항목별 영상은 보존했으며, 숨겨진 두 원본의 이전 18개 표·절 수는 현재 수량으로 사용하지 않습니다. 시트 템플릿 다운로드와 간호 근무표 양식 안내, 경영 대시보드의 현재 진입·인센티브 설명도 유지했습니다. 별도로 추가된 랜딩 약관의 정적 HTML 개발 기록은 랜딩 기능 문서로 옮기고 기존 마스터 주소를 연결했습니다. 이는 문서 통합이며 해당 기능의 신규 실행 검증은 아닙니다.

병합 후 변경 이력·영상·문서 분류 테스트 18개와 전체 빌드 23개 작업을 다시 통과했습니다. 변경 코드·설정·원본 JSON 23개 파일의 Biome 검사에는 오류가 없고 Vue 템플릿 참조 관련 경고 10개가 남았습니다. 전체 lint는 오류 56개·경고 1,587개·정보 2개로 실패하며, 기존 오류가 있는 데모를 포함한 Demo 컴포넌트 73개는 origin/develop과 바이트 단위로 동일합니다.

문서 54페이지의 참조 2,900개, 사용자 페이지 26개의 메뉴·링크 1,416개, 가이드 15페이지의 참조 865개에 끊어진 연결이 없었습니다. 재생기 124개·기능 영상 90편·382개 동작과 공개 생성 가이드 8개의 기존 절 주소를 확인했습니다. 축약된 비공개 팀·재고 원본은 이전 절 목록 보존 대상에서 제외했습니다. 인앱 브라우저에서 병합된 시트 양식 다운로드 카드 3개와 대시보드의 현재 진입 설명·번호 영상을 확인했습니다.

새로 병합한 시트 양식 가이드에는 DB·소스 바인딩·스키마 등 사용자에게 불필요한 기술 표현과 문서 관리자 설명이 함께 있습니다. 해당 페이지의 사용자용 문장 정리와 개발 설명 분리는 후속 정리 대상이며, 이번 PR의 기존 사용자 가이드 문장 검사 통과 범위를 그 페이지 전체에 적용하지 않습니다.

이전 영상 등록 자동화 검증

아래는 제거 전 자동화의 검증 기록입니다. 사용자 요청으로 업로드·검증 YAML과 등록 명령을 제거했으며 현재 운영 방식은 주간 로컬 보관을 따릅니다. 아래 AWS 활성화 항목은 현재 진행할 작업이 아닙니다.

Codex가 scripts/docs-media/의 입력 검증·등록·재시도·GitHub 커밋 코드와 두 Actions 워크플로를 직접 작성하고, 별도 코드 검토에서 발견된 신규 S3 404 처리·앱 ID 검증·오디오 트랙 허용 문제를 재현 후 수정했습니다. 실제 AWS 배포와 아래 로컬 검증을 구분합니다.

확인 범위	결과
자동 회귀 검사	미디어·기존 영상·변경 이력·문서 분류 테스트 총 45개 통과. 손상 파일, CDN MIME·구간 응답, 잘못된 PR·HEAD·ID, 버전 예약 경쟁, 동일 요청 재실행, 기존 파일 이전, Git 바이너리 제외를 포함합니다.
실제 파일	기존 영상 98편과 포스터 98개를 ffprobe로 검사해 길이·화면 크기·파일 형식을 대조했습니다. 새 제품 흐름을 촬영한 검증은 아닙니다.
실제 PR 읽기와 로컬 전달 명령	PR #684와 직원 등록 영상의 stage --dry-run을 실행해 7개 동작, PR 원본·가이드 위치, 최종 WebM·포스터 검사를 통과했습니다. S3 업로드·Actions 실행·PR 변경은 수행하지 않았습니다.
호환성	앱 대표 영상 8개의 사용자 표시 데이터를 JSON 전환 전후 전체 비교해 일치를 확인했습니다. 로컬 자산과 등록된 원격 자산 모두 생성기에 연결됩니다. 원격 주소만 임의 수정하면 검사가 실패합니다.
코드·워크플로	변경된 JS·JSON·설정의 Biome 검사와 두 YAML의 actionlint 검사를 통과했습니다. 프런트엔드 사전 검사는 표시 0건이며 업무 앱 코드·DB 변경은 없습니다. 새 안내 페이지의 언어 전환 연결도 추가했습니다.
전체 빌드	pnpm build의 23개 작업 통과. 문서 빌드를 포함하며 기존 번들 크기 경고가 있습니다.
전체 lint	pnpm lint:check는 기존 오류 56개·경고 1,587개·정보 2개로 실패했습니다. 이번 자동화 변경의 범위 검사에는 오류가 없습니다.
외부 실행 미확인	실제 AWS 버킷·OIDC·CloudFront 연결, GitHub 기본 브랜치에 반영된 등록 작업, 실제 S3 등록 후 PR 자동 커밋과 고객 문서 배포는 설정 후 확인해야 합니다.
기존 자료·남은 문제	98편을 S3로 이전하거나 Git 과거 커밋에서 제거하지 않았습니다. 기존의 순서 기반 절 주소 문제와 미촬영 업무는 별도 후속 범위입니다.

제거 후의 현재 절차는 주간 문서·영상 작업에 있습니다. 기능의 사용법·배포 상태·영상 장면 일치를 에이전트가 직접 기록하는 책임은 유지합니다.

기능·문서 PR 분리 검증

기능 PR의 개발 기록은 즉시 갱신하고, 고객 가이드와 최종 촬영은 병합 후 연결된 문서·영상 PR에서 마무리하도록 검사와 작성 규칙을 변경했습니다. 이력 원본의 followUp에 담당자·기능 PR·후속 작업을 보관합니다.

확인 범위	결과
후속 작업 검사	추가한 6개 이력 테스트를 포함해 미디어·영상·이력·고객 문서 분류 테스트 총 51개 통과. 추적된 대기 허용, 개발 기록 누락 거절, 잘못된 후속 연결 거절, 예정 절과 완료 시 존재 검사, 문서 PR의 원본 갱신, 대기 공개 거절, 후속 기록 보존을 확인했습니다.
현재 변경 검사	작업 전 HEAD를 기준으로 check:product-docs 통과. 변경한 검사기·테스트의 Biome 검사 통과. 기존에 보관한 첫 화면 설정의 대기 기록은 허위 후속 링크를 만들지 않고 유지합니다.
전체 검사	전체 빌드 23개 작업 통과. 전체 lint는 기존과 같은 오류 56개·경고 1,587개·정보 2개로 실패했습니다. 이번 검사기·테스트의 범위 Biome 검사에는 오류·경고가 없습니다.
문서 연결	수정한 개발 문서 4페이지의 본문 링크·절 참조 188개 통과. 전체 메뉴 검사에서는 기존 3페이지의 영문 대응 페이지 부재로 언어 전환 링크 6개가 끊어져 있음을 확인했습니다. 이번에 추가한 본문 연결과 구분합니다.
검증 한계	GitHub 이슈·PR의 실제 존재·담당·병합 상태, 촬영한 기능과 영상의 일치, 제품 배포는 담당자가 확인합니다. 이번 변경은 실제 기능 개발부터 후속 문서 PR 병합까지 운영한 검증이 아닙니다.

두 PR의 실행 절차와 작성·완료 기준을 연결합니다. 촬영·후속 PR 생성·이슈 완료를 자동 실행하는 워크플로는 추가하지 않았습니다. 이후 S3 자동화는 사용자 요청으로 제거했으며 현재 주간 작업 기준은 주간 로컬 보관을 따릅니다.

전체 영상·썸네일 외부 주소 연결

인프라가 제공한 https://works-static.dev.hereby.me/docs/에서 기존 파일명에 대응하는 198개 URL을 직접 확인했습니다. 앱 개요 8편, 기능별 90편, 별도 급여 시트 1편과 각각의 썸네일입니다. 모든 응답의 HTTP 200·MIME·크기·전체 SHA-256이 원본과 일치하며 합계는 397,572,380바이트입니다. 영상 99편의 구간 요청은 모두 HTTP 206과 원본의 해당 바이트를 반환했습니다. CDN 객체 검증이며 실제 제품 사용법을 재검증하거나 새로 촬영한 근거는 아닙니다.

98개 촬영 JSON에는 영상·이미지 양쪽의 external 확인 근거를 저장했습니다. capturePayload 비교로 주소·확인 근거 외 모든 촬영 정보와 번호별 시각·설명을 보존했음을 확인합니다. 별도 급여 시트의 확인 근거는 다음과 같습니다.

파일	크기	SHA-256
hereby-sheet-story.webm	9,615,945바이트	f9e29b5854976895474b9b7bcdf098f96701ac4841e9c1a5b0dc44ce6b8f8f3e
hereby-sheet-story-poster.jpg	252,856바이트	409f286ebd79d16113099041bf44b4fff2fcc3011ba0261523b95ab4a4176571

검증 자료는 로컬 .docs-media/verification/cdn-migration-2026-09-15/verification.json에 전체 상대 경로·URL·해시·확인 시각·구간 결과로 보관합니다. 이 파일과 변경 전 원본 사본은 Git에 포함하지 않습니다. 최초 연결 단계에서는 기존 파일을 보존한 채 로컬만 검증했습니다. 이후 PR에 추가한 98쌍의 Git 제외는 아래 기록을 따르며, 배포·OIDC 또는 Actions 업로드는 수행하지 않았습니다. 연결 및 복구 절차를 함께 확인합니다.

전체 연결의 문서·재생 확인

검증	결과
생성 문서 전체	빌드된 한국어 문서에서 참조하는 고유 영상·썸네일 주소 198개가 원격 대조 결과와 모두 일치합니다. 영상의 기존 사용법 링크 8종은 파일·앵커가 존재합니다.
원본 보존	앱·항목 촬영 98개의 주소·확인 근거 외 전체 정보가 변경 전 JSON과 일치합니다. 급여 시트의 기존 단계 정의도 동일합니다.
앱 개요의 대표 재생	팀 관리자에서 4번을 선택한 뒤 외부 영상의 41.22초 재생, 준비 상태 4, 미디어 오류 없음을 확인하고 실제 영상 프레임과 4번 강조를 화면으로 확인했습니다. 관리자 앱 개요에서도 4번 선택 시 외부 주소와 24.5초 이동을 확인했습니다.
기능별 가이드의 대표 재생	문서 양식의 1~4번을 눌러 0·15.5·20.5·26.5초 구간으로 이동했습니다. 모두 준비 상태 4, 재생 중, 오류 없음이며 영상과 썸네일 주소 모두 CDN입니다.
별도 급여 시트 재생	1~4번을 눌러 0·20·32·49초 구간으로 이동했습니다. 모두 준비 상태 4, 오류 없음이며 영상과 썸네일 주소 모두 CDN입니다.
회귀 검사	앱 소개 링크 허용과 내부 앱·외부 주소 거부 회귀 검사를 추가했습니다. 관련 테스트 57개 통과, 변경 대상 98개 파일의 Biome 검사 통과, 미디어 Git 제외·제품 문서 검사 및 diff 공백 검사 통과입니다.
전체 빌드와 lint	전체 빌드 23개 작업 통과. 전체 lint는 기존과 같은 오류 56개·경고 1,587개·정보 2개로 실패하며 변경 대상 범위 검사는 통과했습니다.
확인 경계	모든 파일의 전송·내용·구간 응답과 생성 문서 주소를 검사했지만, 브라우저의 번호 클릭은 위 대표 영상 범위입니다. 기능 재촬영·제품 QA·고객 문서 배포·PR 반영·Actions 등록 실행은 수행하지 않았습니다.

최초 문서 양식 영상 연결 확인

사용자가 제공한 https://works-static.dev.hereby.me/docs/admin-document-template.webm을 기존 admin-document-template에 연결했습니다. 전체 응답은 5,735,755바이트이고 SHA-256은 66cc52e5ae8603fea425653bee88fe8d91a9d89cdf2a8e2dab76d61fdacbe131로 원본과 일치합니다. MIME은 video/webm, 1,048,576~1,049,599바이트 요청은 206과 정확한 해당 바이트를 반환했습니다.

표지는 기존 로컬 JPG를 사용하고, 영상·이미지 파일을 삭제하지 않았습니다. 사용자 기능을 다시 실행하거나 새 영상을 촬영한 검증이 아니라 기존 영상의 전송·문서 연결 검증입니다. 실제 사용법과 연결·복구 절차를 확인합니다. 자동 등록 워크플로와 OIDC·S3 쓰기 권한은 이번에도 실행하지 않았습니다.

브라우저의 관리자 가이드에서 최초 로딩 전 4번을 눌러 26.5초로 이동한 뒤, 1~4번을 차례로 눌러 0·15.5·20.5·26.5초 구간 재생을 확인했습니다. 모두 외부 URL을 사용하고 준비 상태 4·재생 중·미디어 오류 없음으로 확인했습니다. 실제 길이는 45.833초, 화면 크기는 1440×900입니다.

수동 연결·주소/설명 불일치·불완전한 근거·로컬 표지 누락·정식 버전 전환 테스트 4개를 추가해 관련 테스트 총 55개가 통과했습니다. 변경 코드·촬영 JSON·생성 목록의 Biome 검사, 제품 문서 검사, 미디어 Git 포함 검사, 전체 빌드 23개 작업도 통과했습니다. 전체 lint는 기존과 같은 오류 56개·경고 1,587개·정보 2개로 실패했습니다. 고객 문서의 실제 운영 배포는 수행하지 않았습니다.

PR에 추가한 영상·썸네일 Git 제외

Codex가 CDN 검증 자료와 현재 원본의 SHA-256을 다시 대조한 뒤 docs/public/tutorials/의 영상 98편·썸네일 98개, 총 387,703,579바이트를 Git 제외 대상으로 정리했습니다. 모든 대상이 현재 PR에서 추가한 파일임을 확인했습니다. 원본은 .docs-media/archive/cdn-migration-2026-09-15/ 아래 기존 상대 경로에 보관하고, 이동 후에도 해시가 같은지 확인했습니다. 파일별 CDN 주소와 확인 근거는 같은 폴더의 manifest.json에 남깁니다.

기존 apps/landing/public/demo/hereby-sheet-story.webm과 썸네일은 PR 이전부터 존재하고 apps/landing/src/views/demo.html이 직접 참조하므로 유지합니다. 문서의 SheetVideoGuide.vue는 CDN 주소를 사용합니다. 과거 Git 커밋과 S3 객체는 제거하지 않습니다.

docs/media/legacy-files.json은 빈 객체로 정리해 같은 파일의 재추가도 차단합니다. 이 변경은 촬영 JSON·번호별 설명·사용자 조작·제품 기능을 변경하지 않으며, 파일 보관 및 복구 절차를 연결합니다.

검사 결과는 관련 테스트 57개 통과, 전체 빌드 23개 작업 성공, 변경 대상 100개 파일의 Biome 오류 0개·기존 Vue 사용 참조 경고 3개입니다. 전체 preflight의 유일한 경고 항목은 기존 전체 lint 오류 56개이며 경고 1,587개·정보 2개도 유지됩니다. 제품 문서 검사는 이번 변경의 HEAD와 PR 공통 조상 ba9a2dcc3c7da85589dbbad3beca32743767a424 기준 모두 통과했습니다. 진행된 origin/develop과의 단순 비교는 다른 PR의 변경까지 포함하므로 PR 범위 판정에 사용하지 않습니다.

빌드된 한국어 문서가 참조하는 외부 영상·썸네일 URL 198개는 전체 대조 목록과 일치하며, 제외한 196개 바이너리는 문서 빌드 결과에도 없습니다. 인앱 브라우저에서 관리자 개요의 4번을 눌러 CDN 영상 24.689초, 준비 상태 4, 재생 중·미디어 오류 없음을 확인했습니다. 앞서 확인한 전체 영상의 바이트·구간 검증과 구분하며 제품 동작·모바일·고객 배포를 다시 검증한 결과는 아닙니다.

주간 문서 PR과 로컬 영상 보관

사용자가 자동 업로드·검증 YAML을 취소하고 매주 금요일의 초안 문서 PR과 PC의 영상·썸네일·ZIP 보관을 요청했습니다. Codex가 두 미디어 워크플로, S3 전달·등록 실행 코드와 전용 설정 예제를 제거하고, 기능 기록·작성 규칙·전달 안내를 함께 변경했습니다.

범위	상태
자동 업로드·미디어 CI	두 YAML과 stage·dispatch·publish 진입점을 제거했습니다. 새 업로드 브랜치·PR이나 S3 업로드는 실행하지 않았습니다.
기존 고객 영상	CDN URL, 영상·썸네일, 번호별 설명과 재생 컴포넌트는 변경하지 않았습니다.
로컬 보관·초안 PR 규칙	영상·썸네일·ZIP을 Git에서 제외하고 절대 경로와 대응표를 보고하도록 기록했습니다. 최종 URL 미확정 상태의 초안 유지와 재시도·미완료 이월을 포함합니다.
로컬 검사	남아 있는 미디어·영상·변경 이력·고객 문서 분류 테스트 42개와 전체 빌드 23개 작업을 통과했습니다. 가이드 생성, 영상 Git 제외, 현재 변경의 제품 문서 검사도 통과했습니다. 전체 lint는 기존 오류 56개·경고 1,587개·정보 2개로 실패합니다.
예약 실행	매주 금요일 오후 8시(한국 시간)의 Codex 예약 작업을 활성 상태로 등록했습니다. 첫 주간 촬영·초안 PR 생성 성공과 고객 배포는 별도의 확인입니다.
검증 한계	이번 변경에서 새 기능을 촬영하거나 주간 산출물 ZIP을 생성하지 않았습니다. 기존 미디어 ZIP과 보관본을 유지하며, 실제 예약 촬영·GitHub PR 생성·업로드 후 연결은 해당 실행에서 확인해야 합니다.

전체 작업 절차와 기능 마스터를 연결합니다.

일반 개발 에이전트의 문서 작성 의무 제거

사용자의 명확한 요청에 따라 Codex가 CLAUDE.md의 Product Development Record 항목과 .claude/rules/workflow/product-development-record.md 자동 적용 규칙을 제거했습니다. AGENTS.md는 CLAUDE.md를 가리키는 링크이므로 같은 제거가 적용됩니다. 기능 변경 시 개발 기록·사용자 문서·변경 이력을 반드시 작성하거나 후속 문서 PR과 촬영을 수행하라는 공통 의무가 사라집니다.

문서 작업은 지정 PC에 등록된 금요일 오후 8시 예약 작업이 병합된 변경에서 직접 찾습니다. 예약 프롬프트에서도 제거된 규칙 파일 의존성을 없애고, 다른 개발 에이전트의 문서 작성이나 후속 작업 준비를 전제로 하지 않도록 정리합니다. 기존 문서·영상·작성 품질 안내와 로컬 검사 도구는 보존하며 새로운 CI나 자동 강제 검사를 추가하지 않습니다. 다른 PC의 이미 실행 중인 세션과 과거 체크아웃을 원격 변경한 작업은 아닙니다.

제품 변경별 수동 문서 검사 유지

사용자 요청에 따라 check:product-docs 명령과 전용 비교 함수·테스트를 복구했습니다. 변경된 제품 파일에 대응하는 문서·변경 이력의 수정 여부를 Git 비교 기준으로 확인하는 수동 검사입니다. 기능 구현 자체의 누락이나 모든 사용법의 설명 완성도를 판정하지 않습니다. 검사 범위에 맞는 --base를 지정해 사용합니다.

공통 에이전트의 문서 작성 의무와 미디어 Actions는 복구하지 않았으며, 이 명령과 문서 테스트는 커밋 훅·PR 워크플로에 자동 연결하지 않았습니다. 문서 작업은 지정 PC의 주간 예약 담당 범위를 유지합니다.

develop 병합과 원본 가이드 보존

develop의 332dc10ac를 문서 PR에 통합하면서 Git 제외 설정·모듈 소개·기능 마스터·관리자 가이드의 충돌을 해결했습니다. 관리자 Markdown에만 추가돼 있던 일괄 근무 배정, 신청 단위, 연차 기준 변경 예약, 과거 연차 업로드와 개별 통지 버튼 설명은 HTML 원본에 옮겨 재생성했습니다. 업로드 안내는 기존 s7-2b 주소를 가진 하위 제목으로 보존해 뒤따르는 기존 절 주소와 영상 배치를 바꾸지 않았습니다. HR 원본의 상시 시트·버전·고정과 값 목록 필터도 보존했습니다.

랜딩의 한국 네트워크 배포 검사 기록은 랜딩 기능 문서로 옮기고 기존 마스터 진입 주소를 유지했습니다. 미디어 Git 제외와 시스템 관리자 로컬 설정 제외를 모두 적용했습니다. 새로 병합된 업무의 영상은 재촬영하지 않았습니다. 휴가 신청 단위·기준 변경 예약·과거 내역 업로드와 상시 시트·값 목록 필터의 영상 대조·보완은 주간 문서 작업의 미완료 범위입니다.

주간 가이드 소스 대조와 촬영 대기

검토 기준은 134e66e2f32ea3b5995c4d4bbd18795040eba69d입니다. 관리자·직원·급여 가이드 원본과 기능 기록을 보완하고 변경 이력 18건을 unreleased로 보관합니다. 변경 PR별 분류·사용 절차·촬영할 장면을 연결합니다.

확인 범위	상태
병합 PR와 현재 원고 대조	PR 111건을 분류하고 주요 절차를 보완했습니다. 분류만으로 실제 동작 검증이 끝난 것으로 보지 않습니다.
가이드 생성과 링크	원고에서 재생성하며 기존 절 번호를 유지합니다. 빌드·링크 확인 결과는 주간 PR에 남깁니다.
실제 새 영상·썸네일	0건입니다. 실행 중인 예제 환경과 검토 기준 코드가 다르고 녹화 도구 준비가 필요합니다.
영상 주소와 변경 이력	기존 URL·챕터를 유지합니다. 촬영·최종 업로드 주소·고객 배포 확인은 대기입니다.
운영 콘솔과 설치 앱	소스·운영 문서 대조까지만 했습니다. 권한 경계·실기기 업데이트·외부 발송은 미검증입니다.

18개 추가 절차와 기존 영상 원장의 남은 장면은 지정 PC의 다음 촬영 작업으로 이어갑니다. 새 미디어가 없어 빈 ZIP을 만들지 않았습니다.

2026-10-02 회차 검토

145개 병합 PR의 대조 원장을 추가했습니다. 기존 문서 PR 병합과 이번 범위 검토를 분리하며, 이전 미완료 27건을 보존합니다. 새 영상은 지정 PC의 해당 회차 폴더에서 검수·압축하고 최종 주소 대기로 관리합니다. 기존 공개 영상 URL·번호별 시각은 변경하지 않습니다. 실제 검증 결과와 촬영 목록은 이 회차 Draft PR 및 로컬 handoff.md에 기록합니다.

이번 주 추가 촬영과 연결 대기

이번 주 검토 원장에 역할 권한표·직원 AI 진입과 이력·알림 종류와 방해 금지·나의 결재선·대화방 음소거·메시지 입력/전송 영상 6편을 기록했습니다. 총 62개 동작 번호의 장면과 재생을 확인했습니다. 공개 영상 URL과 기존 번호 설명은 그대로 유지하며 새 6편은 최종 주소 대기입니다. 직원 AI의 하단 진입 재촬영은 완료했지만 새 답변 생성과 배포 확인은 완료로 표시하지 않습니다.

메시지 삭제는 예제 화면에서 확인창 없이 처리되는 불일치가 있어 성공 영상에서 제외했습니다. 남은 절차와 이전 회차 이월은 미완료 항목을 따릅니다.

주말 추가 촬영과 연결 대기

주말 검토 기록에 추가 42개 PR의 분류와 새 6편의 실제 조작·미확인 항목을 기록했습니다. 반차 접수, 팀 허용 근무 유형 저장, 팀 근태 조회, 그룹 읽음 상태, PC 주소 보관, 웹 앱 정보 확인을 새로 촬영했습니다. 기존 6편과 이전 회차 파일도 그대로 보존합니다. 새 영상·썸네일은 이 PC에만 있고 공개 URL 및 챕터 교체는 하지 않았습니다. 잠금 조직·두 기기·실제 업데이트·외부 연동 등 미완료 조건을 이번 촬영으로 완료 처리하지 않습니다.

인증·결재·검색의 후속 검토

2026-10-16 주간 원장에서 포함 PR 52건의 분류와 촬영 결과를 확인합니다. 내 정보의 보안 진입, 별도 내부 결재 앱이 없다는 안내, 개인 대화 음소거 제한, 휴대폰 Enter 설명을 정정했습니다. 안전번호·복구 코드는 후속 변경으로 제거됐으므로 과거 미확인 항목을 그대로 새 촬영 대상으로 사용하지 않습니다. 기존 공개 영상·챕터는 최종 주소를 받기 전까지 유지합니다.