개발·배포·운영 문서 연결

제품 개발 기록으로 · 기존 문서 원장 · FE 성능

저장소의 실행 스크립트·규칙과 운영 문서를 연결합니다. 배포·DB 변경을 실행한 기록은 아닙니다.

개발에서 사용하는 순서

1. 시작하기의 개발 환경과 저장소 루트 package.json, pnpm-workspace.yaml을 확인합니다. 비밀 설정은 환경 파일로 제공하고 문서·캡처에 값을 넣지 않습니다.
2. 아키텍처, 패키지에서 앱·SDK·API·Core·DB 경로를 확인합니다. 실제 작업 기능 문서에서 어떤 데이터가 어느 화면으로 연결되는지 먼저 추적합니다.
3. 의존성은 잠금 파일을 기준으로 설치합니다. 이 정리에 사용한 명령은 CI=true pnpm install --frozen-lockfile이며 Node 24.15.0·pnpm 11.21.0 환경입니다. 이는 다른 개발 환경의 필수 버전을 새로 정하는 규칙이 아닙니다.
4. 로컬 실행은 해당 앱의 package.json 스크립트를 사용합니다. 이번 랜딩 확인은 pnpm --filter @hereby/landing dev --host 127.0.0.1 --port 4302입니다. 로그인 앱은 API·DB·조직·역할·테스트 데이터가 추가로 필요합니다.
5. 생성된 사용자 가이드는 pnpm gen:docs-guides로 재생성하고 docs는 pnpm --filter @hereby/docs build로 확인합니다. 기능 변경의 필수 검증은 .claude/rules/workflow/lint-build-verification.md에 따라 pnpm lint:check와 pnpm build, 필요한 도메인 테스트를 수행합니다.
6. 테스트 결과와 실제 UI·배포 확인은 분리해 기능 문서 및 검증 원장에 기록합니다. 기존 오류가 있으면 파일·규칙·개수·로그와 변경 범위를 비교하고 무관한 코드를 일괄 수정하지 않습니다.

배포·DB·외부 연동

작업	기존 문서	확인해야 할 연결
배포	배포 가이드	실행 스크립트·환경·대상 커밋·아티팩트·서비스 주소, 원격 배포 결과
DB·마이그레이션	DB 운영	새 엔티티·열·enum과 조회·시드·테스트, 데이터 보존·복구 절차
모니터링	모니터링	환경·에러·로그, 사용자 신고 requestId·발생 화면 연결
오류 대응	문제 해결	재현 조건·부분 성공·재시도, 역할·조직 범위
출입 연동	세콤 연동	외부 수신·직원 매칭·근태 반영. 문서 존재와 실제 장비 연결은 별개
도입·데이터 이관	온보딩, 임포터	가져오기 대상·기간·기존 데이터 덮어쓰기·후속 급여 집계

랜딩 배포 후에는 실제 CDN의 /, 중첩·후행 슬래시·슬래시 없는 주소, 직접 파일, 존재하지 않는 경로를 확인합니다. HTTP 상태와 body·title·canonical·robots를 함께 대조합니다. 잘못된 경로에 홈페이지가 200으로 반환되면 정상 404가 아닙니다. 도입 상담은 응답 형태와 내부 전송 결과까지 확인해야 하며 단순 HTTP 200만으로 접수 성공을 선언하지 않습니다.

유지보수와 근거

기존 운영 문서에는 날짜가 다른 절차·예시가 섞여 있을 수 있습니다. 이 정리는 파일별 위치와 연결을 정리한 것이며 인프라 계정·배포 설정·외부 장비·법령 적용을 전부 재검증한 작업은 아닙니다. 작업할 때 실행할 스크립트와 대상 환경을 먼저 대조하고 드리프트를 해당 문서에 날짜와 함께 수정합니다. 법·세율의 현행성은 기능 코드 검토만으로 확정하지 않습니다.

• 현재 루트 스크립트
• 검증 규칙

개발·운영 참고문서를 기능 마스터에 연결하고 문서 빌드·전체 검사·실제 배포 검증의 차이를 명시했습니다.