SimpleHR project
직인(회사 인감) 관리 스펙
conceptedited by Cairni · 방금 · AIv2
개요
직인(회사 인감)은 근로계약서 및 근로계약서 스펙에 첨부되어 법적 효력을 보완하는 요소이다. 직인이 계약서에 어떻게 저장되고 표시되는지에 대한 로직이 2025년 6월 15일 수정사항에서 분석·부분 완료되었으며, 2025년 6월 23일 추가 버그가 확인되었다. fix-task-0615.md
직인 저장 구조
직인 정보는 EmployeeContract.content 필드 안에 저장되며, 서명 유형에 따라 키가 다르다. fix-task-0615.md
| 서명 유형 | 저장 키 | 설명 |
|---|---|---|
관리자 발송 → 직원 서명 (sign_specific_contract) | context_snapshot.company_seal | 발송 시점의 직인 스냅샷 저장 |
직원 자체 서명 (sign_my_required_contract) | context.company_seal | 서명 시점의 직인 정보 저장 |
관리자 계약서 목록 미리보기 — 직인 표시 우선순위
contracts/page.tsx에서 직인을 표시할 때 아래 우선순위로 적용한다. fix-task-0615.md
주의: previewContext(현재 직인)를 사용하는 경우, 직인이 교체되면 이전 계약서에도 새 직인이 표시되는 문제가 발생한다. fix-task-0615.md버그 이력 및 수정 현황
2025년 6월 23일 발견 및 수정 사항
2025년 6월 23일 수정사항에서 직인 관련 다음 버그들이 보고되고 해결되었다. fix-task-0623
직인 관련 이슈 현황AI · 출처 클릭
수정 완료3
기업 직인 이미지 대신 경로가 나오는 버그 수정 — 미리보기/다운로드 페이지에서 URL 텍스트 표시 문제 해결
관리자 페이지에서 서명된 직인 이미지가 표시되지 않는 버그 수정
contracts/page.tsx — 미리보기 직인 우선순위 로직 적용 (context_snapshot → context → previewContext)
해결 불가 (한계)1
6/8 이전 계약서 일부: 직인 정보 미저장 → 직인 교체 시 이전 계약서 직인도 함께 변경됨 (당시 직인 정보 없음)
상세 내용
버그 1: 기업 직인 이미지 대신 경로 텍스트 노출 fix-task-0623
- 발생 위치: 근로계약서 미리보기/출력 페이지
- 원인: 직인 URL이 이미지로 렌더링되지 않고 경로 텍스트로 표시됨
- 수정 방향: 이미지 렌더링 로직 수정 (URL을
<img>태그src로 올바르게 바인딩)
버그 2: 관리자 페이지에서 서명 이미지 미표시 fix-task-0623
- 발생 위치: 관리자 → 계약서 → 서명 완료 계약서 조회
- 원인: 직원이 서명한 이미지가
context또는context_snapshot에 올바르게 저장되지 않았거나, 관리자 페이지 렌더링 로직이 이를 참조하지 않음 - 수정 방향: 관리자 페이지에서 서명 이미지 저장 경로 확인 및 렌더링 로직 통합
근로계약서 제출 흐름에서 직인의 역할
근로계약서 서명 및 제출 과정에서 직인 등록이 필수 선행 조건이다. fix-task-0623
사용자 사례
사례: HNT 이관 직원이 근로계약서에 날인했으나 서명 후 제출이 되지 않는 문제
원인: 회사 직인이 우선으로 등록되어있어야 서명과 제출이 가능함 fix-task-0623
해결 절차 fix-task-0623
- 1.직인 등록 여부 확인
- 2.직인 등록 완료
- 3.재시도 시 정상 동작 여부 확인
참고: 직인 등록 후에도 문제가 해결되지 않는 경우, 계약서 상태 및 직원의 직원 재직 상태를 함께 점검해야 한다.
테스트 절차
직인 교체 후 이전 계약서 직인 유지 여부를 확인하기 위한 테스트 순서는 다음과 같다. fix-task-0615.md
테스트 계정 정보 fix-task-0615.md
| 항목 | 값 |
|---|---|
| 이메일 | seal.test@simplehr.co.kr |
| 비밀번호 | Test1234! |
| 소속 | 샘플회사, 개발팀 |
| 사번 | SEAL-TEST |
관련 맥락
- 직인 스펙은 근로계약서 스펙 및 근로계약서 스펙(별도)과 밀접하게 연관된다.
- 결재 흐름 전반에 대해서는 결재 관리 스펙을 참조한다.
- 직원 등록 시 계약서 발송 흐름은 직원 등록 플로우를 참조한다.
- 전체 수정 내역은 액션 아이템 및 의사결정 로그에서 추적한다.
- 2025년 6월 15일 수정 내역은 fix-task-0615.md을 참조한다.
- 2025년 6월 23일 최신 수정 내역은 fix-task-0623을 참조한다.