팜에이트 PEOPLE 인사·급여관리 v0.11.4 상세 이용 매뉴얼
작성일 2026-10-24 | 사내망용 | 대상: 승인된 사용자 및 관리자
이 문서는 v0.11.4의 실제 구현 기능과 현장 미검증 항목을 구분합니다. 급여 계산·보험·세금 적용의 법적 정확성은 실제 계약서·근태·급여대장으로 검증해야 합니다. 외부 인터넷에 직접 공개하지 마세요.
1. 처음 시작하기: 로그인과 두 가지 모드
- 회사 내부망의 PEOPLE 주소로 접속합니다. 서버 PC에서
http://127.0.0.1:8790, 사내 다른 PC에서는 서버 컴퓨터의 사내 IP를 사용합니다. 두 주소가 같은 서버로 실행되는지 /health에서 확인합니다.
- 등록된 아이디 또는 등록 휴대폰번호 + 비밀번호로 로그인합니다. 새 사용자 계정은 관리자의 승인 전에는 로그인되지 않습니다. 전화번호만으로 로그인할 수 없고 문자 OTP는 없습니다.
- 최초 로그인 화면은 항상 사용자 모드(조회 전용)입니다. 관리자 계정도 처음에는 사용자 모드를 봅니다.
- 관리자 권한이 있는 계정은 상단 관리자 모드로 전환을 누르고 본인 비밀번호를 다시 입력합니다.
- 관리자 모드에서 사용자 모드로 버튼을 누르면 변경 화면이 닫히고 조회 화면으로 돌아갑니다.
- 종료 시 반드시 로그아웃을 누릅니다. 두 모드는 정확히 사용자·관리자 두 가지이며 개발자 모드는 없습니다.
2. 사용자 모드에서 할 수 있는 일과 할 수 없는 일
- 허용: 인사 종합현황, 재직·입퇴사 현황, 부서·직군별 인원, 근태 집계, 별도의 직원별 기본정보 권한이 있는 경우 이름·사번·부서 검색, 권한이 있는 경우 마감된 월별 지급총액, 조회용 정렬·필터·비교.
- 금지: 직원 신규 등록/수정/삭제, 급여 저장·확정·월마감, 엑셀 등록, 계정 관리, 급여계산식 변경, 개인정보 문서 원본 열람.
- 버튼 숨김이 전부가 아닙니다. 서버는 사용자 모드의 기존 관리자 GET API와 모든 업무 수정 POST를 403으로 차단합니다.
- 관리자에게 승인받지 않은 인건비 금액은 보이지 않습니다. 개인별 급여·계좌·주민등록번호는 사용자 모드 API로 제공하지 않습니다.
- 인건비 비교에서 소규모 부서(5명 미만)의 급여총액은 공개하지 않습니다. 집계 정보도 민감할 수 있으므로 화면 캡처·재배포를 주의하세요.
3. 사용자용 인사·급여 종합 대시보드
- 로그인하면 인사·급여 종합현황이 기본 화면입니다.
- 재직 직원·전체 직원·이번 달 입사·퇴사 인원 카드를 확인합니다. 직원정보의 기준값에 따라 집계됩니다.
- 부서별 재직 직원, 직군별 직원 표에서 필터 또는 정렬을 적용합니다.
- 별도 권한이 있으면 외국인 인원과 30일 이내 계약종료 예정 인원도 확인할 수 있습니다.
- 근태는 인사 근태관리 대장에서 가져온 월별 등록 건수·연장시간·야간시간 합계입니다. 이 값은 급여 산식에 자동 반영된 값이 아닙니다.
- 인건비 권한이 있는 사용자만 최근 마감 월의 지급총액과 부서별 지급총액을 조회합니다. 미마감 자료는 제공하지 않습니다.
- 카드와 표는 조회 전용이므로 항목을 선택해도 저장·수정 처리가 일어나지 않습니다.
3-1. 직원별 기본정보 검색(별도 승인)
- 관리자 모드 → 설정·백업 → 사용자 관리에서 특정 사용자에게 직원별 기본정보 조회 권한을 부여해야 합니다. 최초 사용자 계정은 이 권한이 없습니다.
- 사용자 모드 상단 직원정보 조회로 이동해 이름·사번·부서 검색어를 입력합니다.
- 권한 범위에서 사번·이름·부서·직군·직급·재직상태·입사일만 최대 200건을 보여줍니다. 스마트 제목버튼 정렬·단일/복수선택 필터는 조회용입니다.
- 급여액, 계좌, 연락처, 주소, 주민등록번호, 여권, 외국인등록증 등은 이 API로 내려주지 않습니다. 정보 변경은 관리자 모드에서만 수행합니다.
4. 월별 인건비 비교: 한 달 및 복수선택
- 사용자 모드 상단 월별 인건비 비교를 선택합니다.
- 왼쪽 기준 월에는 금월이 기본 선택됩니다. 오른쪽 비교 대상 월에서 비교할 월을 선택합니다.
- 월 선택 목록 맨 위 복수선택을 체크하면 여러 월을 개별 체크할 수 있습니다. 양쪽 선택은 독립적입니다.
- 선택한 월 비교하기를 누르면 마감된 급여대장에 있는 월별 지급총액이 나타납니다.
- 기준 월 1개와 비교 월 1개가 모두 마감 완료라면 차액(기준월−비교월)과 증감률을 표시합니다. 비교 월 금액이 0원이면 백분율은 산출하지 않습니다.
- 복수 월을 고른 경우에는 각 월 금액을 따로 표시합니다. 월 합계·월평균·복수 기간 간 증감률은 현재 확정 규칙이 없어 계산하지 않습니다.
- 지급총액은 마감된 급여대장의 공제 전 금액 합계로, 법정 인건비 원가 전체(사용자 부담 보험료, 퇴직충당금 등)가 아닙니다.
- 마감 내역이 없는 월은
마감자료 없음으로 표시합니다. 숫자 0으로 간주하지 않습니다.
5. 사용자 계정정보 / 휴대폰번호 고정
- 사용자 모드의 내 계정 메뉴에서 본인 표시 이름과 비밀번호를 변경할 수 있습니다.
- 표시 이름을 바꿔도 내부 고유 계정 ID와 과거 이력 연결은 유지됩니다.
- 등록 휴대폰번호는 일부를 가려 표시하며, 사용자 모드에서 변경할 수 없습니다.
- 비밀번호 변경은 기존 비밀번호와 12자 이상의 새 비밀번호 입력이 필요합니다. 다른 기기에 로그인된 세션은 종료됩니다.
- 휴대폰번호 입력은 관리자 최초 등록 시 이루어지며, 이 버전은 번호 소유에 대한 SMS 인증을 수행하지 않으므로 회사 내부 절차로 본인 확인이 필요합니다.
6. 관리자 모드 진입 및 사용자 관리
- 관리자 계정의 사용자 모드 상단 관리자 모드로 전환을 누릅니다.
- 관리자 비밀번호를 재입력해야 진입합니다.
- 관리자 모드에서 설정·백업 → 사용자 관리를 찾습니다.
- 신규 사용자에 아이디·이름·등록 휴대폰번호·12자 이상의 임시 비밀번호를 입력하고 관리자 비밀번호로 재인증하여 등록합니다. 신규 계정은 반드시 미승인 상태로 시작합니다.
- 관리자가 승인, 활성화, 권한(인사 현황, 직원별 기본정보, 마감 월 인건비, 외국인 현황)을 검토해 설정합니다.
- 관리자는 아이디를 변경하거나 비밀번호를 강제 재설정할 수 있습니다. 기존 비밀번호를 조회할 수는 없습니다.
- 사용자 계정의 승인취소·비활성화·권한변경·아이디변경·암호 초기화 이후 기존 로그인 세션은 무효화됩니다.
- 등록 휴대폰번호는 아이디 변경 과정에서도 수정되지 않습니다. 사용자 관리 화면에서도 임의로 변경하는 기능을 제공하지 않습니다.
- 중요한 관리 동작에는 관리자 본인의 비밀번호 재확인과 감사기록이 적용됩니다.
7. 관리자 메뉴창 접기·펼치기 — 공간 넓히기
- 관리자 모드의 왼쪽 메뉴창과 오른쪽 작업창을 구분합니다.
- PC에서 메뉴창 오른쪽 가장자리 세로 중앙의 왼쪽 화살표를 누르면 58px 정도의 세로 사이드바로 접힙니다.
- 접힌 사이드바에는
인사관리 · 빠른편집과 같이 현재 작업 위치 한 줄을 세로로 표시합니다. 다른 작업창으로 이동하면 문구도 변경됩니다.
- 접힌 상태 상단에는 업무 홈·인사관리·급여관리·4대보험·제증명이 가로로 표시됩니다.
- 가로 상위메뉴에 마우스를 올리거나 클릭하면 하위메뉴가 열립니다. 하위 항목 오른쪽의 옵션버튼은 해당 작업의 열 표시 설정을 엽니다.
- 메뉴 영역에서 마우스가 벗어나면 펼쳐진 하위메뉴가 닫힙니다.
- 사이드바 중간의 오른쪽 화살표나 세로 위치 표시를 누르면 원래 메뉴창으로 복귀합니다.
- 메뉴창 접힘 상태는 같은 계정·브라우저에 저장됩니다. 다른 PC와 자동 동기화되지는 않습니다. 모바일 폭에서는 기존 메뉴 방식이 유지됩니다.
8. 스마트 제목버튼 — 전체 공통 표 사용법
- 직원관리·외국인관리·근태관리·급여정산·4대보험·제증명 등 실제 표 열 제목에서 사용합니다.
- 마우스를 열 제목에 올리면 제목 왼쪽 ▲(오름차순), ▼(내림차순)과 오른쪽 ▾(값 필터) 버튼이 표시됩니다. 키보드 초점·모바일 터치를 지원합니다.
- ▲ 또는 ▼를 누르면 화면에 현재 로드된 표 행이 정렬됩니다. 다른 곳으로 옮기면 아이콘은 숨겨지지만 정렬 결과는 유지됩니다.
- 오른쪽 ▾를 열면 맨 위 복수선택이 나타납니다. 한 값 클릭은 단일 필터, 복수선택 후 여러 값을 체크해 확인하면 다중 필터가 적용됩니다.
- 여러 열에 필터를 함께 적용할 수 있습니다. 필터가 사용 중인 제목은 음영·상태 표시로 구별됩니다. 제목을 눌러 해당 열의 필터를 해제할 수 있습니다.
- 제목의 드래그 손잡이를 끌면 열 위치가 바뀝니다. 제목 오른쪽 경계선을 드래그하면 너비가 바뀝니다.
- 직원관리의 기존 옵션버튼(슬라이더 형태)은 표시할 항목을 선택하는 기능이며 스마트 버튼과 별개입니다.
- 사용자·작업창별 열 순서·폭·필터·정렬 상태가 저장됩니다. 화면에 로드된 행만 대상인 일반 공통 표에서는 대량 가상 스크롤 DB 전체 정렬이 지원되지 않을 수 있습니다.
9. 직원관리와 외국인·근태관리
- 인사관리 → 직원관리에서 신규 직원 등록, 직원정보 수정, 엑셀 가져오기를 이용합니다.
- 직원명·사번·부서를 검색하고, 표 제목 옵션버튼으로 필요한 열만 선택합니다.
- 직원정보 수정 중 외국인 추가정보를 누르면 여권·등록증·체류자격·계약종료일 등의 별도 정보를 관리합니다.
- 등록증과 여권은 기존 암호화 사진이 있어야 권한 있는 관리자만 열람·인쇄할 수 있으며 화면을 열면 감사이력이 남습니다.
- 근태관리의 일별 근태 기록을 수정하면 월 근태 합계가 반영됩니다. 빠른편집에서 근태 집계값만 임의 수정할 수 없습니다.
- 직원 삭제는 기록이 없는 직원만 가능하고, 급여·근태·발급 기록 등이 있으면 삭제하지 않고 퇴사 상태로 보존합니다.
10. 인사·급여 빠른편집
- 왼쪽 메뉴창의 인사관리·급여관리 아래 빠른편집을 누릅니다.
- 오른쪽 옵션버튼으로 제목 표시 항목을 선택합니다.
직원은 필수이며 외국인 전용 항목은 국적을 표시할 때 선택할 수 있습니다.
- 직원 제목 아래 입력칸은 이름·사번 검색이며 전체 적용이 아닙니다.
- 제목 바로 아래 다른 입력칸에 값을 입력하면 전체 적용 말풍선이 나타납니다. 현재 필터 대상 직원 전체에 화면상 임시 반영됩니다.
- 저장을 눌러야 DB에 기록됩니다. 저장 전 취소를 누르면 변경 내용을 되돌릴 수 있습니다.
- 과거 수정이력은 관리자 변경이력에서 조회합니다. 복원은 최신 수정 여부·월마감 상태 등의 조건에 따라 제한됩니다.
- 외국인 서류와 월별 근태 합계 등 조회 전용 셀은 기존 원본 수정창으로 연결됩니다.
11. 급여관리 — 직원별 급여정산 및 마감
- 급여관리에서 정산 귀속월을 선택하고 월 정산을 시작합니다. 월 생성 당시 등록 직원과 급여자료가 스냅샷으로 저장됩니다.
- 직원별 상세 화면에서 일반·연장·야간·휴일시간과 지급·공제 항목을 확인합니다.
- 프로그램 계산값과 근로계약서·근태·법정수당 산정기준 및 공단 고지액을 대조합니다.
- 전원 확인이 끝난 후 월 마감을 진행합니다. 마감 뒤에는 일반 편집을 제한하고 정정은 권한 있는 담당자의 별도 절차를 사용합니다.
- 급여계약·검증 화면에서는 이름·사번을 입력하면 후보 목록이 나옵니다. 동명이인은 사번·부서로 구분해 선택합니다.
- 시급제·월급제·연봉제와 연장·야간·휴일 각각의 고정수당 포함 여부를 설정할 수 있습니다. 이 계산 미리보기는 검토용이며 실지급액을 자동 변경하지 않습니다.
- 4대보험·소득세 자동 확정·계좌이체·공식 신고는 이 버전에서 지원되지 않습니다.
12. 급여 계산식 관리 상세 따라하기
- 관리자 모드에서 급여관리 → ∑ 급여 계산식 관리로 이동합니다.
- 새 초안을 누르면 편집 중이던 초안이 초기화됩니다. 저장되지 않은 변경이 있다면 먼저 확인합니다.
- 계산 항목(기본급·통상시급 검토·연장·야간·휴일·일할·연봉 월환산·사용자정의 등), 급여 유형, 검토 귀속월을 설정합니다.
- 계산식 영역 아래의 변수 선택에서
월급여, 연봉, 기준시급, 통상시급, 연장시간, 야간시간, 휴일시간 등을 클릭합니다. 한글 변수 칩으로 수식 영역에 추가됩니다.
- 이미 선택된 변수를 다시 누르면 선택이 취소됩니다. 선택 중인 변수는 색상으로 구분됩니다.
- 사칙연산의 +, −, ×, ÷, 괄호와 숫자 입력을 이용해 계산식을 조립합니다. 숫자
1.5를 곱하면 기준시급 × 연장시간 × 1.5 같은 검토식이 됩니다.
- 계산 미리보기를 눌러 예시값 계산 결과와 오류를 확인합니다. 실제 직원 급여에는 적용되지 않습니다.
- 결과가 적절하면 초안 저장을 누릅니다. 초안 목록에 항목·급여유형·검토월·버전이 표시됩니다.
- 초안 목록 수식 위에 마우스를 올리면 팝업에서 전체 수식을 확인할 수 있습니다. 수정 버튼으로 수식 편집 화면에 다시 불러옵니다.
- 변경이력에는 새 버전이 기록됩니다. 아직 승인·확정 계산식을 실급여 엔진으로 자동 적용하는 기능은 미완료입니다.
13. 4대보험·제증명·매뉴얼
- 4대보험 → 취득·상실 대상 조회와 내부 처리 기록을 관리합니다. 공식 신고는 별도로 해야 합니다.
- 제증명 → 재직·경력증명서 발급 및 발급대장을 확인합니다. 실제 발급 전 회사정보·용도·직원을 검토합니다.
- 관리자 모드 → 설정·백업 → 이용 매뉴얼에서 자세한 따라하기를 볼 수 있습니다. 사용자 모드에서도 상단의 매뉴얼 링크를 사용할 수 있습니다.
14. 백업, 버전 점검, 업데이트
- 서버 PC에서 기존 프로그램 설치 폴더 전체, 특히
data/payroll.sqlite3, data/sensitive.key와 첨부파일을 백업합니다.
- 기존 서버를 종료하고 포트
8790에 중복 실행된 프로세스가 없는지 확인합니다. 127.0.0.1:8790과 사내 IP:8790이 서로 다른 폴더의 앱을 실행하지 않도록 합니다.
- 전체 새 버전을 적용할 때는 새 빈 폴더에 압축 해제하고 기존 DB·암호키·사진은 복사본으로 옮겨 시험합니다. 다른 기준 버전의 교체 패치를 무작정 덮어쓰지 마세요.
/health의 실제 서버 버전과 화면 메뉴창 하단의 UI 버전이 동일해야 합니다. 불일치가 뜨면 서버/화면 코드 경로·캐시·중복 프로세스부터 확인합니다.
- 브라우저에서
Ctrl+F5로 새로고침하고 메뉴창 접기, 스마트 버튼, 직원검색, 급여계약 검토, 계산식 초안, 사용자 모드 조회, 관리자 권한 차단을 시험합니다.
- 급여정보가 포함된 사내망 서비스는 개인정보보호를 위해 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 스마트 제목 버튼과 화면 이동
- 넓은 열은 ▲▼ 정렬 및 ▾ 필터를 제목 내부에서 이용합니다.
- 좁은 열은 마우스를 제목 위에 올리거나 키보드로 초점을 옮기면 제목 아래에 ▲▼▾ 버튼이 표시됩니다. 마우스를 아래 버튼으로 이동해 조작합니다. 모바일에서는 좁은 제목을 터치해 버튼을 표시합니다.
- ▾ 하위 메뉴의 복수선택과 단일선택, 여러 제목 필터, 제목 이동과 너비 조절, 사용자별 설정 저장은 기존 방식대로 이용합니다.
- 사용자 모드 첫 화면에서 마지막 작업화면 버튼을 누르면 해당 계정에서 최근 이용했던 조회 화면으로 이동합니다. 관리자 모드는 재인증 없이 열리지 않습니다.
- PC 마우스를 스크롤 가능한 작업창의 가장자리에 가져가면 부드럽게 위·아래·좌·우 이동합니다. 입력창·팝업에서는 동작하지 않습니다.
이 기능은 화면 편의성을 개선하며 급여 실지급·마감 데이터를 수정하지 않습니다.
v0.11.3 관리자 모드 비밀번호 창
사용자 모드 상단에서 관리자 모드로 전환을 누르면 독립된 비밀번호 재확인 창이 가장 앞에 열립니다. 입력 후 Enter 또는 관리자 모드 열기를 누르세요. 빈 입력과 잘못된 암호는 관리자 화면으로 이동하지 않습니다. 창이 열리지 않으면 프로그램 종료 후 파일 일치 및 Ctrl+F5를 확인하세요.
v0.11.4 빠른편집 외국인 단일 팝업·이름열 고정
- 인사관리 빠른편집에서 직원 이름은 가로 스크롤을 움직여도 왼쪽에 고정됩니다. 이름 열의 이동은 허용하지 않으며, 저장된 기존 순서는 이름을 맨 앞으로 정리합니다.
- 점선으로 표시되던 개별수정 연결을 일반 글자로 바꿨습니다. 마우스 호버나 키보드 포커스 시 선택 가능 여부를 확인할 수 있습니다.
- 일괄입력 행에서 직접 변경할 수 없는 항목은 반복된 조회 전용 글자 대신 — 로 표시합니다. 원래 편집권한은 유지됩니다.
- 외국인 직원의 체류자격 등 외국인 상세 항목을 클릭하면 외국인 추가정보 팝업 한 개만 열립니다. 한국 국적 직원은 열람·저장할 수 없습니다.
- 빠른편집에서 열린 외국인 정보 팝업의 저장하기는 해당 직원의 외국인 정보·허용된 첨부사진만 별도 갱신합니다. 취소하면 저장하지 않습니다. 기존 직원관리 메뉴의 2단계 편집 방식은 그대로 유지됩니다.
- 민감 번호 원문은 화면에서 기본적으로 마스킹되며, 기존 암호화·권한·감사 기록은 보존됩니다.
설치 전 data/payroll.sqlite3, data/sensitive.key 및 첨부 데이터가 포함된 전체 설치 폴더를 반드시 백업하세요. 회사 PC 실직원 DB에 대한 현장 검증은 별도로 필요합니다.