주간 문서 검토 기록: 2026-09-21~25
이 기록은 해당 주에 병합된 변경과 사용자 문서·영상의 대응을 관리합니다. 이전 주 문서 PR #798이 병합됐다는 사실은 이번 주 변경 검토의 완료 조건이 아닙니다.
검토 대상은 GitHub에서 확인한 develop 병합 PR 61건입니다. 끝 커밋은 35e76aa4168666d4094cad99c0bf51ba757f5906이며, 이전 촬영 기준 134e66e2f32ea3b5995c4d4bbd18795040eba69d와 이전 문서 병합 f99c0687b3c596cbb5ce2437e3a11e74c242ab26을 구분합니다. 이전 PR에 포함된 항목은 재등록하지 않고 이후 사용법 차이를 검토합니다. 모든 PR의 모든 기능을 실제 실행했다는 뜻은 아닙니다.
사용자는 파일을 올린 뒤 열을 확인하고 승인하는 방법, 시트 AI 변경 제안을 검토하는 방법, 근로형태를 가져와 계약 값을 적용하는 방법을 가이드에서 따라 할 수 있습니다. 기존 가이드는 이 절차 일부를 생략하거나 이전 화면을 설명했습니다. HTML 원고를 고친 뒤 기존 절 주소를 유지해 사용자 가이드를 다시 생성하고, 구현 근거는 기능별 개발 기록에 연결합니다.
변경 전
변경 후
분류와 대응
| 영역 | 처리 | 범위와 한계 |
|---|---|---|
| 근무 판정 기준 | 기존 기록 대조·검증 대기 | 근무표·직원 배정·팀 기본·조직 기본의 판정 경로를 기존 shift-resolution 기록과 대조합니다. 세콤 입력부터 근태 결과까지 전체 흐름은 가상 연동 환경에서 별도 확인합니다. |
| 이전 회차·사양서 | 기존 기록 유지 | 이전 주 문서·사양서·개발 계획 자체는 새로운 사용자 조작으로 중복 등록하지 않습니다. |
| 직무·근로형태 | 문서 보완·촬영 | 관리자 가이드와 인사 기록을 보완합니다. 기존 직무 영상은 재촬영하되 직원 등록 자동값·재적용 대상이 있는 예외는 남은 확인으로 유지합니다. |
| 조직 설정·화면 진입 | 문서 보완·촬영 | 근무 설정 진입·활성 소속 검색·역할 명칭·전체화면과 Esc 사용법을 대조합니다. |
| 시트 AI | 문서 보완·연동 촬영 대기 | 시트 전용 가이드와 개발 기록을 작성합니다. 실제 모델 답변·제안 적용·충돌·신고 전송은 외부 모델 연동 없는 환경에서 검증하지 않습니다. |
| 파일 가져오기 | 문서 보완·촬영 | 열 연결·검증·승인·원본 대조와 휴지통 되돌림을 문서화합니다. 여러 탭·중복 사번·미연결·변환 불가 수식은 추가 촬영 범위입니다. |
| 시트 편집·계약 기준 | 문서 보완·촬영 | 여러 행 우클릭 대상, 열 종류 선택과 계약 월·조직 기준을 보완합니다. 다중 계약 금액 대조는 별도 예제 구성이 필요합니다. |
| 운영 콘솔 | 운영 문서 보완·촬영 대기 | 세션·AI 모니터·지문 예제/수정/삭제·목록·CS 연결을 기록합니다. 독립 운영자 인증과 가상 관리 DB 연결 환경이 없어 운영 화면 실조작은 미확인입니다. |
| 성능·공통 SDK | 개발 기록 보완 | 조회 시점·중복 로딩과 스타일 개선을 기록합니다. 페이지별 전후 시간은 측정하지 않았으며 새로운 고객 조작으로 만들지 않습니다. |
| 직원 앱·증명서 | 기존 사용법 보완·환경 확인 대기 | 증명서 미리보기 경로는 유지됩니다. 안드로이드 뒤로가기는 실기기 검증이 필요하므로 브라우저 영상으로 대체하지 않습니다. |
| 검사·배포 설정 | 내부 변경·고객 사용법 유지 | 검사 경로 오탐과 배포 캐시 변경은 사용자가 조작하는 화면 변경이 아닙니다. 배포 성공·미디어 재생 완료로 간주하지 않습니다. |
병합 PR 원장
| PR | 변경 | 대응 문서 | 처리 |
|---|---|---|---|
| #797 | docs(spec): sync 2026-09-17 잔여분 — 근태 다운로드·직원/팀 관리·급여대장 8건 | documentation-workflow | 기존 기록 유지 |
| #798 | docs(guides): sync weekly feature procedures | documentation-workflow | 기존 기록 유지 |
| #799 | feat(cs-report): add awaiting_release status between in_progress and resolved | system-admin | 운영 문서 보완·촬영 대기 |
| #800 | feat(system-admin): create the first sysadmin account from the sign-in screen | system-admin | 운영 문서 보완·촬영 대기 |
| #801 | feat(admin): split job duty settings into its own tab with list and mapping views | hr-records | 문서 보완·촬영 |
| #802 | fix(components): interpolate the job duty name in the default shift notice | hr-records | 문서 보완·촬영 |
| #803 | perf(hr-system): defer new-sheet template loading | frontend-performance | 개발 기록 보완 |
| #806 | feat(admin): open the shift settings popup from employee and team management | organization-access | 문서 보완·촬영 |
| #807 | feat(settings): let each organization rename the role term shown in the UI | organization-access | 문서 보완·촬영 |
| #808 | feat(admin): fullscreen toggle for scheduler and sheet pages | organization-access | 문서 보완·촬영 |
| #809 | fix(admin): show only active teams and roles in the employee affiliation pickers, with search | organization-access | 문서 보완·촬영 |
| #810 | feat(ai): mount the sheet assistant in hr-system behind a per-organization module toggle | sheet-assistant | 문서 보완·연동 촬영 대기 |
| #812 | feat(ai): add read-only sheet tools, a static formula validator, and a guide index | sheet-assistant | 문서 보완·연동 촬영 대기 |
| #813 | fix(admin): close open windows before leaving fullscreen, add Ctrl+Shift+F | organization-access | 문서 보완·촬영 |
| #814 | perf(admin): load reference data for the active page | frontend-performance | 개발 기록 보완 |
| #815 | feat(ai): show token usage, warn at budget thresholds, and report answers to CS | sheet-assistant | 문서 보완·연동 촬영 대기 |
| #817 | docs(spec): sync 2026-09-21 — 시트 AI 어시스턴트 E1·직무 설정 탭·근무형태 판정 출처·조직 용어·전체화면 13건 | documentation-workflow | 기존 기록 유지 |
| #818 | perf(components): defer employee panel reference loading | frontend-performance | 개발 기록 보완 |
| #819 | fix(sdk): keep store.t working when called without its store | frontend-performance | 개발 기록 보완 |
| #820 | perf(hr): consolidate payroll period loading | frontend-performance | 개발 기록 보완 |
| #821 | feat(sheets): add change sets with preview, apply, and revert for AI bulk edits | sheet-assistant | 문서 보완·연동 촬영 대기 |
| #822 | feat(sheet-ai): propose column layout changes as change sets (E2) | sheet-assistant | 문서 보완·연동 촬영 대기 |
| #823 | feat(work-pattern): work pattern master with derived contract hours and hourly rate | hr-records | 문서 보완·촬영 |
| #824 | fix(ai-assistant): enable change-set card buttons on server-hydrated cards | sheet-assistant | 문서 보완·연동 촬영 대기 |
| #825 | feat(system-admin): remember-me sessions and own-session management | system-admin | 운영 문서 보완·촬영 대기 |
| #826 | refactor(attendance): resolve secom shifts with the shared ladder | shift-resolution | 기존 기록 대조·검증 대기 |
| #827 | feat(sheet-ai): payroll cycle assistant tools and stage grounding (E5) | sheet-assistant | 문서 보완·연동 촬영 대기 |
| #828 | refactor(attendance): align shift assignment and resolution ladders | shift-resolution | 기존 기록 대조·검증 대기 |
| #832 | feat(sheet-import): mapping step, validation report, and import change sets for uploads (E4) | payroll-sheets | 문서 보완·촬영 |
| #835 | feat(system-admin): fingerprint event test data with provenance and self-service edit | system-admin | 운영 문서 보완·촬영 대기 |
| #836 | fix(sheet-import): revert lands the sheet in trash and keeps value-less formulas | payroll-sheets | 문서 보완·촬영 |
| #837 | fix(docs): stop analytics registry test false-positive on -import- route segments | documentation-workflow | 내부 변경·고객 사용법 유지 |
| #838 | fix(system-admin): fingerprint test-data bugs found in dev QA | system-admin | 운영 문서 보완·촬영 대기 |
| #839 | fix(system-admin): sync select display after options render and show change stamps in org timezone | system-admin | 운영 문서 보완·촬영 대기 |
| #840 | docs(internal): record sheet AI follow-up tickets in the development plan | documentation-workflow | 기존 기록 유지 |
| #841 | feat(system-admin): warn one minute before auto-logout and reset to login when the session ends | system-admin | 운영 문서 보완·촬영 대기 |
| #842 | fix(system-admin): keep the original raw code selected in the edit modal and keep notices after refresh | system-admin | 운영 문서 보완·촬영 대기 |
| #843 | fix(team-manager): render certificate previews for legacy request rows and approved rows without stored HTML | 직원 알림·뒤로가기 · 증명서 | 기존 사용법 보완·환경 확인 대기 |
| #844 | feat(system-admin): soft-delete fingerprint events with provenance and attendance rollback | system-admin | 운영 문서 보완·촬영 대기 |
| #849 | fix(employee-app): make Android back close the notification screen and report popup | 직원 알림·뒤로가기 · 증명서 | 기존 사용법 보완·환경 확인 대기 |
| #850 | fix(admin): keep the generic AI widget hidden on the sheets embed | sheet-assistant | 문서 보완·연동 촬영 대기 |
| #851 | fix(employee): apply job duty default shift to existing employees and surface mismatches | hr-records | 문서 보완·촬영 |
| #852 | perf(design-system): drop :has() selectors and truncate long shift badges | frontend-performance | 개발 기록 보완 |
| #853 | fix(sheets): show the sheet assistant FAB inside the admin embed and dodge its dock | sheet-assistant | 문서 보완·연동 촬영 대기 |
| #854 | fix(system-admin): server-side pagination and search for the organization list | system-admin | 운영 문서 보완·촬영 대기 |
| #855 | feat(system-admin): shareable CS report deep link + transition form starts at current state | system-admin | 운영 문서 보완·촬영 대기 |
| #856 | fix(admin): work pattern form save guidance and even grid columns | hr-records | 문서 보완·촬영 |
| #857 | feat(admin): import work patterns from shift groups | hr-records | 문서 보완·촬영 |
| #860 | docs(spec): sync 2026-09-22 — 운영자 세션 관리·시트 변경 세트/임포트·직무 기본 근무 재적용 등 11편 | documentation-workflow | 기존 기록 유지 |
| #861 | chore(cicd): reduce dev deployment work and cache site dependencies | documentation-workflow | 내부 변경·고객 사용법 유지 |
| #862 | chore(cicd): add cache write permission in develop branch and update … | documentation-workflow | 내부 변경·고객 사용법 유지 |
| #863 | feat(system-admin): add AI monitoring tab and record failed AI turns with a report path | system-admin | 운영 문서 보완·촬영 대기 |
| #864 | fix(system-admin): make the bundle source CloudFront check honor Node's autoSelectFamily lookup contract | system-admin | 운영 문서 보완·촬영 대기 |
| #866 | feat(system-admin): paginate app version bundles | system-admin | 운영 문서 보완·촬영 대기 |
| #867 | fix(hr-system,admin): column-kind radio, formula-bar caret alignment, employee filter persistence | payroll-sheets | 문서 보완·촬영 |
| #868 | fix(sheets): apply row delete/protect from the context menu to every selected row | payroll-sheets | 문서 보완·촬영 |
| #869 | feat(work-pattern): derive schedule text and standard hours from the linked shift | hr-records | 문서 보완·촬영 |
| #871 | feat(system-admin): index Bundle candidates for fast listing | system-admin | 운영 문서 보완·촬영 대기 |
| #872 | fix(ai): keep formula columns as formula when a layout change set only edits the formula | sheet-assistant | 문서 보완·연동 촬영 대기 |
| #873 | feat(sheets): resolve identity contract fields by the sheet period with an org-level basis | payroll-sheets | 문서 보완·촬영 |
| #874 | feat(admin): unify the three settings tables and add header help tooltips | hr-records | 문서 보완·촬영 |
촬영과 공개의 경계
개인정보가 없는 가상 조직과 격리 브라우저에서 영상 10편과 썸네일 10개를 제작했습니다. 검은 안내판과 주황색 동작 번호·강조 표시를 사용했으며, 전체화면 촬영의 잘림을 수정한 뒤 다시 촬영했습니다. 각 영상의 브라우저 재생·중간 이동·샘플 프레임과 썸네일을 확인했습니다. 영상과 썸네일·촬영 JSON·전달 ZIP은 지정 PC에만 보관하며 PR에는 포함하지 않습니다. 기존 공개 영상의 주소·번호·재생 시각은 새 파일의 최종 주소와 일치가 확인되기 전까지 유지합니다. 새 촬영이 끝나도 업로드·문서 연결·실제 고객 배포는 별도 확인입니다.
이전 회차에서 남은 직원 등록 기본값·급여 재반영·메신저 초대·알림 실패·익일 근태·재입사·권한별 시트 접속·모바일 실기기·증명서 승인·마스터 반영 예외·팀 일괄 변경·휴가 이력·전자서명 연동·직원 홈 구성은 로컬 주간 원장에 계속 남깁니다. 이번 주 PR 생성만으로 닫지 않습니다.
실제 촬영 범위
| 영상 | 확인한 동작 | 남은 확인 |
|---|---|---|
| 근로형태 가져오기 | 근무 그룹에서 가져오기·예제 직원 연결·재조회 | 신규 직원 등록 |
| 근로형태 수정 | 근무시간 수정·18명 재계산 미리보기·적용·재조회 | 개별 수동값 보존 예외 |
| 직무 설정 | 독립 탭의 목록·매핑표·재적용 대상 없음 | 실제 대상 재적용·직원 등록 자동 배정 |
| 조직 용어와 계약 기준 | 역할 명칭·계약 기준 저장·다시 열기 | 여러 계약의 월별 금액 대조 |
| 시트 전체화면 | 전체화면·새 시트 창·Esc·저장하지 않고 닫기·원래 화면 | 스케줄러·브라우저별 차이 |
| 파일 가져오기 | 가상 CSV 3행 사번 연결·검증·승인·원본·생성 결과 | 여러 탭·중복·미연결·수식 예외 |
| 여러 행 보호 | 선택 2행 보호·해제·선택 밖 우클릭 | 권한별 예외 |
| 가져오기 되돌리기 | 변경 이력에서 되돌리기·휴지통 이동 | 직원 연결을 포함한 되돌림 대조 |
| 시트 AI 패널 | 최초 안내·질문 입력·대화 목록 | 모델 답변·제안 적용·취소·되돌리기·사용 한도 |
| 여러 행 삭제 | 3행 중 선택 2행 삭제·남은 1행 확인 | 실패와 복구 |
새 변경 이력 7건과 기존 2건을 문서에 연결하되 실제 배포와 미디어 공개 전이므로 unreleased를 유지합니다. 후속 확인은 Draft PR #879에 연결했습니다.
완료 판정
주차별로 검토한 소스 범위, 문서 반영, 실제 촬영, 영상 검수, Draft PR, 파일 전달, 최종 URL 연결, 배포 확인을 각각 기록합니다. 이전 주 PR의 병합 여부나 새 PR 생성만으로 다음 주를 완료 처리하지 않습니다. 영상이 불가능한 항목은 구체적인 장면과 필요한 환경을 보존하며 정상 촬영 범위와 섞지 않습니다.