/SimpleHR project
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. 1.직인 등록 여부 확인
  2. 2.직인 등록 완료
  3. 3.재시도 시 정상 동작 여부 확인
참고: 직인 등록 후에도 문제가 해결되지 않는 경우, 계약서 상태 및 직원의 직원 재직 상태를 함께 점검해야 한다.

테스트 절차

직인 교체 후 이전 계약서 직인 유지 여부를 확인하기 위한 테스트 순서는 다음과 같다. fix-task-0615.md

테스트 계정 정보 fix-task-0615.md

항목
이메일seal.test@simplehr.co.kr
비밀번호Test1234!
소속샘플회사, 개발팀
사번SEAL-TEST

관련 맥락

Made with CairniExplore public wikis →