feat: ItemMaster Phase 2 API 구현 (확장 기능 11개 엔드포인트)

- Controller 3개, Service 3개, FormRequest 6개 생성
- Routes 등록 (BOM 항목, 섹션 템플릿, 마스터 필드)
- Service-First, Multi-tenant, Soft Delete
- 라우트 테스트 및 Pint 검사 통과

13 files changed, 600+ insertions(+)
This commit is contained in:
2025-11-20 17:07:40 +09:00
parent 4ccee253b6
commit 28a943bf8e
14 changed files with 776 additions and 1 deletions

View File

@@ -0,0 +1,48 @@
<?php
namespace App\Http\Controllers\Api\V1\ItemMaster;
use App\Http\Controllers\Controller;
use App\Http\Requests\ItemMaster\ItemBomItemStoreRequest;
use App\Http\Requests\ItemMaster\ItemBomItemUpdateRequest;
use App\Http\Responses\ApiResponse;
use App\Services\ItemMaster\ItemBomItemService;
class ItemBomItemController extends Controller
{
public function __construct(
protected ItemBomItemService $service,
) {}
/**
* BOM 항목 생성
*/
public function store(int $sectionId, ItemBomItemStoreRequest $request)
{
return ApiResponse::handle(function () use ($sectionId, $request) {
return $this->service->store($sectionId, $request->validated());
}, __('message.created'));
}
/**
* BOM 항목 수정
*/
public function update(int $id, ItemBomItemUpdateRequest $request)
{
return ApiResponse::handle(function () use ($id, $request) {
return $this->service->update($id, $request->validated());
}, __('message.updated'));
}
/**
* BOM 항목 삭제
*/
public function destroy(int $id)
{
return ApiResponse::handle(function () use ($id) {
$this->service->destroy($id);
return 'success';
}, __('message.deleted'));
}
}

View File

@@ -0,0 +1,58 @@
<?php
namespace App\Http\Controllers\Api\V1\ItemMaster;
use App\Http\Controllers\Controller;
use App\Http\Requests\ItemMaster\ItemMasterFieldStoreRequest;
use App\Http\Requests\ItemMaster\ItemMasterFieldUpdateRequest;
use App\Http\Responses\ApiResponse;
use App\Services\ItemMaster\ItemMasterFieldService;
class ItemMasterFieldController extends Controller
{
public function __construct(
protected ItemMasterFieldService $service,
) {}
/**
* 마스터 필드 목록
*/
public function index()
{
return ApiResponse::handle(function () {
return $this->service->index();
}, __('message.fetched'));
}
/**
* 마스터 필드 생성
*/
public function store(ItemMasterFieldStoreRequest $request)
{
return ApiResponse::handle(function () use ($request) {
return $this->service->store($request->validated());
}, __('message.created'));
}
/**
* 마스터 필드 수정
*/
public function update(int $id, ItemMasterFieldUpdateRequest $request)
{
return ApiResponse::handle(function () use ($id, $request) {
return $this->service->update($id, $request->validated());
}, __('message.updated'));
}
/**
* 마스터 필드 삭제
*/
public function destroy(int $id)
{
return ApiResponse::handle(function () use ($id) {
$this->service->destroy($id);
return 'success';
}, __('message.deleted'));
}
}

View File

@@ -0,0 +1,58 @@
<?php
namespace App\Http\Controllers\Api\V1\ItemMaster;
use App\Http\Controllers\Controller;
use App\Http\Requests\ItemMaster\SectionTemplateStoreRequest;
use App\Http\Requests\ItemMaster\SectionTemplateUpdateRequest;
use App\Http\Responses\ApiResponse;
use App\Services\ItemMaster\SectionTemplateService;
class SectionTemplateController extends Controller
{
public function __construct(
protected SectionTemplateService $service,
) {}
/**
* 섹션 템플릿 목록
*/
public function index()
{
return ApiResponse::handle(function () {
return $this->service->index();
}, __('message.fetched'));
}
/**
* 섹션 템플릿 생성
*/
public function store(SectionTemplateStoreRequest $request)
{
return ApiResponse::handle(function () use ($request) {
return $this->service->store($request->validated());
}, __('message.created'));
}
/**
* 섹션 템플릿 수정
*/
public function update(int $id, SectionTemplateUpdateRequest $request)
{
return ApiResponse::handle(function () use ($id, $request) {
return $this->service->update($id, $request->validated());
}, __('message.updated'));
}
/**
* 섹션 템플릿 삭제
*/
public function destroy(int $id)
{
return ApiResponse::handle(function () use ($id) {
$this->service->destroy($id);
return 'success';
}, __('message.deleted'));
}
}

View File

@@ -0,0 +1,27 @@
<?php
namespace App\Http\Requests\ItemMaster;
use Illuminate\Foundation\Http\FormRequest;
class ItemBomItemStoreRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'item_code' => 'nullable|string|max:100',
'item_name' => 'required|string|max:255',
'quantity' => 'nullable|numeric|min:0',
'unit' => 'nullable|string|max:50',
'unit_price' => 'nullable|numeric|min:0',
'total_price' => 'nullable|numeric|min:0',
'spec' => 'nullable|string',
'note' => 'nullable|string',
];
}
}

View File

@@ -0,0 +1,27 @@
<?php
namespace App\Http\Requests\ItemMaster;
use Illuminate\Foundation\Http\FormRequest;
class ItemBomItemUpdateRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'item_code' => 'sometimes|nullable|string|max:100',
'item_name' => 'sometimes|string|max:255',
'quantity' => 'sometimes|nullable|numeric|min:0',
'unit' => 'sometimes|nullable|string|max:50',
'unit_price' => 'sometimes|nullable|numeric|min:0',
'total_price' => 'sometimes|nullable|numeric|min:0',
'spec' => 'sometimes|nullable|string',
'note' => 'sometimes|nullable|string',
];
}
}

View File

@@ -0,0 +1,28 @@
<?php
namespace App\Http\Requests\ItemMaster;
use Illuminate\Foundation\Http\FormRequest;
class ItemMasterFieldStoreRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'field_name' => 'required|string|max:255',
'field_type' => 'required|in:textbox,number,dropdown,checkbox,date,textarea',
'category' => 'nullable|string|max:100',
'description' => 'nullable|string',
'is_common' => 'nullable|boolean',
'default_value' => 'nullable|string',
'options' => 'nullable|array',
'validation_rules' => 'nullable|array',
'properties' => 'nullable|array',
];
}
}

View File

@@ -0,0 +1,28 @@
<?php
namespace App\Http\Requests\ItemMaster;
use Illuminate\Foundation\Http\FormRequest;
class ItemMasterFieldUpdateRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'field_name' => 'sometimes|string|max:255',
'field_type' => 'sometimes|in:textbox,number,dropdown,checkbox,date,textarea',
'category' => 'sometimes|nullable|string|max:100',
'description' => 'sometimes|nullable|string',
'is_common' => 'sometimes|nullable|boolean',
'default_value' => 'sometimes|nullable|string',
'options' => 'sometimes|nullable|array',
'validation_rules' => 'sometimes|nullable|array',
'properties' => 'sometimes|nullable|array',
];
}
}

View File

@@ -0,0 +1,23 @@
<?php
namespace App\Http\Requests\ItemMaster;
use Illuminate\Foundation\Http\FormRequest;
class SectionTemplateStoreRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'title' => 'required|string|max:255',
'type' => 'required|in:fields,bom',
'description' => 'nullable|string',
'is_default' => 'nullable|boolean',
];
}
}

View File

@@ -0,0 +1,23 @@
<?php
namespace App\Http\Requests\ItemMaster;
use Illuminate\Foundation\Http\FormRequest;
class SectionTemplateUpdateRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'title' => 'sometimes|string|max:255',
'type' => 'sometimes|in:fields,bom',
'description' => 'sometimes|nullable|string',
'is_default' => 'sometimes|nullable|boolean',
];
}
}