14. Employee 서비스

client.employee() 으로 접근합니다. 직원(Employee)의 CRUD와 카운트를 제공합니다.

14.1 메서드 일람

메서드	반환 타입	HTTP	엔드포인트
create(EmployeeRequestV5)	EmployeeResponseV5 또는 null	POST	/api/v5/employee
update(employee_id, EmployeeRequestV5)	EmployeeResponseV5 또는 null	PUT	/api/v5/employee/{id}
delete(employee_id)	boolean	DELETE	/api/v5/employee/{id}
get(employee_id)	EmployeeResponseV5 또는 null	GET	/api/v5/employee/{id}
list()	List<EmployeeResponseV5>	GET	/api/v5/employee
exists(employee_id)	boolean	GET	/api/v5/employee/{id}/exists
count()	long	GET	/api/v5/employee/count

14.2 EmployeeRequestV5 / EmployeeResponseV5

필드	타입	설명
employee_id	String	직원 ID (PK, 보통 사번)
name	String	이름
site_id	String	소속 사이트
org_id	String	조직 ID
email	String	이메일
phone	String	전화번호
role_code	String	역할 코드 (OPERATOR, SUPERVISOR, ENGINEER 등)
department	String	부서

14.3 사용 예시

직원 생성

import plantpulse.api.v5.dto.request.EmployeeRequestV5;
import plantpulse.api.v5.dto.response.EmployeeResponseV5;

EmployeeRequestV5 req = new EmployeeRequestV5();
req.setEmployee_id("EMPLOYEE_E12345");
req.setName("홍길동");
req.setSite_id("SITE_DJ");
req.setOrg_id("ORG_100");
req.setEmail("hong@example.com");
req.setPhone("01012345678");
req.setRole_code("OPERATOR");
req.setDepartment("생산1팀");

EmployeeResponseV5 created = client.employee().create(req);

조회

EmployeeResponseV5 emp = client.employee().get("EMPLOYEE_E12345");
if (emp != null) {
    System.out.println(emp.getName() + " - " + emp.getDepartment());
}

전체 목록 + 부서별 필터링

import java.util.List;
import java.util.stream.Collectors;

List<EmployeeResponseV5> all = client.employee().list();

List<EmployeeResponseV5> 생산1팀 = all.stream()
        .filter(e -> "생산1팀".equals(e.getDepartment()))
        .collect(Collectors.toList());

카운트

long total = client.employee().count();

수정 / 삭제

EmployeeRequestV5 update = new EmployeeRequestV5();
update.setEmployee_id("EMPLOYEE_E12345");
update.setName("홍길동");
update.setSite_id("SITE_DJ");
update.setRole_code("SUPERVISOR");          // 승진
client.employee().update("EMPLOYEE_E12345", update);

client.employee().delete("EMPLOYEE_E12345");

프론트라인 로그인 계정

직원이 현장 태블릿 앱(프론트라인)에 로그인하는 계정(로그인 번호 · PIN · 역할 · 맡은 범위 · 화면 언어 · 테마)은 V5 /api/v5/app-accounts/frontline 에 있습니다. 직원 한 명에 계정 하나이고, 직원을 지우면 계정도 지워집니다. SDK 메서드는 없고 ADMIN 토큰 또는 플랫폼 마스터 키로만 부릅니다. 호출 목록은 작업자 계정 V5, 콘솔 화면은 작업자 계정을 봅니다.

다음 단계

• Customer 서비스
• Product 서비스
• Order 서비스 — 작업지시에 직원 할당