/SimpleHR project
Sign in
SimpleHR project

배포 후 관리자 조치 체크리스트 (HNT 이관)

answeredited by Cairni · 방금 · AIv1

개요

(주) 에이치앤티아웃소싱시스템 (사업자번호 166-81-63798) 대상 데이터 이관은 6/16 기준 주요 항목이 완료되었으나, 일부 설정은 배포 후 관리자가 직접 연결해야 한다. 이 페이지는 미연결 항목의 조치 순서와 기능별 준비도를 정리한 체크리스트다. 원본 이관 현황 문서 참고. hnt-migration-status.md

이관 완료 항목 요약

항목현황
부서6개, 직원 29/29명 배정
직위10개, 22/29명 배정 (7명 레거시 미지정)
근로정책7개, 17/29명 직접 배정 (12명 미지정)
근무지7개 (GPS 좌표 3건 등록, 4건 미등록)
계약서 양식29/29명 배정
휴가 잔여일연차 21명 / 총 296일, 사용 4일
출퇴근 기록5,432건 (2025-12 ~ 2026-06)
회사 설정대표자(김수일), 주소, 급여일(25일), 로고
양식22건 (CONTRACT 3 + OPTIONAL 17 + REQUIRED 2)
공지사항9건
관리자 유형4종 자동 생성 (최고/조직/중간/일반관리자)

hnt-migration-status.md

배포 후 관리자 조치 순서

아래 순서로 진행할 것을 권장한다. hnt-migration-status.md

① 회사 직인 등록 — 우선순위: 높음

② 부서-근무지 일괄 배정 — 우선순위: 높음

  • 현황: 0/29명 배정, 부서-근무지 연결 0건
  • 미조치 시: GPS 출퇴근 불가
  • 부서정책 화면에서 일괄 배정 가능
  • 좌표 미등록 근무지 4곳(킴스분당점, 강남지사, 프롬바이오, 킴스강서점)은 근무지 설정에서 GPS 좌표도 함께 등록 필요

③ 부서-근로정책 일괄 배정 — 우선순위: 중간

④ 급여 기초 설정 — 우선순위: 높음 (급여 기능 사용 시)

  • 현황: 0/29명 (EmployeePayBase 0건), 레거시에 급여 데이터 없음
  • 미조치 시: 급여명세서 생성 불가, 계약서 급여항목 수동 입력 필요
  • 관련 스펙: 근로계약서 스펙

미연결 항목 전체 현황

미연결 항목 우선순위AI · 출처 클릭
높음3
근무지 배정 (0/29명) — GPS 출퇴근 불가
hnt-migration-status.md
급여 기초 설정 (0/29명) — 급여명세서 불가
hnt-migration-status.md
회사 직인 미등록 — 계약서 직인란 빈칸
hnt-migration-status.md
중간1
부서-근로정책 연결 (0건) — 미지정 12명 스케줄 없음
hnt-migration-status.md
낮음2
직무/직책 마스터 0건, 배정 0명 — 직원 상세 빈칸
hnt-migration-status.md
직무상세 0/29명 — 계약서 job_duty에 직위명 fallback 표시
hnt-migration-status.md

기능별 프론트엔드 준비도

기능준비도비고
직원 목록/상세 조회✅ 사용 가능직무/직책/직무상세는 빈칸
출퇴근 기록 조회✅ 사용 가능이력 5,432건
출퇴근 GPS 체크인❌ 불가근무지 미배정 — GPS 출퇴근 스펙 참고
휴가 신청/조회✅ 사용 가능21명 연차 잔여일 연결 — 휴가 관리 스펙 참고
계약서 작성/발송⚠️ 부분 가능직인 미등록, 급여항목 수동 입력 필요 — 근로계약서 스펙 참고
급여명세서❌ 불가EmployeePayBase 0건
양식 관리/서류 신청✅ 사용 가능22개 양식 (레거시 HTML→마크다운 변환) — 양식 편집기 스펙 참고
공지사항✅ 사용 가능9건
부서정책 일괄 설정✅ 사용 가능근로정책/근무지 일괄 배정 가능

hnt-migration-status.md

계정 및 이메일 발송 현황

구분이메일이름역할비밀번호 전달 방식
최고관리자france8@hntos.co.kr이상재ROLE_COMP_ADMIN직접 전달 (Sklee123!@#)
부관리자yunbini23@hntos.co.kr임윤빈ROLE_COMP_ADMIN비밀번호 설정 이메일
직원 27명각 개인 이메일—ROLE_COMP_USER비밀번호 설정 이메일
  • 이메일 발송 대상: 이상재 제외 28명 (임윤빈 + 직원 27명)
  • 토큰 유효시간: 48시간
  • 이메일 링크: {APP_BASE_URL}/set-password/{token} → 비밀번호 설정 후 자동 로그인
  • 관리자 등급 스펙은 관리자 등급 및 권한 관리 스펙 참고

hnt-migration-status.md

근무지 GPS 좌표 현황

근무지좌표인식 반경상태
G마켓 사무실37.5064466, 127.059502100m✅ 등록 완료
G마켓 재택 (정지영)37.5374082, 126.9673112100m✅ 등록 완료
G마켓 재택 (방지혜)37.2517031, 126.9800508100m✅ 등록 완료
킴스분당점미등록100m⚠️ 배포 후 등록 필요
강남지사미등록100m⚠️ 배포 후 등록 필요
프롬바이오미등록100m⚠️ 배포 후 등록 필요
킴스강서점미등록100m⚠️ 배포 후 등록 필요
  • 좌표 있는 3곳: 레거시 데이터에서 추출
  • 좌표 없는 4곳: 레거시에도 좌표 없음, 배포 후 관리자가 근무지 설정에서 직접 등록

hnt-migration-status.md

기술 참고 사항

  • 멱등성: business_number='166-81-63798' 기준 테넌트 존재 여부 확인, 이미 존재하면 skip hnt-migration-status.md
  • 배포 방식: main.py lifespan에서 자동 실행, 첫 배포 시 1회 적재 hnt-migration-status.md
  • 2차 배포: 데이터 적재 확인 후 main.py의 HNT seed 블록(226~239줄) 제거 hnt-migration-status.md
  • 양식 보호: "custom": true 플래그로 contract_template_refresh 덮어쓰기 방지 hnt-migration-status.md
  • startup backfill: 관리자 유형 4종, 기본 휴가유형, 휴가잔액, 기본 양식 등 자동 보완 hnt-migration-status.md

테스트 코드

파일종류검증 대상
tests/unit/test_contract_template_custom_flag.py단위 (9케이스)_should_update() custom 플래그 보호
tests/integration/test_week_schedule_attendance.py통합 (2케이스)근무일정 API 출퇴근 필드 반환

hnt-migration-status.md

관련 페이지

Made with CairniExplore public wikis →