# API 엔드포인트 목록

> **작성일**: 2025-12-20
> **분석 대상**: `api/routes/api.php` (1000+ lines)
> **총 엔드포인트 수**: 150+ endpoints

---

## 1. 인증 (Authentication)

| Method | Endpoint | 설명 | 미들웨어 |
|--------|----------|------|----------|
| POST | `/auth/login` | 로그인 | - |
| POST | `/auth/logout` | 로그아웃 | auth:sanctum |
| GET | `/auth/me` | 현재 사용자 정보 | auth:sanctum |
| POST | `/auth/refresh` | 토큰 갱신 | auth:sanctum |

---

## 2. 품목 관리 (Items)

### 2.1 품목 기본

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/items` | 품목 목록 | ItemController@index |
| POST | `/items` | 품목 생성 | ItemController@store |
| GET | `/items/{item}` | 품목 상세 | ItemController@show |
| PUT | `/items/{item}` | 품목 수정 | ItemController@update |
| DELETE | `/items/{item}` | 품목 삭제 | ItemController@destroy |
| POST | `/items/{item}/files` | 파일 업로드 | ItemFileController@store |
| DELETE | `/items/{item}/files/{file}` | 파일 삭제 | ItemFileController@destroy |

### 2.2 BOM 관리

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/items/{item}/bom` | BOM 조회 | ItemBomController@index |
| POST | `/items/{item}/bom` | BOM 구성요소 추가 | ItemBomController@store |
| PUT | `/items/{item}/bom/{component}` | BOM 수정 | ItemBomController@update |
| DELETE | `/items/{item}/bom/{component}` | BOM 삭제 | ItemBomController@destroy |

### 2.3 품목 마스터

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/item-master/categories` | 카테고리 목록 | ItemMasterController |
| POST | `/item-master/categories` | 카테고리 생성 | ItemMasterController |
| PUT | `/item-master/categories/{id}` | 카테고리 수정 | ItemMasterController |
| DELETE | `/item-master/categories/{id}` | 카테고리 삭제 | ItemMasterController |
| GET | `/item-master/brands` | 브랜드 목록 | ItemMasterController |
| GET | `/item-master/units` | 단위 목록 | ItemMasterController |
| GET | `/item-master/manufacturers` | 제조사 목록 | ItemMasterController |
| GET | `/item-master/warehouses` | 창고 목록 | ItemMasterController |
| GET | `/item-master/item-types` | 품목유형 목록 | ItemMasterController |
| GET | `/item-master/origins` | 원산지 목록 | ItemMasterController |
| GET | `/item-master/tax-types` | 세금유형 목록 | ItemMasterController |

---

## 3. 거래처 관리 (Clients)

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/clients` | 거래처 목록 | ClientController@index |
| POST | `/clients` | 거래처 생성 | ClientController@store |
| GET | `/clients/{client}` | 거래처 상세 | ClientController@show |
| PUT | `/clients/{client}` | 거래처 수정 | ClientController@update |
| DELETE | `/clients/{client}` | 거래처 삭제 | ClientController@destroy |

---

## 4. 단가 관리 (Pricing)

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/pricing` | 단가 목록 | PricingController@index |
| POST | `/pricing` | 단가 생성 | PricingController@store |
| GET | `/pricing/{pricing}` | 단가 상세 | PricingController@show |
| PUT | `/pricing/{pricing}` | 단가 수정 | PricingController@update |
| DELETE | `/pricing/{pricing}` | 단가 삭제 | PricingController@destroy |
| POST | `/pricing/bulk` | 대량 등록 | PricingController@bulkStore |
| GET | `/pricing/history/{itemId}` | 단가 이력 | PricingController@history |

---

## 5. 견적 관리 (Quotes)

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/quotes` | 견적 목록 | QuoteController@index |
| POST | `/quotes` | 견적 생성 | QuoteController@store |
| GET | `/quotes/{quote}` | 견적 상세 | QuoteController@show |
| PUT | `/quotes/{quote}` | 견적 수정 | QuoteController@update |
| DELETE | `/quotes/{quote}` | 견적 삭제 | QuoteController@destroy |
| POST | `/quotes/{quote}/send` | 견적 발송 | QuoteController@send |
| POST | `/quotes/{quote}/convert` | 주문 전환 | QuoteController@convert |

---

## 6. 주문 관리 (Orders)

### 6.1 판매주문

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/sales-orders` | 판매주문 목록 | SalesOrderController@index |
| POST | `/sales-orders` | 판매주문 생성 | SalesOrderController@store |
| GET | `/sales-orders/{order}` | 판매주문 상세 | SalesOrderController@show |
| PUT | `/sales-orders/{order}` | 판매주문 수정 | SalesOrderController@update |
| DELETE | `/sales-orders/{order}` | 판매주문 삭제 | SalesOrderController@destroy |

### 6.2 구매주문

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/purchase-orders` | 구매주문 목록 | PurchaseOrderController@index |
| POST | `/purchase-orders` | 구매주문 생성 | PurchaseOrderController@store |
| GET | `/purchase-orders/{order}` | 구매주문 상세 | PurchaseOrderController@show |
| PUT | `/purchase-orders/{order}` | 구매주문 수정 | PurchaseOrderController@update |
| DELETE | `/purchase-orders/{order}` | 구매주문 삭제 | PurchaseOrderController@destroy |

---

## 7. 회계 (Accounting)

### 7.1 매출

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/sales` | 매출 목록 | SalesController@index |
| POST | `/sales` | 매출 등록 | SalesController@store |
| GET | `/sales/{sale}` | 매출 상세 | SalesController@show |
| PUT | `/sales/{sale}` | 매출 수정 | SalesController@update |
| DELETE | `/sales/{sale}` | 매출 삭제 | SalesController@destroy |

### 7.2 매입

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/purchases` | 매입 목록 | PurchaseController@index |
| POST | `/purchases` | 매입 등록 | PurchaseController@store |
| GET | `/purchases/{purchase}` | 매입 상세 | PurchaseController@show |
| PUT | `/purchases/{purchase}` | 매입 수정 | PurchaseController@update |
| DELETE | `/purchases/{purchase}` | 매입 삭제 | PurchaseController@destroy |

### 7.3 수금/지급

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/collections` | 수금 목록 | CollectionController@index |
| POST | `/collections` | 수금 등록 | CollectionController@store |
| GET | `/payments` | 지급 목록 | PaymentController@index |
| POST | `/payments` | 지급 등록 | PaymentController@store |

### 7.4 전표

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/slips` | 전표 목록 | SlipController@index |
| POST | `/slips` | 전표 생성 | SlipController@store |
| GET | `/slips/{slip}` | 전표 상세 | SlipController@show |

### 7.5 세금계산서

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/tax-invoices` | 세금계산서 목록 | TaxInvoiceController@index |
| POST | `/tax-invoices` | 세금계산서 발행 | TaxInvoiceController@store |
| POST | `/tax-invoices/{id}/send` | 전자발송 | TaxInvoiceController@send |

---

## 8. 인사 관리 (HR)

### 8.1 사원

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/employees` | 사원 목록 | EmployeeController@index |
| POST | `/employees` | 사원 등록 | EmployeeController@store |
| GET | `/employees/{employee}` | 사원 상세 | EmployeeController@show |
| PUT | `/employees/{employee}` | 사원 수정 | EmployeeController@update |
| DELETE | `/employees/{employee}` | 사원 삭제 | EmployeeController@destroy |

### 8.2 부서

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/departments` | 부서 목록 | DepartmentController@index |
| POST | `/departments` | 부서 생성 | DepartmentController@store |
| GET | `/departments/{department}` | 부서 상세 | DepartmentController@show |
| PUT | `/departments/{department}` | 부서 수정 | DepartmentController@update |
| DELETE | `/departments/{department}` | 부서 삭제 | DepartmentController@destroy |

### 8.3 근태

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/attendances` | 근태 목록 | AttendanceController@index |
| POST | `/attendances` | 근태 등록 | AttendanceController@store |
| POST | `/attendances/check-in` | 출근 | AttendanceController@checkIn |
| POST | `/attendances/check-out` | 퇴근 | AttendanceController@checkOut |

### 8.4 휴가

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/leaves` | 휴가 목록 | LeaveController@index |
| POST | `/leaves` | 휴가 신청 | LeaveController@store |
| PUT | `/leaves/{leave}` | 휴가 수정 | LeaveController@update |
| POST | `/leaves/{leave}/approve` | 휴가 승인 | LeaveController@approve |
| POST | `/leaves/{leave}/reject` | 휴가 반려 | LeaveController@reject |

### 8.5 급여

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/salaries` | 급여 목록 | SalaryController@index |
| POST | `/salaries` | 급여 등록 | SalaryController@store |
| GET | `/salaries/{salary}` | 급여 상세 | SalaryController@show |
| POST | `/salaries/calculate` | 급여 계산 | SalaryController@calculate |

---

## 9. 게시판 (Boards)

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/boards` | 게시판 목록 | BoardController@index |
| GET | `/boards/{board}` | 게시판 상세 | BoardController@show |
| GET | `/boards/{board}/posts` | 게시글 목록 | PostController@index |
| POST | `/boards/{board}/posts` | 게시글 작성 | PostController@store |
| GET | `/posts/{post}` | 게시글 상세 | PostController@show |
| PUT | `/posts/{post}` | 게시글 수정 | PostController@update |
| DELETE | `/posts/{post}` | 게시글 삭제 | PostController@destroy |
| POST | `/posts/{post}/comments` | 댓글 작성 | CommentController@store |

---

## 10. 결재 (Approvals)

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/approvals` | 결재 목록 | ApprovalController@index |
| POST | `/approvals` | 결재 요청 | ApprovalController@store |
| GET | `/approvals/{approval}` | 결재 상세 | ApprovalController@show |
| POST | `/approvals/{approval}/approve` | 승인 | ApprovalController@approve |
| POST | `/approvals/{approval}/reject` | 반려 | ApprovalController@reject |
| GET | `/approval-templates` | 결재 양식 | ApprovalTemplateController@index |
| GET | `/approval-lines` | 결재선 | ApprovalLineController@index |

---

## 11. 생산 관리 (Production)

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/production-orders` | 생산지시 목록 | ProductionOrderController@index |
| POST | `/production-orders` | 생산지시 생성 | ProductionOrderController@store |
| GET | `/production-orders/{order}` | 생산지시 상세 | ProductionOrderController@show |
| PUT | `/production-orders/{order}` | 생산지시 수정 | ProductionOrderController@update |
| POST | `/production-orders/{order}/start` | 작업 시작 | ProductionOrderController@start |
| POST | `/production-orders/{order}/complete` | 작업 완료 | ProductionOrderController@complete |
| GET | `/work-orders` | 작업지시 목록 | WorkOrderController@index |

---

## 12. 재고 관리 (Inventory)

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/inventory` | 재고 현황 | InventoryController@index |
| GET | `/inventory/{item}` | 품목별 재고 | InventoryController@show |
| POST | `/inventory/adjust` | 재고 조정 | InventoryController@adjust |
| GET | `/inventory/movements` | 재고 이동 이력 | InventoryController@movements |
| POST | `/inventory/transfer` | 창고간 이동 | InventoryController@transfer |

---

## 13. 설정 (Settings)

### 13.1 시스템 설정

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/settings` | 설정 조회 | SettingController@index |
| PUT | `/settings` | 설정 수정 | SettingController@update |
| GET | `/settings/company` | 회사 정보 | SettingController@company |

### 13.2 사용자/권한

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/users` | 사용자 목록 | UserController@index |
| POST | `/users` | 사용자 생성 | UserController@store |
| GET | `/users/{user}` | 사용자 상세 | UserController@show |
| PUT | `/users/{user}` | 사용자 수정 | UserController@update |
| GET | `/roles` | 역할 목록 | RoleController@index |
| POST | `/roles` | 역할 생성 | RoleController@store |
| GET | `/permissions` | 권한 목록 | PermissionController@index |
| GET | `/menus` | 메뉴 목록 | MenuController@index |

---

## 14. 대시보드/리포트

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/dashboard/summary` | 대시보드 요약 | DashboardController@summary |
| GET | `/dashboard/sales` | 매출 현황 | DashboardController@sales |
| GET | `/dashboard/inventory` | 재고 현황 | DashboardController@inventory |
| GET | `/reports/sales` | 매출 리포트 | ReportController@sales |
| GET | `/reports/purchase` | 매입 리포트 | ReportController@purchase |
| GET | `/reports/inventory` | 재고 리포트 | ReportController@inventory |

---

## 15. 고객센터

| Method | Endpoint | 설명 | Controller |
|--------|----------|------|------------|
| GET | `/notices` | 공지사항 | NoticeController@index |
| GET | `/faqs` | FAQ | FaqController@index |
| GET | `/inquiries` | 문의 목록 | InquiryController@index |
| POST | `/inquiries` | 문의 등록 | InquiryController@store |
| GET | `/inquiries/{inquiry}` | 문의 상세 | InquiryController@show |

---

## 요약

| 카테고리 | 엔드포인트 수 | 상태 |
|----------|--------------|------|
| 인증 | 4 | ✅ 구현완료 |
| 품목 관리 | 15+ | ✅ 구현완료 |
| 품목 마스터 | 20+ | ✅ 구현완료 |
| 거래처 | 5 | ✅ 구현완료 |
| 단가 | 7 | ✅ 구현완료 |
| 견적 | 7 | ⚠️ 일부 구현 |
| 주문 | 10 | ⚠️ 일부 구현 |
| 회계 | 20+ | ⚠️ 일부 구현 |
| 인사 | 20+ | ⚠️ 일부 구현 |
| 게시판 | 8 | ✅ 구현완료 |
| 결재 | 7 | ⚠️ 일부 구현 |
| 생산 | 7 | ⚠️ 일부 구현 |
| 재고 | 5 | ⚠️ 일부 구현 |
| 설정 | 10+ | ✅ 구현완료 |
| 대시보드/리포트 | 6 | ⚠️ 일부 구현 |
| 고객센터 | 5 | ⚠️ 일부 구현 |

**총계**: 약 150+ 엔드포인트

---

*이 문서는 Phase 3 API 분석의 일부로 작성되었습니다.*
