Files
sam-api/app/Http/Controllers/Api/V1/Design/BomTemplateController.php
hskwon 17fa82c35b feat: Design BOM 템플릿 diff/clone API 및 모델버전 릴리즈 유효성 검사 도입
- Design BOM 템플릿 diff/clone 엔드포인트 추가
- 컨트롤러 검증 로직 FormRequest 분리(DiffRequest/CloneRequest/Upsert/ReplaceItems)
- BomTemplateService에 diffTemplates/cloneTemplate/replaceItems/쇼우 로직 정리
- ModelVersionController createDraft FormRequest 적용 및 서비스 호출 정리
- 모델버전 release 전 유효성 검사(존재/활성/테넌트 일치, qty>0, 중복 금지) 추가
- DB enum 미사용 방침 준수(status 문자열 유지)
- model_versions 인덱스 최적화(tenant_id, model_id, status / 기간 범위)
- Swagger 문서(Design BOM) 및 i18n 메시지 키 추가
2025-09-11 13:39:32 +09:00

77 lines
2.8 KiB
PHP

<?php
namespace App\Http\Controllers\Api\V1\Design;
use App\Helpers\ApiResponse;
use App\Http\Controllers\Controller;
use App\Http\Requests\Design\BomTemplate\CloneRequest;
use App\Http\Requests\Design\BomTemplate\DiffRequest;
use App\Http\Requests\Design\BomTemplate\ReplaceItemsRequest;
use App\Http\Requests\Design\BomTemplate\UpsertRequest;
use App\Services\Design\BomTemplateService;
class BomTemplateController extends Controller
{
public function __construct(
protected BomTemplateService $service
) {}
public function listByVersion(int $versionId)
{
return ApiResponse::handle(function () use ($versionId) {
// 내부에서 tenant 스코프 처리
return $this->service->paginate($versionId, page: 1, size: PHP_INT_MAX)->items();
}, __('message.fetched'));
}
public function upsertTemplate(UpsertRequest $request, int $versionId)
{
return ApiResponse::handle(function () use ($request, $versionId) {
$payload = $request->validated();
return $this->service->upsertTemplate(
modelVersionId: $versionId,
name: $payload['name'] ?? 'Main',
isPrimary: (bool)($payload['is_primary'] ?? true),
notes: $payload['notes'] ?? null
);
}, __('message.created'));
}
public function show(int $templateId)
{
return ApiResponse::handle(fn() => $this->service->show($templateId, true), __('message.fetched'));
}
public function replaceItems(ReplaceItemsRequest $request, int $templateId)
{
return ApiResponse::handle(function () use ($request, $templateId) {
$payload = $request->validated();
$this->service->replaceItems($templateId, $payload['items']);
return null;
}, __('message.bom.bulk_upsert'));
}
public function diff(int $templateId, DiffRequest $request)
{
return ApiResponse::handle(function () use ($templateId, $request) {
$otherId = $request->validated()['other_template_id'];
return $this->service->diffTemplates($templateId, $otherId);
}, __('message.design.template_diff'));
}
public function cloneTemplate(int $templateId, CloneRequest $request)
{
return ApiResponse::handle(function () use ($templateId, $request) {
$payload = $request->validated();
$tpl = $this->service->cloneTemplate(
templateId: $templateId,
targetVersionId: $payload['target_version_id'] ?? null,
name: $payload['name'] ?? null,
isPrimary: (bool)($payload['is_primary'] ?? false),
notes: $payload['notes'] ?? null
);
return $tpl;
}, __('message.design.template_cloned'));
}
}