제품 개발 기록 — 기능 마스터
현재 기능을 찾고 실제 사용법, 연결되는 데이터·화면, 변경 이유와 검증 근거를 따라가는 마스터 파일입니다. 기능별 상세 문서는 docs/ko/features/<feature-id>.md에 두고 파일명을 안정적인 기능 ID로 사용합니다.
화면·상태·SDK·API·입력 검증을 연결한 기능별 사용 문서입니다. 코드 확인·화면 자료·로컬 실행·배포 검증을 구분하며 기능별로 확인한 범위와 미확인 항목을 기록합니다.
기존 문서 전체 원장 · 검증 결과·불일치·미확인 범위 · 작성·갱신 방법 · 현재 메뉴 진입점 · 사용자 가이드 기능별 영상 원장
사용자 가이드의 영상 단위는 각 세부 기능입니다. 앱당 대표 영상 한 편으로 전체 사용법을 대신하지 않습니다. 기능별 영상 원장에서 항목별 연결·미촬영 범위를 확인합니다.
고객 교육에는 기능별 동작 번호 영상 목록을 사용합니다. 개별 영상 90편·382개 번호 동작을 게시 중인 사용자 가이드 6편의 88개 세부 항목에 연결했습니다. 각 절에서 바로 재생하고 번호를 눌러 해당 장면으로 이동합니다. 별도 앱 개요 영상 8편과 기존 급여 시트 4단계 영상도 유지합니다. 촬영하지 않은 세부 조작은 항목별 원장, 최신 실행·재생 검사는 검증 원장에 구분합니다.
기능별 문서
이번 주 검토 원장에서 마지막 검토 이후 변경과 실제 촬영·미완료 항목을 구분합니다.
각 문서는 진입 조건, 실제 제공 조작, 입력·검증, 단계별 결과, 실패·취소·재시도·재진입, 상하위 기능 관계, 구현 근거를 설명합니다. 지원하지 않는 버튼·숨겨진 경로·알려진 결함도 해당 절에 표시합니다. 화면이 있다고 저장까지 동작한다고 가정하지 않습니다.
계정·조직·인사
| 기능 ID | 현재 사용 문서 | 주요 연결 |
|---|---|---|
authentication | 로그인·OTP·비밀번호 | 조직 선택·계정 연결 |
organization-access | 계정·워크스페이스·팀·역할·설정 | 인사 기록·근태 기준·알림 |
hr-records | 직원·계약·호봉·인사 기록 | 급여 시트·직원 내 정보 |
employee-onboarding | 직원 앱 도입·안내·이용 현황 | 조직 설정·직원 첫 사용 |
employee-profile | 직원 내 정보·서류·전자계약 | 조직의 편집 정책·계약 상태 |
급여·정산
| 기능 ID | 현재 사용 문서 | 주요 연결 |
|---|---|---|
payroll-sheets | 급여 시트·수식·반영·확정 | 인사·근태 원천과 수당/공제 기록 |
scheduled-changes | 계약·시트 예약 변경 | 계약 기간·시트 이력·소유자 권한 |
statutory-deductions | 법정공제·계산 기준·확정 검사 | 조직 파라미터·시트·명세서 |
payroll-distribution | 급여명세서 공개·전자서명 연동 | 직원 앱·계약·외부 서명 상태 |
incentives | 치료·인센티브 등록과 승인 | 치료 설정·승인·급여 반영 |
근태·신청·결재
| 기능 ID | 현재 사용 문서 | 주요 연결 |
|---|---|---|
attendance-leave | 출퇴근·휴가·연장·외근·마감 | 근무 기준·승인·급여 원천 |
approvals | 신청·문서·자격증 결재 | 직원 신청·서식·알림 |
approval-lines | 개인·팀·병원 결재선과 단계별 처리 | 신청 확인·순서별 승인·알림 |
annual-leave-promotion | 연차사용촉진 | 연차 잔여·시기 지정·전자서명 |
scheduling | 근무표·병동·환자 수·규칙 검증 | 직원·연차·근태·인력 지표 |
운영·협업
| 기능 ID | 현재 사용 문서 | 주요 연결 |
|---|---|---|
general-affairs | 공지·교육·정기업무 | 대상 팀·직원 확인·메신저 |
inventory | 재고 품목·수량·제조사 | 대시보드·입출고 이력 |
management-dashboard | 경영 지표·청구 금액·인력 | 급여·간호사 프로필·환자 수 |
drive | 폴더·업로드·접근·내부 공유 | 조직 권한·파일 저장소 |
notifications | 알림 조회·설정·목적지 이동 | 결재·촉진·급여·신고·메신저 |
messaging | 개인·그룹·팀 대화·파일·공지 | 직원·대화 권한·업무 알림 |
ai-assistant | AI 질문·대화 이력·도킹 | 조직 AI 설정·읽기 도구·현재 화면 |
sheet-assistant | 시트 AI·변경 미리보기·되돌리기 | 시트 선택 범위·사용 한도·급여 흐름·변경 이력 |
cs-reports | 불편·기능 신고·첨부·답변 확인 | 오류 진단·운영자 회신·알림 |
도입·플랫폼 도구
| 기능 ID | 현재 사용 문서 | 주요 연결 |
|---|---|---|
landing | 공개 랜딩·데모·상담 신청 | 실제 기능·영업 메일·가이드 |
importer | 엑셀 이관 CLI·시트 탭 | 직원·팀·급여·원천 시트 |
module-manager | 계산기 레지스트리·테스트 | 현재 조직의 급여 집계 |
system-admin | 플랫폼 운영 콘솔 | 조직·직원·CS·연동·템플릿 |
개발·기록
| 기능 ID | 현재 사용 문서 | 주요 연결 |
|---|---|---|
frontend-performance | FE 성능·측정·기존 동작 영상 | 급여 시트·근무표·로딩 |
interface-patterns | 공통 화면·디자인 시스템 | 강제 규칙의 정본·관련 기능 |
development-operations | 개발·배포·DB·외부 연동 | 실행 스크립트·운영 문서 |
documentation-workflow | 문서 작성·이미지·갱신 책임 | 마스터·기능 파일·원본 가이드·PR 검토 항목·기능 이름으로 설명 연결·사용 대상·시작 위치 표 |
업무와 데이터의 연결
연결선은 관계를 표시하며 모든 단계가 자동으로 연속 실행된다는 뜻은 아닙니다. 예를 들어 승인된 원천과 시트 반영·급여 확정은 별도 단계이고, 명세서 공개는 전자서명 요청·메일 발송과 다릅니다. 세부 조건은 각 기능의 사용 순서를 따릅니다.
기존 문서를 읽는 기준
| 기존 종류 | 역할 | 현재 정리 방식 |
|---|---|---|
| 사용자 가이드 HTML·생성 Markdown | 화면 중심 따라 하기 | 확인한 불일치를 원본 HTML에서 수정하고 재생성, 관련 사용자 절차로 연결 |
| 앱 소개 | 대상 사용자·큰 범위 | 현재 기능과 맞지 않는 보장을 고치고 상세 사용법 연결 |
| Confluence 사양 | 요구·설계의 출처 | 동기화 원본 유지, 현재 구현 여부는 기능 문서에서 구분 |
| 개발 계획·날짜별 변경 설명 | 결정·변경 이유·실측 | 날짜를 보존하고 현재 기능 링크 추가, 과거 수치를 현재 실측으로 바꾸지 않음 |
| 디자인 시스템 | UI 강제 규칙과 데모 | 기존 페이지가 정본, 관련 기능을 연결하며 규칙 복제 안 함 |
| 정책·운영·패키지 문서 | 제도·배포·구조 참고 | 전체 원장에 분류, 현행 법령·실제 인프라 적용은 별도 확인 대상으로 표시 |
파일 하나씩의 경로와 분류는 전체 원장에 있습니다. 원장에 있다는 사실은 본문의 모든 외부 사실을 검증했다는 뜻이 아닙니다.
변경 때의 책임
사용자가 체감하는 추가·변경·수정·종료는 이력 원본 docs/product-changes/<feature-id>/<change-id>.json에 한 번 기록하고 관련 가이드 절을 모두 연결합니다. 주제 끝에는 최근 공개 이력 2건, 전체 변경 이력에는 모든 공개 항목을 표시합니다. 실제 적용일·배포 근거·문서와 영상 검토를 확인한 뒤 공개하며, 원본의 기술 근거는 고객 이력에 넣지 않습니다. Codex가 생성기·원본 검증·변경 파일 검사를 추가하고 첫 코드 확인 항목을 적용 확인 전 상태로 등록했습니다. 작성과 공개 절차, 검증 범위를 따릅니다.
사용자의 지정 PC에 등록된 주간 문서 예약 작업이 병합된 기능 변경을 확인해 해당 기능 파일과 이 마스터를 갱신합니다. 일반 기능 개발 에이전트에게는 문서 수정 의무를 부여하지 않습니다. 사용 절차를 빠짐없이 적고, 실제 캡처의 번호·화살표를 본문 순서와 맞춥니다. 드래그·화면 전환 등에는 동작 영상을 우선 사용합니다. 본문과 캡션은 날짜 안내 없이 조작·결과를 설명합니다. 촬영 날짜·버전은 원본 메타데이터에서 관리하고 실제 화면 차이와 미확인 조작은 기능 문서에 남깁니다. 자세한 기준은 작성·갱신 방법을 따릅니다.
기존 단일 기록에서 기능별 파일 구조로 전환하고 미기록 기능을 코드 기준으로 보완했습니다. 이번 작업에서 발견한 실제 동작 차이·문서 반영·미확보 장면·검사 결과는 검증 원장에 계속 남깁니다.
8개 앱의 대표 사용 흐름을 별도 DB의 로컬 예제 조직에서 촬영하고, 개요 영상의 번호 자막·강조·확대 형식을 공통 촬영 코드로 정리했습니다. 전체 사용법은 각 기능 파일에 유지하며, 촬영으로 확인한 범위와 후속 미확인 작업은 촬영 원장에 구분합니다.
각 사용자 가이드 항목 바로 아래에 기능 영상을 배치하고 생성 원본·영상 메타데이터·번호 탐색을 연결했습니다. Codex가 진입·입력·저장·결과를 촬영하면서 해당 기능 기록을 직접 갱신했습니다. 급여 집계 중복 조건은 확인한 사용상 주의사항으로 남겼고, 전체 급여 계산이 검증된 것처럼 안내하지 않습니다. 새 페이지 이동의 스크롤 동작은 수정하지 않았습니다.
이전 진입 링크
기존 마스터의 앵커를 유지합니다.
알림
급여 시트 성능
스케줄러 첫 진입
기록 갱신
화면·영상
필수 기록 항목
문서의 본문·제목·이미지·영상 설명은 작성·촬영 시점을 반복하지 않고 사용 절차 중심으로 정리했습니다. Codex가 가이드 생성 원본과 작성 규칙도 함께 갱신했습니다. 작성 기준과 변경 범위를 참고하세요.
사용자 가이드·온보딩·영상의 글 설명을 업무 용어로 다듬었습니다. 실제 버튼 이름과 저장·권한·다른 기기 사용의 차이는 유지하며, 구현 근거는 기능 개발 기록에 둡니다. 사용자 가이드 작성 기준을 참고하세요.
사용자용 홈·핵심 기능·가이드·온보딩의 검색·본문·영상 링크를 사용자 문서 안에서 연결하도록 분리했습니다. 공통 상단 메뉴는 모든 페이지에서 유지해 개발 문서에도 바로 접근할 수 있습니다. Codex가 가이드 원본과 공통 영상 목적지를 직접 갱신하고, 팀 관리자 승인·재고 수량 조정·모듈 조회 절차를 보완했습니다. 개발 기록과 FE 성능 자료는 개발 경로에서 계속 관리합니다. 탐색 구조와 유지보수 기준 · 검증 결과.
메디컬 랜딩 약관의 정적 HTML 제공
약관 열람과 정적 HTML 제공의 실제 사용법·구현·검증을 확인합니다. 기존 개발 기록의 진입 주소를 유지하며, 원문은 랜딩 기능 문서에서 이어집니다.
스테이징 배포 검사의 국가 제한
한국 네트워크의 배포 확인 결과와 실행 절차를 확인합니다.
주간 문서·영상 작업과 파일 전달
Codex가 사용자 요청에 따라 미디어 업로드·검증 Actions와 임시 S3 전달 명령을 제거하고, 주간 초안 PR과 PC 보관·ZIP 전달 방식으로 작업 절차를 갱신했습니다. 이후 공통 에이전트 지침의 기능 변경 시 문서 갱신 의무도 제거해, 이 PC의 예약 작업에서만 문서 작업을 수행하도록 정리했습니다. 문서·영상의 실제 사용법과 번호 형식은 유지하며 새 미디어는 Git에 넣지 않습니다. 담당·전체 실행·압축파일·최종 주소 연결, 문서 갱신 책임, 검증과 미확인 범위를 연결합니다. 기존 CDN 연결과 Git 제외 이력은 외부 주소 연결에 보존합니다.
기능 개발과 문서·영상의 PR 연결
기능 PR의 구현·테스트를 확인한 뒤 지정 PC의 주간 문서 PR에서 개발 기록·사용자 가이드·최종 촬영을 정리합니다. 일반 기능 PR에 문서 수정이나 후속 문서 PR 생성을 요구하지 않습니다. Codex가 이력의 담당자·기능 PR·후속 연결 검사와 완료 시 사용법 원본 검사, 규칙과 등록 안내를 함께 갱신했습니다. 문서·영상이 대기 중이면 고객 이력에는 표시하지 않습니다. 작성 책임과 실제 순서, 촬영·등록 실행, 검증 범위를 연결합니다.
직접 업로드한 영상 주소 연결
Codex가 인프라에서 수동 업로드한 영상 99편과 썸네일 99개를 공통 CDN 주소에 연결하고, 전체 파일 내용·형식과 영상의 구간 응답을 대조했습니다. 앱 개요 8편·기능별 90편·기존 급여 시트 1편을 포함합니다. 기존 번호·사용법을 보존하며 실제 사용 위치, 연결·검사·복구 절차, 구현과 유지보수 기록, 검증 범위를 연결합니다. 사용자의 PR 정리 요청에 따라 새로 추가한 영상·썸네일 98쌍은 로컬 보관 폴더로 옮기고 Git에서 제외했습니다. 기존 랜딩 데모의 한 쌍은 유지하며 고객 문서 배포·Actions 자동 등록·Git 이력 재작성은 수행하지 않았습니다.
주간 가이드 보완과 촬영 대기
휴가 추천 사유·직무 기본 근무·직원 마스터·통합 근무기록·증명서 출력·팀별 대화·알림·공유와 설치 앱 안내를 병합 소스에 맞춰 보완했습니다. 주간 변경별 근거와 촬영 목록, 검증 결과와 남은 범위를 함께 확인합니다. 실제 촬영·고객 배포를 확인하지 않은 변경 이력은 공개하지 않습니다.
주간 갱신의 검토 범위
병합 변경과 문서·영상 대응 원장에 이번 주 대상과 남은 검증을 기록했습니다. 시트 AI, 파일 가져오기·계약 기준, 근로형태 가져오기, 운영 콘솔을 연결합니다. 사용자 가이드는 현재 조작을 설명하고, 내부 검토 원장과 운영 문서는 고객용 본문에서 링크하지 않습니다.
2026-10-02 주간 검토 원장에서 이전 검토 이후 병합 PR 전체, 현재 반영·촬영·업로드 대기와 이월 항목을 확인합니다.
주간 기록의 주말 보강에서 추가 변경 42개와 촬영 6편의 기능별 대응을 확인할 수 있습니다.