Files
sam-api/app/Services/ItemMaster/ItemPageService.php
hskwon 4ccee253b6 feat: ItemMaster Phase 1 API 구현 (핵심 기능 13개 엔드포인트)
- Controller 4개 생성 (ItemMaster, ItemPage, ItemSection, ItemField)
- Service 4개 생성 (비즈니스 로직 및 Multi-tenant 지원)
- FormRequest 7개 생성 (Validation)
- Routes 등록 (/v1/item-master/*)

주요 API:
- GET /init - 전체 초기 데이터 로드
- 페이지 관리 (GET/POST/PUT/DELETE)
- 섹션 관리 (POST/PUT/DELETE/reorder)
- 필드 관리 (POST/PUT/DELETE/reorder)

기술적 특징:
- Service-First 패턴 (Controller는 DI + ApiResponse만)
- Multi-tenant 지원 (tenantId() 검증 + BelongsToTenant)
- Cascade Soft Delete (하위 엔티티 자동 처리)
- i18n 메시지 키 사용 (__('message.xxx'))
- order_no 자동 계산 및 reorder 지원

검증:
- 라우트 테스트: 13개 엔드포인트 정상 등록
- Pint 검사: 15 files PASS

SAM API Development Rules 준수
2025-11-20 16:55:57 +09:00

124 lines
3.2 KiB
PHP

<?php
namespace App\Services\ItemMaster;
use App\Models\ItemMaster\ItemPage;
use App\Services\Service;
use Illuminate\Support\Collection;
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
class ItemPageService extends Service
{
/**
* 페이지 목록 조회 (섹션/필드 중첩)
*/
public function index(?string $itemType = null): Collection
{
$tenantId = $this->tenantId();
$query = ItemPage::with([
'sections' => function ($query) {
$query->orderBy('order_no');
},
'sections.fields' => function ($query) {
$query->orderBy('order_no');
},
'sections.bomItems',
])
->where('tenant_id', $tenantId)
->where('is_active', 1);
if ($itemType) {
$query->where('item_type', strtoupper($itemType));
}
return $query->get();
}
/**
* 페이지 생성
*/
public function store(array $data): ItemPage
{
$tenantId = $this->tenantId();
$userId = $this->apiUserId();
$page = ItemPage::create([
'tenant_id' => $tenantId,
'page_name' => $data['page_name'],
'item_type' => $data['item_type'],
'absolute_path' => $data['absolute_path'] ?? null,
'is_active' => true,
'created_by' => $userId,
]);
// 관계 로드
$page->load(['sections']);
return $page;
}
/**
* 페이지 수정
*/
public function update(int $id, array $data): ItemPage
{
$tenantId = $this->tenantId();
$userId = $this->apiUserId();
$page = ItemPage::where('tenant_id', $tenantId)
->where('id', $id)
->first();
if (! $page) {
throw new NotFoundHttpException(__('error.not_found'));
}
$page->update([
'page_name' => $data['page_name'] ?? $page->page_name,
'absolute_path' => $data['absolute_path'] ?? $page->absolute_path,
'updated_by' => $userId,
]);
$page->load(['sections.fields', 'sections.bomItems']);
return $page;
}
/**
* 페이지 삭제 (Soft Delete)
*/
public function destroy(int $id): void
{
$tenantId = $this->tenantId();
$userId = $this->apiUserId();
$page = ItemPage::where('tenant_id', $tenantId)
->where('id', $id)
->first();
if (! $page) {
throw new NotFoundHttpException(__('error.not_found'));
}
$page->update(['deleted_by' => $userId]);
$page->delete();
// Cascade: 하위 섹션/필드도 Soft Delete
foreach ($page->sections as $section) {
$section->update(['deleted_by' => $userId]);
$section->delete();
foreach ($section->fields as $field) {
$field->update(['deleted_by' => $userId]);
$field->delete();
}
foreach ($section->bomItems as $bomItem) {
$bomItem->update(['deleted_by' => $userId]);
$bomItem->delete();
}
}
}
}