출퇴근을 관리하는 플러그인 1.0.0

2026.07.01 18:24(수정됨) 3 0 1

## 개요

사원 출퇴근을 관리하는 ERP 플러그인입니다.
고유코드 기반 기기 인증으로 특정 기기에서만 출퇴근이 가능하며,
지각/조퇴/결근을 자동 판정하고 대시보드에서 실시간 현황을 확인할 수 있습니다.

## 설치 방법

1. `plugins/dx-attendance-erp/` 폴더를 DXCMS `plugins/` 경로에 업로드
2. 관리자 → 플러그인 → `출퇴근 ERP` → **활성화하기**
3. DB 테이블 자동 생성 (별도 설치 불필요)

## DB 테이블

| 테이블 | 설명 |
|---|---|
| `dx_erp_employees` | 사원 정보 (타 ERP 플러그인과 공유) |
| `dx_erp_attendance` | 출퇴근 기록 |
| `dx_erp_settings` | 플러그인 설정 |

## 관리자 메뉴

관리자 → **인사 ERP** → **출퇴근 ERP**

### 대시보드

- 오늘 전체 사원 / 출근 / 지각 / 조퇴 / 결근 현황 카드
- 오늘 출퇴근 상세 목록 (이름 / 부서 / 출근시간 / 상태)
- 부서별 출근 현황 바 차트

### 사원 관리

- 사원 등록 (이름 / 부서 / 직급 / 입사일 / 출퇴근 기준시간)
- 사원번호 자동 생성 (`EMP-날짜-순번`)
- 고유코드 발급 및 재발급
- 코드 재발급 시 기기 등록 초기화

### 출퇴근 기록

- 날짜 / 사원별 기록 조회
- 출근 / 퇴근 / 지각 / 조퇴 / 결근 상태 표시
- IP 기록

### 설정

- 회사명
- 출근 기준시간 (기본 09:00)
- 퇴근 기준시간 (기본 18:00)
- 지각 기준시간 (기본 09:01)
- 조퇴 기준시간 (기본 18:00)

## 사원 등록 순서

1. **관리자** → 사원 관리 → 사원 등록
2. 이름 / 부서 / 직급 / 입사일 입력 후 저장
3. **고유코드**가 화면에 딱 1회 표시됨 → 반드시 메모 후 사원에게 직접 전달
4. 코드는 DB에 SHA256 해시로만 저장 (원본 복구 불가)

## 사원 첫 출근 등록

1. 사원이 출퇴근 전용 페이지 접속: `/erp-punch`
2. **관리자에게 받은 고유코드 입력**
3. 최초 1회만 코드를 입력하면 해당 기기에 등록됨
4. 이후 코드 입력 없이 출근 / 퇴근 버튼만 클릭

## 보안 구조

고유코드 발급
→ 관리자 화면에서 1회만 표시
→ DB에는 SHA256 해시만 저장

최초 등록 시
→ 고유코드 + 기기 핑거프린트 서버 검증
→ 기기 핑거프린트(Canvas + WebGL + UA 등) DB 저장
→ localStorage에 "등록됨" 표시만 저장 (코드 절대 저장 안 함)

이후 출퇴근
→ 기기 핑거프린트만으로 인증
→ 다른 기기에서는 출퇴근 불가

## 출퇴근 판정 기준

| 상황 | 판정 |
|---|---|
| 출근 기준시간 이내 출근 | 정상 |
| 출근 기준시간 이후 출근 | 지각 |
| 퇴근 기준시간 이후 퇴근 | 정상 |
| 퇴근 기준시간 이전 퇴근 | 조퇴 |
| 당일 출근 기록 없음 | 결근 |

> 사원별로 출퇴근 기준시간을 개별 설정할 수 있습니다.

## 주의사항

- 고유코드는 발급 직후 한 번만 표시됩니다. 반드시 즉시 전달하세요.
- 기기 핑거프린트는 브라우저 업데이트 시 변경될 수 있습니다. 이 경우 관리자가 코드를 재발급하세요.
- `/erp-punch` URL을 사원들에게 공유하세요.
- 타 ERP 플러그인(급여/휴가/자산/인사)과 사원 DB를 공유합니다.

인트라넷과 ERP를 경험하도록 하죠. 가즈아~~~~~~~~~~~~~~

https://dxcmsboard.com

관리자 아이디 : admin / 비밀번호 : 12341234

이 프로그램은 독립으로 사용할 수도 있습니다.
인사관리ERP이지만, 하나하나 메뉴로 구성해서 만들어봤습니다.

dx-erp-suite.zip 파일은
휴가/연차 관리
급여관리
인사관리
자산관리

플러그인입니다.
하나하나 설치해보고 분석해서 멋진 ERP들을 개발하세요.