의사결정 로그

answeredited by Cairni · 방금 · AIv4

의사결정 로그

출처: 미팅노트.txt (2026.05.26 화 오후 5:20, 62분 1초) 관련 페이지: Simple HR 프로젝트 개요 · 액션 아이템

#	날짜	결정 내용	근거 / 배경	영향 범위
1	2026-05-26	Simple HR를 우선 진행하고 TF 시스템은 이후에 착수	현재 HR 기능의 버그·미완성 항목이 많아 먼저 안정화 필요	프로젝트 전체, TF 시스템 일정
2	2026-05-26	급여·인사 관리자 권한을 단일 관리자 권한으로 통합	초기 설계에서 급여 관리자·인사 관리자를 분리했으나 현재는 하나로 통합하기로 변경	근무 정책, 권한 관리 모듈
3	2026-05-26	연장 근로는 신청 → 결재 승인 후에만 급여에 반영	무단 연장을 급여로 인정하지 않는 노동법 관행 준수; 현재 미구현 상태	근태 관리, 급여 계산
4	2026-05-26	근로계약서는 관리팀이 먼저 발송해야 직원이 열람·서명 가능	직원 초대 즉시 자동 생성되는 현재 방식이 실무와 맞지 않음	직원 등록 플로우, 서류 관리
5	2026-05-26	출퇴근 GPS는 현재 단독 지원(정확도 한계 인식)	다른 방식은 아직 미지원; GPS 정확도가 완전하지 않음을 인지한 채 운영	근태 관리
6	2026-05-26	CICD 파이프라인을 구축하여 푸시 시 자동 배포	수동 배포 오류 방지; 슬랙 알림으로 장애 감지	개발 운영 전반
7	2026-05-26	이번 주는 메인 브랜치에 직접 푸시 허용 (단기 예외)	현재 실사용 서버가 한 군데뿐이므로 위험 낮음; 추후 운영 서버 분리 시 재검토	개발 워크플로우
8	2026-05-26	기존 시스템 출퇴근 데이터를 신규 서버로 이관 후 이번 주부터 신규 시스템으로 전환	구 시스템 데이터 유실 방지; MBS 투입(약 3,000명) 전에 안정화 필요	데이터 마이그레이션, 근태 관리
9	2026-05-26	HNT 데이터를 먼저 시스템에 반영한 뒤 유니S 데이터를 추가	유니S 데이터 규모가 훨씬 크므로 소규모 HNT로 먼저 검증	데이터 마이그레이션 순서
10	2026-05-26	휴가는 연차·특별휴가(병가·출산·생리휴가 등)를 분리 관리	연차와 법정·회사 재량 특별휴가의 성격이 달라 별도 계산 필요	휴가 관리
11	2026-05-26	LMS 관련 시스템은 'LMS를 운영하는 회사를 위한 관리 시스템'으로 컨셉 재정의	'LMS'라는 명칭이 혼선을 줌; CRM 성격의 운영 관리 플랫폼으로 방향 전환	LMS 관리 시스템 (TF 이후)
12	2026-05-26	엑셀 일괄 등록 시 중복 처리 방식은 추가 검토 필요 (미결정)	현재 엑셀 임포트 기능이 중복을 잡지 못함; 해결책 미확정	직원 등록 플로우

2026년 06월 02일 수정 요청사항 추적

fix-task-0602.md에서 정리된 관리자 모드 및 모바일 앱 관련 미결제 작업들입니다.

근로계약서 (Employment Contract)

항목	상태	설명	관련 페이지
회사 기본 설정에서 근로계약서 사용 여부 설정	✅ 완료	직원 추가 시 스위치로 선택 가능	근로계약서 스펙
입사일 이후인 경우 근로계약서 필수 작성	✅ 완료	입사일이 미래인 직원은 계약서 작성 후에만 계정 사용 가능	직원 등록 플로우
근로계약서 탭에서 전체 직원·제출 현황·제출 이력 표시	⏳ 미진행	여러 부를 제출할 수 있으므로 히스토리 관리 필요	근로계약서 스펙
연장 관련 설정	⏳ 미진행	상세 요구사항 확인 필요	근무 정책 스펙
회사 양식 변수 조정	⏳ 미진행	양식의 변수 매핑 재검토	근로계약서 스펙
입사일과 계약 시작일 분리	⏳ 미진행	현재는 동일하게 처리되고 있음	직원 등록 플로우
계약서 작성 버튼 → 미리보기 → 발송 프로세스 개선	⏳ 미진행	발송 전 미리보기 단계 추가 필요	근로계약서 스펙
폰트 렌더링 문제 해결	⏳ 미진행	문서에서 폰트 일관성 부족	근로계약서 스펙

초기 설정 (Initial Setup)

항목	상태	설명	관련 페이지
초기 설정 가이드 상세화	✅ 완료	직인, 로고 정도만 추가하는 간결한 가이드	Simple HR 프로젝트 개요
디비안츠 skeleton 제거	✅ 완료	초기 설정 완료 후 우측 스켈레톤 UI 제거	Simple HR 프로젝트 개요
직인, 로고 필수 입력 설정	✅ 완료	두 항목 모두 필수 입력 처리	Simple HR 프로젝트 개요

휴가 관리 (Leave Management)

항목	상태	설명	관련 페이지
연차 외 휴가는 신청 시에만 발급	⏳ 미진행	병가 등 특별휴가는 자동 발급이 아닌 신청 기반으로 변경 필요	휴가 관리 스펙

교대(변형)근로 관리 (Shift Work Management)

항목	상태	설명	관련 페이지
교대 인원 지정 범위 오류 (18~15명 고정)	⏳ 미진행	근로정책의 설정값이 유연하게 반영되지 않음	교대(변형)근로 관리 스펙
주말·휴일 휴무 옵션 추가	⏳ 미진행	현재 무조건 근무값만 설정 가능; 전체 휴무 옵션 필요	교대(변형)근로 관리 스펙
근로정책의 교대 이름(D/D1/E/N) 미표시	✅ 완료	정책에서 설정한 네이밍이 UI에 반영되도록 수정	근무 정책 스펙
조 이름 변경 후 기존 교대 패턴 중복 표시	⏳ 미진행	메타데이터 정리 및 데이터 마이그레이션 필요	교대(변형)근로 관리 스펙
고객센터 변형근무 정책 불일치	✅ 완료	정책 설정과 실제 적용 값 일치시킴	교대(변형)근로 관리 스펙
교대 설정에서 "기본근무시간" UI 요소 제거	✅ 완료	불필요한 필드 삭제	근무 정책 스펙
변형근무 설정 UI 렌더링 오류	✅ 완료	깨진 레이아웃 수정	교대(변형)근로 관리 스펙

교대 부서 조회 하이브리드 방식 구현

fix-task-0602.md에서 명시된 policy_service.py의 교대/변형근무 부서 조회 로직:

교대/변형근무 부서 검색 경로
├─ 1차: DepartmentWorkPolicy 테이블 JOIN
│   └─ 관리자가 UI에서 부서별 정책 할당한 경우
│   └─ shift_team_name이 없어도 부서 노출
│
└─ 2차: Employee fallback (시드데이터 호환)
    └─ 직원의 shift_team_name + work_policy_id가 직접 배정된 경우
    └─ DepartmentWorkPolicy 레코드 없는 기존 데이터 처리

서버 로그 예시:

[SHIFT-DEPTS] DepartmentWorkPolicy: ['개발2팀'], Employee fallback: ['AI 운영센터']
[SHIFT-LOOKUP] dept=xxx → DepartmentWorkPolicy 경로 (policy=개발2팀 3교대)
[SHIFT-LOOKUP] dept=yyy → Employee fallback 경로 (policy=AI 운영센터 변형근무)

근로 정책 (Work Policy)

항목	상태	설명	관련 페이지
근로정책 이력 기록	⏳ 미진행	정책 변경 시 버전 관리 및 히스토리 추적 필요	근무 정책 스펙
출근·퇴근 시간 기본값 설정	⏳ 미진행	출근/퇴근 "고정시간" 항목을 기본값으로 설정	근무 정책 스펙

출퇴근 관리 (Attendance Management)

항목	상태	설명	관련 페이지
출퇴근관리 백엔드 성능 최적화	⏳ 미진행	조회 속도 개선 필요	근태 관리 스펙

인증 (Authentication)

항목	상태	설명	관련 페이지
인증 해제 후 빈 페이지 표시 오류	⏳ 미진행	세션 만료 또는 권한 부재 시 적절한 에러 페이지 필요	Simple HR 프로젝트 개요

결제 (Payment)

항목	상태	설명	관련 페이지
결제 시스템 연동	⏳ 미진행	외부 결제 게이트웨이 통합 필요	Simple HR 프로젝트 개요

26년 07월 03일 수정사항 fix-task-0703

fix-task-0703 (26년 07월 03일 수정사항)

완료 항목

항목	설명	관련 페이지
사직서 프로세스 처리	DB 모델·API(CRUD/승인/반려)·관리자 UI(목록/등록/승인/반려) 완성; 직원 기안서 최종승인 → Resignation 자동 생성 연동; 퇴직 처리(EMP_RETIRED) 완성; 경로 A(관리자 직접 등록) / 경로 B(직원 기안 → 자동 생성 → 관리자 COMPLETED) 구현 완료	사직서 처리 워크플로 스펙
연락처 DB 저장 형식 통일	기존 데이터는 유지, 신규 데이터부터 동일 형식 저장	—
초기 설정 가이드 수정	신규 테넌트 등록 시 가이드 항목이 이미 완료로 표시되는 문제 수정; 모든 항목 완료 후에도 가이드 열람 가능; 완료 항목 클릭 시 해당 페이지로 이동; 순서 조정(회사 기본 정보 → 회계·급여 정책 → 근로 정책 → 직위/직책/직무 → 근무지 → 부서 → 직원 → 관리자)	초기 설정 가이드 구조 개편 스펙
탄력근로제 필수서류 기본값 수정	신규 테넌트 생성 시 기본 필수서류를 통장사본·근로계약서 두 개로 변경 (탄력근로서류 제거)	근무 정책 스펙
사파리 로그인 풀림 확인	사파리에서 로그인이 빨리 풀리는 문제 원인 확인 완료 (크롬은 정상)	인증 만료 시 빈 페이지 노출 이슈
계약서 레이아웃 개선	날인·서명·대표 칸을 테이블 형태에서 자연스러운 배치로 변경	근로계약서 스펙
사직서 분류 및 기본 생성	테넌트 생성 시 기본 사직서 양식 생성; form_category=RESIGNATION 분류 추가; 기존 문자열 매칭 방식에서 form_category 기반으로 변경	양식 편집기(폼 빌더) 스펙
출퇴근 요청 승인 UI 개선	승인 시 직원 근로정책 시작/종료 시간 기본값 표시; 결재라인 동그라미 UI로 변경; canAct 순서 기반 로직 적용; 반려사유 상세 드로어 상단으로 이동; 사용자 결재 모달 enum 한글 매핑 및 requested_time 로컬 시간 변환	결재 관리 스펙
근태결재 배지 문제 수정	신청 알림 존재 시 리스트에 서류가 보이지 않는 문제 수정	근태 관리 스펙
문서 종류 선택 제거	사용자가 신청서/기안서 신규 작성 시 문서 종류 선택 UI 제거	양식 편집기(폼 빌더) 스펙

미완료 항목

항목	설명	관련 페이지
퇴직 처리된 직원 계정 접근 차단	탈퇴 처리 여부 의논 필요	직원 재직 상태 변경 워크플로
근로 정책 소속 직원 적용 검토	수정·등록 시 소속 직원 전체 적용 여부 검토, 불필요 시 제거	근무 정책 스펙
근로계약서 매핑 확인	사용자 근로계약서에 급여·근무장소 등 미채워지는 부분 매핑 확인 필요	근로계약서 스펙
GPS 출근 위치 저장	출장이 잦은 직원을 위해 GPS 출근 시 위치를 저장하는 기능 구현	GPS 출퇴근 스펙
모바일 첨부파일 구현	모바일에서 신청서 제출 방식이 첨부파일인 경우 첨부 가능하도록 구현	모바일 앱 스펙
양식 등록 안내 추가	회사 양식 등록 시 분류가 신청서인 경우, 관리자가 첨부파일을 보낼 수 있다는 안내 추가	양식 편집기(폼 빌더) 스펙
근로정책 수정 폼 초기화 버그	`formNightSurcharge` / `formHolidaySurcharge`가 `useState("50")`으로 하드코딩, setter 없음 → 수정 시 항상 50 전송; `shift_day_boundary` null 시 "06:00" 폴백으로 불필요한 scheduled_change 생성; night/holiday surcharge rate 단위 통일 필요 (1.5 배수 vs 50 퍼센트)	근무 정책 스펙 · 근무 정책 ↔ 급여 연동 현황 및 이슈

모바일 앱 (Mobile App)

fix-task-0602.md에 정리된 모바일 앱 개선 작업:

항목	상태	설명	관련 페이지
모바일 채팅 화면 미표시	⏳ 미진행	앱 내 메시징 기능 미동작	모바일 앱 스펙
잘린 UI 요소 복구	⏳ 미진행	반응형 레이아웃 재조정	모바일 UI/UX 개선 작업 (기업 사용자)
안드로이드 삼성브라우저 색상 통일	⏳ 미진행	라이트 모드로 통일 필요	모바일 앱 스펙
일정관리 캘린더 연동	⏳ 미진행	일정탭 클릭 시 캘린더 조회 기능 추가	모바일 앱 스펙
대시보드 아이콘 우선순위 재배치	⏳ 미진행	이용 빈도 높은 기능 상단 배치	모바일 앱 스펙
근무탭 한 페이지 표시	⏳ 미진행	줄 간격 축소로 일자별 전체 내용 표시	모바일 앱 스펙
메시지 기능 독립 위치	⏳ 미진행	채팅 메뉴를 별도 탭으로 분리	모바일 앱 스펙

미결 논의 항목

아래 항목은 관련 미팅에서 언급되었으나 결론이 나지 않았습니다. 액션 아이템 페이지에서 후속 처리 상태를 확인하세요.

병가 지급 규칙: 구체적인 지급 기준이 불명확하여 별도 조사 필요 미팅노트.txt
퇴근 미기록 처리 방식: 자동 퇴근 처리 vs. 미처리 유지 중 선택 미완료 미팅노트.txt
여름 휴가 운영 방식: 연차 포함 여부 및 기간 지정 방식 미결정 미팅노트.txt
조직도 상위 개념(본사/지사) 구조: 현재 DB 명칭 혼선 있음; 계층 구조 설계 재검토 필요 미팅노트.txt
퇴직 처리된 직원 계정 접근 차단: 탈퇴 처리 여부 의논 필요 fix-task-0703 (26년 07월 03일 수정사항)
CI PostgreSQL 버전 불일치: CI 통합 테스트(v15)와 프로덕션(v16) 불일치 — CI를 v16으로 맞출지 검토 필요 fix-task-0703 (26년 07월 03일 수정사항)