sam-docs/plans/sub/labor-plan.md

노임관리 (Labor) API 연동 계획

작성일: 2026-01-08 상위 문서: construction-api-integration-plan.md 상태: ✅ 완료 완료일: 2026-01-12

---

1. 컴포넌트 분석

1.1 파일 위치

react/src/
├── app/[locale]/(protected)/construction/order/base-info/labor/
│   └── page.tsx
└── components/business/construction/labor-management/
    ├── LaborManagementClient.tsx
    ├── actions.ts
    └── types.ts

1.2 현재 Mock 데이터

actions.ts 내 Mock 함수:

// getLaborList에서 Mock 노임 데이터 생성
// 노임: 직종, 일당, 시급, 적용일 등

1.3 현재 함수 목록

함수명	용도	Mock 상태
getLaborList	노임 목록 조회	✅ Mock
getLaborStats	노임 통계 조회	✅ Mock
deleteLabor	노임 삭제	✅ Mock
deleteLaborBulk	노임 일괄 삭제	✅ Mock

---

2. API 설계

2.1 엔드포인트

Method	Endpoint	용도
GET	/api/construction/labor	목록 조회
GET	/api/construction/labor/stats	통계 조회
GET	/api/construction/labor/{id}	상세 조회
POST	/api/construction/labor	등록
PUT	/api/construction/labor/{id}	수정
DELETE	/api/construction/labor/{id}	삭제
DELETE	/api/construction/labor/bulk	일괄 삭제

2.2 요청/응답 스키마

목록 조회 Request:

interface GetLaborListParams {
  page?: number;
  size?: number;
  jobType?: string;
  status?: LaborStatus;
  search?: string;
}

---

3. 작업 항목

3.1 Backend (API)

#	작업	상태	비고
1	LaborController 생성	✅	api/app/Http/Controllers/Api/V1/LaborController.php
2	LaborService 생성	✅	api/app/Services/LaborService.php
3	LaborFormRequest 생성	✅	LaborIndexRequest, LaborStoreRequest, LaborUpdateRequest, LaborBulkDeleteRequest
4	Labor 모델 생성	✅	api/app/Models/Labor.php
5	routes/api.php 등록	✅	/labor prefix
6	Swagger 문서 작성	⚠️	추후 보완 필요

3.2 Frontend (React)

#	작업	상태	비고
1	actions.ts Mock → API 변환	✅	apiClient 사용
2	API 클라이언트 연동	✅	완료
3	에러 핸들링 추가	✅	try-catch 구현
4	types.ts 정합성 확인	✅	완료

---

4. 타입 정의

4.1 Labor 타입

interface Labor {
  id: string;
  laborCode: string;
  jobType: string;           // 직종 (예: 목공, 철근공, 용접공)
  jobCategory: string;       // 직종 분류
  dailyWage: number;         // 일당
  hourlyWage: number;        // 시급
  effectiveDate: string;     // 적용일
  expirationDate?: string;   // 만료일
  status: LaborStatus;
  description?: string;
  createdAt: string;
  updatedAt: string;
}

type LaborStatus = 'active' | 'inactive' | 'expired';

4.2 LaborStats 타입

interface LaborStats {
  total: number;
  active: number;
  inactive: number;
  averageDailyWage: number;
  byJobCategory: {
    category: string;
    count: number;
    averageWage: number;
  }[];
}

---

5. 변경 이력

날짜	작업	상태
2026-01-08	문서 초안 작성	✅
2026-01-12	Backend + Frontend API 연동 완료 확인	✅

---

상위 문서: construction-api-integration-plan.md