팜에이트 PEOPLE 인사·급여관리 v0.11.4 상세 이용 매뉴얼

작성일 2026-10-24 | 사내망용 | 대상: 승인된 사용자 및 관리자

이 문서는 v0.11.4의 실제 구현 기능과 현장 미검증 항목을 구분합니다. 급여 계산·보험·세금 적용의 법적 정확성은 실제 계약서·근태·급여대장으로 검증해야 합니다. 외부 인터넷에 직접 공개하지 마세요.

1. 처음 시작하기: 로그인과 두 가지 모드

  1. 회사 내부망의 PEOPLE 주소로 접속합니다. 서버 PC에서 http://127.0.0.1:8790, 사내 다른 PC에서는 서버 컴퓨터의 사내 IP를 사용합니다. 두 주소가 같은 서버로 실행되는지 /health에서 확인합니다.
  2. 등록된 아이디 또는 등록 휴대폰번호 + 비밀번호로 로그인합니다. 새 사용자 계정은 관리자의 승인 전에는 로그인되지 않습니다. 전화번호만으로 로그인할 수 없고 문자 OTP는 없습니다.
  3. 최초 로그인 화면은 항상 사용자 모드(조회 전용)입니다. 관리자 계정도 처음에는 사용자 모드를 봅니다.
  4. 관리자 권한이 있는 계정은 상단 관리자 모드로 전환을 누르고 본인 비밀번호를 다시 입력합니다.
  5. 관리자 모드에서 사용자 모드로 버튼을 누르면 변경 화면이 닫히고 조회 화면으로 돌아갑니다.
  6. 종료 시 반드시 로그아웃을 누릅니다. 두 모드는 정확히 사용자·관리자 두 가지이며 개발자 모드는 없습니다.

2. 사용자 모드에서 할 수 있는 일과 할 수 없는 일

3. 사용자용 인사·급여 종합 대시보드

  1. 로그인하면 인사·급여 종합현황이 기본 화면입니다.
  2. 재직 직원·전체 직원·이번 달 입사·퇴사 인원 카드를 확인합니다. 직원정보의 기준값에 따라 집계됩니다.
  3. 부서별 재직 직원, 직군별 직원 표에서 필터 또는 정렬을 적용합니다.
  4. 별도 권한이 있으면 외국인 인원과 30일 이내 계약종료 예정 인원도 확인할 수 있습니다.
  5. 근태는 인사 근태관리 대장에서 가져온 월별 등록 건수·연장시간·야간시간 합계입니다. 이 값은 급여 산식에 자동 반영된 값이 아닙니다.
  6. 인건비 권한이 있는 사용자만 최근 마감 월의 지급총액과 부서별 지급총액을 조회합니다. 미마감 자료는 제공하지 않습니다.
  7. 카드와 표는 조회 전용이므로 항목을 선택해도 저장·수정 처리가 일어나지 않습니다.

3-1. 직원별 기본정보 검색(별도 승인)

  1. 관리자 모드 → 설정·백업 → 사용자 관리에서 특정 사용자에게 직원별 기본정보 조회 권한을 부여해야 합니다. 최초 사용자 계정은 이 권한이 없습니다.
  2. 사용자 모드 상단 직원정보 조회로 이동해 이름·사번·부서 검색어를 입력합니다.
  3. 권한 범위에서 사번·이름·부서·직군·직급·재직상태·입사일만 최대 200건을 보여줍니다. 스마트 제목버튼 정렬·단일/복수선택 필터는 조회용입니다.
  4. 급여액, 계좌, 연락처, 주소, 주민등록번호, 여권, 외국인등록증 등은 이 API로 내려주지 않습니다. 정보 변경은 관리자 모드에서만 수행합니다.

4. 월별 인건비 비교: 한 달 및 복수선택

  1. 사용자 모드 상단 월별 인건비 비교를 선택합니다.
  2. 왼쪽 기준 월에는 금월이 기본 선택됩니다. 오른쪽 비교 대상 월에서 비교할 월을 선택합니다.
  3. 월 선택 목록 맨 위 복수선택을 체크하면 여러 월을 개별 체크할 수 있습니다. 양쪽 선택은 독립적입니다.
  4. 선택한 월 비교하기를 누르면 마감된 급여대장에 있는 월별 지급총액이 나타납니다.
  5. 기준 월 1개와 비교 월 1개가 모두 마감 완료라면 차액(기준월−비교월)과 증감률을 표시합니다. 비교 월 금액이 0원이면 백분율은 산출하지 않습니다.
  6. 복수 월을 고른 경우에는 각 월 금액을 따로 표시합니다. 월 합계·월평균·복수 기간 간 증감률은 현재 확정 규칙이 없어 계산하지 않습니다.
  7. 지급총액은 마감된 급여대장의 공제 전 금액 합계로, 법정 인건비 원가 전체(사용자 부담 보험료, 퇴직충당금 등)가 아닙니다.
  8. 마감 내역이 없는 월은 마감자료 없음으로 표시합니다. 숫자 0으로 간주하지 않습니다.

5. 사용자 계정정보 / 휴대폰번호 고정

  1. 사용자 모드의 내 계정 메뉴에서 본인 표시 이름과 비밀번호를 변경할 수 있습니다.
  2. 표시 이름을 바꿔도 내부 고유 계정 ID와 과거 이력 연결은 유지됩니다.
  3. 등록 휴대폰번호는 일부를 가려 표시하며, 사용자 모드에서 변경할 수 없습니다.
  4. 비밀번호 변경은 기존 비밀번호와 12자 이상의 새 비밀번호 입력이 필요합니다. 다른 기기에 로그인된 세션은 종료됩니다.
  5. 휴대폰번호 입력은 관리자 최초 등록 시 이루어지며, 이 버전은 번호 소유에 대한 SMS 인증을 수행하지 않으므로 회사 내부 절차로 본인 확인이 필요합니다.

6. 관리자 모드 진입 및 사용자 관리

  1. 관리자 계정의 사용자 모드 상단 관리자 모드로 전환을 누릅니다.
  2. 관리자 비밀번호를 재입력해야 진입합니다.
  3. 관리자 모드에서 설정·백업 → 사용자 관리를 찾습니다.
  4. 신규 사용자에 아이디·이름·등록 휴대폰번호·12자 이상의 임시 비밀번호를 입력하고 관리자 비밀번호로 재인증하여 등록합니다. 신규 계정은 반드시 미승인 상태로 시작합니다.
  5. 관리자가 승인, 활성화, 권한(인사 현황, 직원별 기본정보, 마감 월 인건비, 외국인 현황)을 검토해 설정합니다.
  6. 관리자는 아이디를 변경하거나 비밀번호를 강제 재설정할 수 있습니다. 기존 비밀번호를 조회할 수는 없습니다.
  7. 사용자 계정의 승인취소·비활성화·권한변경·아이디변경·암호 초기화 이후 기존 로그인 세션은 무효화됩니다.
  8. 등록 휴대폰번호는 아이디 변경 과정에서도 수정되지 않습니다. 사용자 관리 화면에서도 임의로 변경하는 기능을 제공하지 않습니다.
  9. 중요한 관리 동작에는 관리자 본인의 비밀번호 재확인과 감사기록이 적용됩니다.

7. 관리자 메뉴창 접기·펼치기 — 공간 넓히기

  1. 관리자 모드의 왼쪽 메뉴창과 오른쪽 작업창을 구분합니다.
  2. PC에서 메뉴창 오른쪽 가장자리 세로 중앙의 왼쪽 화살표를 누르면 58px 정도의 세로 사이드바로 접힙니다.
  3. 접힌 사이드바에는 인사관리 · 빠른편집과 같이 현재 작업 위치 한 줄을 세로로 표시합니다. 다른 작업창으로 이동하면 문구도 변경됩니다.
  4. 접힌 상태 상단에는 업무 홈·인사관리·급여관리·4대보험·제증명이 가로로 표시됩니다.
  5. 가로 상위메뉴에 마우스를 올리거나 클릭하면 하위메뉴가 열립니다. 하위 항목 오른쪽의 옵션버튼은 해당 작업의 열 표시 설정을 엽니다.
  6. 메뉴 영역에서 마우스가 벗어나면 펼쳐진 하위메뉴가 닫힙니다.
  7. 사이드바 중간의 오른쪽 화살표나 세로 위치 표시를 누르면 원래 메뉴창으로 복귀합니다.
  8. 메뉴창 접힘 상태는 같은 계정·브라우저에 저장됩니다. 다른 PC와 자동 동기화되지는 않습니다. 모바일 폭에서는 기존 메뉴 방식이 유지됩니다.

8. 스마트 제목버튼 — 전체 공통 표 사용법

9. 직원관리와 외국인·근태관리

  1. 인사관리 → 직원관리에서 신규 직원 등록, 직원정보 수정, 엑셀 가져오기를 이용합니다.
  2. 직원명·사번·부서를 검색하고, 표 제목 옵션버튼으로 필요한 열만 선택합니다.
  3. 직원정보 수정 중 외국인 추가정보를 누르면 여권·등록증·체류자격·계약종료일 등의 별도 정보를 관리합니다.
  4. 등록증과 여권은 기존 암호화 사진이 있어야 권한 있는 관리자만 열람·인쇄할 수 있으며 화면을 열면 감사이력이 남습니다.
  5. 근태관리의 일별 근태 기록을 수정하면 월 근태 합계가 반영됩니다. 빠른편집에서 근태 집계값만 임의 수정할 수 없습니다.
  6. 직원 삭제는 기록이 없는 직원만 가능하고, 급여·근태·발급 기록 등이 있으면 삭제하지 않고 퇴사 상태로 보존합니다.

10. 인사·급여 빠른편집

  1. 왼쪽 메뉴창의 인사관리·급여관리 아래 빠른편집을 누릅니다.
  2. 오른쪽 옵션버튼으로 제목 표시 항목을 선택합니다. 직원은 필수이며 외국인 전용 항목은 국적을 표시할 때 선택할 수 있습니다.
  3. 직원 제목 아래 입력칸은 이름·사번 검색이며 전체 적용이 아닙니다.
  4. 제목 바로 아래 다른 입력칸에 값을 입력하면 전체 적용 말풍선이 나타납니다. 현재 필터 대상 직원 전체에 화면상 임시 반영됩니다.
  5. 저장을 눌러야 DB에 기록됩니다. 저장 전 취소를 누르면 변경 내용을 되돌릴 수 있습니다.
  6. 과거 수정이력은 관리자 변경이력에서 조회합니다. 복원은 최신 수정 여부·월마감 상태 등의 조건에 따라 제한됩니다.
  7. 외국인 서류와 월별 근태 합계 등 조회 전용 셀은 기존 원본 수정창으로 연결됩니다.

11. 급여관리 — 직원별 급여정산 및 마감

  1. 급여관리에서 정산 귀속월을 선택하고 월 정산을 시작합니다. 월 생성 당시 등록 직원과 급여자료가 스냅샷으로 저장됩니다.
  2. 직원별 상세 화면에서 일반·연장·야간·휴일시간과 지급·공제 항목을 확인합니다.
  3. 프로그램 계산값과 근로계약서·근태·법정수당 산정기준 및 공단 고지액을 대조합니다.
  4. 전원 확인이 끝난 후 월 마감을 진행합니다. 마감 뒤에는 일반 편집을 제한하고 정정은 권한 있는 담당자의 별도 절차를 사용합니다.
  5. 급여계약·검증 화면에서는 이름·사번을 입력하면 후보 목록이 나옵니다. 동명이인은 사번·부서로 구분해 선택합니다.
  6. 시급제·월급제·연봉제와 연장·야간·휴일 각각의 고정수당 포함 여부를 설정할 수 있습니다. 이 계산 미리보기는 검토용이며 실지급액을 자동 변경하지 않습니다.
  7. 4대보험·소득세 자동 확정·계좌이체·공식 신고는 이 버전에서 지원되지 않습니다.

12. 급여 계산식 관리 상세 따라하기

  1. 관리자 모드에서 급여관리 → ∑ 급여 계산식 관리로 이동합니다.
  2. 새 초안을 누르면 편집 중이던 초안이 초기화됩니다. 저장되지 않은 변경이 있다면 먼저 확인합니다.
  3. 계산 항목(기본급·통상시급 검토·연장·야간·휴일·일할·연봉 월환산·사용자정의 등), 급여 유형, 검토 귀속월을 설정합니다.
  4. 계산식 영역 아래의 변수 선택에서 월급여, 연봉, 기준시급, 통상시급, 연장시간, 야간시간, 휴일시간 등을 클릭합니다. 한글 변수 칩으로 수식 영역에 추가됩니다.
  5. 이미 선택된 변수를 다시 누르면 선택이 취소됩니다. 선택 중인 변수는 색상으로 구분됩니다.
  6. 사칙연산의 +, −, ×, ÷, 괄호와 숫자 입력을 이용해 계산식을 조립합니다. 숫자 1.5를 곱하면 기준시급 × 연장시간 × 1.5 같은 검토식이 됩니다.
  7. 계산 미리보기를 눌러 예시값 계산 결과와 오류를 확인합니다. 실제 직원 급여에는 적용되지 않습니다.
  8. 결과가 적절하면 초안 저장을 누릅니다. 초안 목록에 항목·급여유형·검토월·버전이 표시됩니다.
  9. 초안 목록 수식 위에 마우스를 올리면 팝업에서 전체 수식을 확인할 수 있습니다. 수정 버튼으로 수식 편집 화면에 다시 불러옵니다.
  10. 변경이력에는 새 버전이 기록됩니다. 아직 승인·확정 계산식을 실급여 엔진으로 자동 적용하는 기능은 미완료입니다.

13. 4대보험·제증명·매뉴얼

14. 백업, 버전 점검, 업데이트

  1. 서버 PC에서 기존 프로그램 설치 폴더 전체, 특히 data/payroll.sqlite3, data/sensitive.key와 첨부파일을 백업합니다.
  2. 기존 서버를 종료하고 포트 8790에 중복 실행된 프로세스가 없는지 확인합니다. 127.0.0.1:8790과 사내 IP:8790이 서로 다른 폴더의 앱을 실행하지 않도록 합니다.
  3. 전체 새 버전을 적용할 때는 새 빈 폴더에 압축 해제하고 기존 DB·암호키·사진은 복사본으로 옮겨 시험합니다. 다른 기준 버전의 교체 패치를 무작정 덮어쓰지 마세요.
  4. /health의 실제 서버 버전과 화면 메뉴창 하단의 UI 버전이 동일해야 합니다. 불일치가 뜨면 서버/화면 코드 경로·캐시·중복 프로세스부터 확인합니다.
  5. 브라우저에서 Ctrl+F5로 새로고침하고 메뉴창 접기, 스마트 버튼, 직원검색, 급여계약 검토, 계산식 초안, 사용자 모드 조회, 관리자 권한 차단을 시험합니다.
  6. 급여정보가 포함된 사내망 서비스는 개인정보보호를 위해 HTTPS, 계정관리, 백업 암호화, 권한 재검토가 필요합니다. 이 실행본은 실제 회사 운영 보안심사를 통과했다고 주장하지 않습니다.

15. 오류와 해결

증상 확인할 내용
서버 v0.10.2 / 화면 v0.11.0 불일치 8790 포트 실행 프로세스·설치 폴더 및 브라우저 캐시 확인
메뉴창이 접히지 않음 static/people_collapse.js 서버 제공 및 PC 화면 폭 확인
스마트 버튼 ▲▼가 보이지 않음 제목 hover·키보드 초점, static/smart_tables.js 제공 및 최신 CSS 확인
사용자 모드에서 저장이 403 정상적인 읽기 전용 차단. 관리자 권한 인증 후 관리자 모드 진입
인건비가 보이지 않음 관리자의 인건비 열람권한 부여 및 해당 월 마감 여부 확인
급여계산식 초안이 실급여에 반영되지 않음 정상. 초안은 검토용이며 승인·실지급 자동적용 기능은 별도 검증 필요
직원명 검색 후 다른 직원이 선택됨 검색 목록에서 사번·부서 확인 후 확정 선택

마지막 확인: 이 문서는 배포된 코드의 화면과 API를 기준으로 작성했으며, 세금·보험 실제 신고와 급여 계산식의 법적 완결성을 보증하지 않습니다.

v0.11.2 스마트 제목 버튼과 화면 이동

  1. 넓은 열은 ▲▼ 정렬 및 ▾ 필터를 제목 내부에서 이용합니다.
  2. 좁은 열은 마우스를 제목 위에 올리거나 키보드로 초점을 옮기면 제목 아래에 ▲▼▾ 버튼이 표시됩니다. 마우스를 아래 버튼으로 이동해 조작합니다. 모바일에서는 좁은 제목을 터치해 버튼을 표시합니다.
  3. ▾ 하위 메뉴의 복수선택과 단일선택, 여러 제목 필터, 제목 이동과 너비 조절, 사용자별 설정 저장은 기존 방식대로 이용합니다.
  4. 사용자 모드 첫 화면에서 마지막 작업화면 버튼을 누르면 해당 계정에서 최근 이용했던 조회 화면으로 이동합니다. 관리자 모드는 재인증 없이 열리지 않습니다.
  5. PC 마우스를 스크롤 가능한 작업창의 가장자리에 가져가면 부드럽게 위·아래·좌·우 이동합니다. 입력창·팝업에서는 동작하지 않습니다.

이 기능은 화면 편의성을 개선하며 급여 실지급·마감 데이터를 수정하지 않습니다.

v0.11.3 관리자 모드 비밀번호 창

사용자 모드 상단에서 관리자 모드로 전환을 누르면 독립된 비밀번호 재확인 창이 가장 앞에 열립니다. 입력 후 Enter 또는 관리자 모드 열기를 누르세요. 빈 입력과 잘못된 암호는 관리자 화면으로 이동하지 않습니다. 창이 열리지 않으면 프로그램 종료 후 파일 일치 및 Ctrl+F5를 확인하세요.

v0.11.4 빠른편집 외국인 단일 팝업·이름열 고정

  1. 인사관리 빠른편집에서 직원 이름은 가로 스크롤을 움직여도 왼쪽에 고정됩니다. 이름 열의 이동은 허용하지 않으며, 저장된 기존 순서는 이름을 맨 앞으로 정리합니다.
  2. 점선으로 표시되던 개별수정 연결을 일반 글자로 바꿨습니다. 마우스 호버나 키보드 포커스 시 선택 가능 여부를 확인할 수 있습니다.
  3. 일괄입력 행에서 직접 변경할 수 없는 항목은 반복된 조회 전용 글자 대신 — 로 표시합니다. 원래 편집권한은 유지됩니다.
  4. 외국인 직원의 체류자격 등 외국인 상세 항목을 클릭하면 외국인 추가정보 팝업 한 개만 열립니다. 한국 국적 직원은 열람·저장할 수 없습니다.
  5. 빠른편집에서 열린 외국인 정보 팝업의 저장하기는 해당 직원의 외국인 정보·허용된 첨부사진만 별도 갱신합니다. 취소하면 저장하지 않습니다. 기존 직원관리 메뉴의 2단계 편집 방식은 그대로 유지됩니다.
  6. 민감 번호 원문은 화면에서 기본적으로 마스킹되며, 기존 암호화·권한·감사 기록은 보존됩니다.

설치 전 data/payroll.sqlite3, data/sensitive.key 및 첨부 데이터가 포함된 전체 설치 폴더를 반드시 백업하세요. 회사 PC 실직원 DB에 대한 현장 검증은 별도로 필요합니다.