Files
sam-api/app/Services/ProductBomService.php
hskwon 7967082f8b refactor: BOM API ref_id 통합 및 응답 개선
- child_product_id, material_id를 ref_id 단일 컬럼으로 통합
- splitRef() 메서드 제거
- bulkUpsert() 응답에 created_ids, updated_ids 추가
2025-12-04 13:45:41 +09:00

538 lines
19 KiB
PHP

<?php
namespace App\Services;
use App\Models\Materials\Material;
use App\Models\Products\Product;
use App\Models\Products\ProductComponent;
use App\Services\Products\ProductComponentResolver;
use Illuminate\Support\Arr;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Validator;
use Illuminate\Validation\ValidationException;
use Symfony\Component\HttpKernel\Exception\BadRequestHttpException;
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
class ProductBomService extends Service
{
/**
* 목록: 제품/자재를 통합 반환
* - 반환 형태 예:
* [
* { "id": 10, "ref_type": "PRODUCT", "ref_id": 3, "code": "P-003", "name": "모듈A", "quantity": "2.0000", "sort_order": 1, "is_default": 1 },
* { "id": 11, "ref_type": "MATERIAL", "ref_id": 5, "code": "M-005", "name": "알루미늄판", "unit":"EA", "quantity": "4.0000", "sort_order": 2 }
* ]
*/
public function index(int $parentProductId, array $params)
{
$tenantId = $this->tenantId();
// 부모 제품 유효성
$this->assertProduct($tenantId, $parentProductId);
$items = ProductComponent::query()
->where('tenant_id', $tenantId)
->where('parent_product_id', $parentProductId)
->orderBy('sort_order')
->get();
// 리졸브(제품/자재) - ref_id 기준
$productIds = $items->where('ref_type', 'PRODUCT')->pluck('ref_id')->filter()->unique()->values();
$materialIds = $items->where('ref_type', 'MATERIAL')->pluck('ref_id')->filter()->unique()->values();
$products = $productIds->isNotEmpty()
? Product::query()->where('tenant_id', $tenantId)->whereIn('id', $productIds)->get(['id', 'code', 'name', 'product_type', 'category_id'])->keyBy('id')
: collect();
$materials = $materialIds->isNotEmpty()
? Material::query()->where('tenant_id', $tenantId)->whereIn('id', $materialIds)->get(['id', 'material_code as code', 'name', 'unit', 'category_id'])->keyBy('id')
: collect();
return $items->map(function ($row) use ($products, $materials) {
$base = [
'id' => (int) $row->id,
'ref_type' => $row->ref_type,
'ref_id' => (int) $row->ref_id,
'quantity' => $row->quantity,
'sort_order' => (int) $row->sort_order,
'is_default' => (int) $row->is_default,
];
if ($row->ref_type === 'PRODUCT') {
$p = $products->get($row->ref_id);
return $base + [
'code' => $p?->code,
'name' => $p?->name,
'product_type' => $p?->product_type,
'category_id' => $p?->category_id,
];
} else { // MATERIAL
$m = $materials->get($row->ref_id);
return $base + [
'code' => $m?->code,
'name' => $m?->name,
'unit' => $m?->unit,
'category_id' => $m?->category_id,
];
}
})->values();
}
/**
* 일괄 업서트
* items[]: { id?, ref_type: PRODUCT|MATERIAL, ref_id: int, quantity: number, sort_order?: int, is_default?: 0|1 }
*/
public function bulkUpsert(int $parentProductId, array $items): array
{
$tenantId = $this->tenantId();
$userId = $this->apiUserId();
$this->assertProduct($tenantId, $parentProductId);
if (! is_array($items) || empty($items)) {
throw new BadRequestHttpException(__('error.empty_items'));
}
$created = 0;
$updated = 0;
$createdIds = [];
$updatedIds = [];
DB::transaction(function () use ($tenantId, $userId, $parentProductId, $items, &$created, &$updated, &$createdIds, &$updatedIds) {
foreach ($items as $it) {
$payload = $this->validateItem($it);
// ref 확인 & 자기참조 방지
$this->assertReference($tenantId, $parentProductId, $payload['ref_type'], (int) $payload['ref_id']);
if (! empty($it['id'])) {
$pc = ProductComponent::query()
->where('tenant_id', $tenantId)
->where('parent_product_id', $parentProductId)
->find((int) $it['id']);
if (! $pc) {
throw new BadRequestHttpException(__('error.not_found'));
}
$pc->update([
'ref_type' => $payload['ref_type'],
'ref_id' => (int) $payload['ref_id'],
'quantity' => $payload['quantity'],
'sort_order' => $payload['sort_order'] ?? $pc->sort_order,
'is_default' => $payload['is_default'] ?? $pc->is_default,
'updated_by' => $userId,
]);
$updated++;
$updatedIds[] = $pc->id;
} else {
// 신규
$pc = ProductComponent::create([
'tenant_id' => $tenantId,
'parent_product_id' => $parentProductId,
'ref_type' => $payload['ref_type'],
'ref_id' => (int) $payload['ref_id'],
'quantity' => $payload['quantity'],
'sort_order' => $payload['sort_order'] ?? 0,
'is_default' => $payload['is_default'] ?? 0,
'created_by' => $userId,
]);
$created++;
$createdIds[] = $pc->id;
}
}
});
return [
'created' => $created,
'updated' => $updated,
'created_ids' => $createdIds,
'updated_ids' => $updatedIds,
];
}
// 단건 수정
public function update(int $parentProductId, int $itemId, array $data)
{
$tenantId = $this->tenantId();
$userId = $this->apiUserId();
$this->assertProduct($tenantId, $parentProductId);
$pc = ProductComponent::query()
->where('tenant_id', $tenantId)
->where('parent_product_id', $parentProductId)
->find($itemId);
if (! $pc) {
throw new BadRequestHttpException(__('error.not_found'));
}
$v = Validator::make($data, [
'ref_type' => 'sometimes|in:PRODUCT,MATERIAL',
'ref_id' => 'sometimes|integer',
'quantity' => 'sometimes|numeric|min:0.0001',
'sort_order' => 'sometimes|integer|min:0',
'is_default' => 'sometimes|in:0,1',
]);
$payload = $v->validate();
if (isset($payload['ref_type']) || isset($payload['ref_id'])) {
$refType = $payload['ref_type'] ?? $pc->ref_type;
$refId = isset($payload['ref_id'])
? (int) $payload['ref_id']
: (int) $pc->ref_id;
$this->assertReference($tenantId, $parentProductId, $refType, $refId);
$pc->ref_type = $refType;
$pc->ref_id = $refId;
}
if (isset($payload['quantity'])) {
$pc->quantity = $payload['quantity'];
}
if (isset($payload['sort_order'])) {
$pc->sort_order = $payload['sort_order'];
}
if (isset($payload['is_default'])) {
$pc->is_default = $payload['is_default'];
}
$pc->updated_by = $userId;
$pc->save();
return $pc->refresh();
}
// 삭제
public function destroy(int $parentProductId, int $itemId): void
{
$tenantId = $this->tenantId();
$this->assertProduct($tenantId, $parentProductId);
$pc = ProductComponent::query()
->where('tenant_id', $tenantId)
->where('parent_product_id', $parentProductId)
->find($itemId);
if (! $pc) {
throw new BadRequestHttpException(__('error.not_found'));
}
$pc->delete();
}
// 정렬 변경
public function reorder(int $parentProductId, array $items): void
{
$tenantId = $this->tenantId();
$this->assertProduct($tenantId, $parentProductId);
if (! is_array($items)) {
throw new BadRequestHttpException(__('error.invalid_payload'));
}
DB::transaction(function () use ($tenantId, $parentProductId, $items) {
foreach ($items as $row) {
if (! isset($row['id'], $row['sort_order'])) {
continue;
}
ProductComponent::query()
->where('tenant_id', $tenantId)
->where('parent_product_id', $parentProductId)
->where('id', (int) $row['id'])
->update(['sort_order' => (int) $row['sort_order']]);
}
});
}
// 요약(간단 합계/건수)
public function summary(int $parentProductId): array
{
$tenantId = $this->tenantId();
$this->assertProduct($tenantId, $parentProductId);
$items = ProductComponent::query()
->where('tenant_id', $tenantId)
->where('parent_product_id', $parentProductId)
->get();
$cnt = $items->count();
$cntP = $items->where('ref_type', 'PRODUCT')->count();
$cntM = $items->where('ref_type', 'MATERIAL')->count();
$qtySum = (string) $items->sum('quantity');
return [
'count' => $cnt,
'count_product' => $cntP,
'count_material' => $cntM,
'quantity_sum' => $qtySum,
];
}
// 유효성 검사(중복/자기참조/음수 등)
public function validateBom(int $parentProductId): array
{
$tenantId = $this->tenantId();
$this->assertProduct($tenantId, $parentProductId);
$items = ProductComponent::query()
->where('tenant_id', $tenantId)
->where('parent_product_id', $parentProductId)
->orderBy('sort_order')
->get();
$errors = [];
$seen = [];
foreach ($items as $row) {
if ($row->quantity <= 0) {
$errors[] = ['id' => $row->id, 'error' => 'INVALID_QUANTITY'];
}
$key = $row->ref_type.':'.$row->ref_id;
if (isset($seen[$key])) {
$errors[] = ['id' => $row->id, 'error' => 'DUPLICATE_ITEM'];
} else {
$seen[$key] = true;
}
// 자기참조
if ($row->ref_type === 'PRODUCT' && (int) $row->ref_id === (int) $parentProductId) {
$errors[] = ['id' => $row->id, 'error' => 'SELF_REFERENCE'];
}
}
return [
'valid' => count($errors) === 0,
'errors' => $errors,
];
}
// ---------- helpers ----------
private function validateItem(array $it): array
{
$v = Validator::make($it, [
'id' => 'nullable|integer',
'ref_type' => 'required|in:PRODUCT,MATERIAL',
'ref_id' => 'required|integer',
'quantity' => 'required|numeric|min:0.0001',
'sort_order' => 'nullable|integer|min:0',
'is_default' => 'nullable|in:0,1',
]);
return $v->validate();
}
private function assertProduct(int $tenantId, int $productId): void
{
$exists = Product::query()->where('tenant_id', $tenantId)->where('id', $productId)->exists();
if (! $exists) {
// ko: 제품 정보를 찾을 수 없습니다.
throw new NotFoundHttpException(__('error.not_found_resource', ['resource' => '제품']));
}
}
private function assertReference(int $tenantId, int $parentProductId, string $refType, int $refId): void
{
if ($refType === 'PRODUCT') {
if ($refId === $parentProductId) {
throw new BadRequestHttpException(__('error.invalid_payload')); // 자기참조 방지
}
$ok = Product::query()->where('tenant_id', $tenantId)->where('id', $refId)->exists();
if (! $ok) {
throw new BadRequestHttpException(__('error.not_found'));
}
} else {
$ok = Material::query()->where('tenant_id', $tenantId)->where('id', $refId)->exists();
if (! $ok) {
throw new BadRequestHttpException(__('error.not_found'));
}
}
}
/**
* 특정 제품의 BOM을 전체 교체(기존 삭제 → 새 데이터 일괄 삽입)
* - $productId: products.id
* - $payload: ['categories' => [ {id?, name?, items: [{ref_type, ref_id, quantity, sort_order?}, ...]}, ... ]]
* 반환: ['deleted_count' => int, 'inserted_count' => int]
*/
public function replaceBom(int $productId, array $payload): array
{
if ($productId <= 0) {
throw new BadRequestHttpException(__('error.bad_request')); // 400
}
$tenantId = $this->tenantId();
$userId = $this->apiUserId();
// 0) ====== 빈 카테고리 제거 ======
$rawCats = Arr::get($payload, 'categories', []);
$normalized = [];
foreach ((array) $rawCats as $cat) {
$catId = Arr::get($cat, 'id');
$catName = Arr::get($cat, 'name');
$items = array_values(array_filter((array) Arr::get($cat, 'items', []), function ($it) {
$type = Arr::get($it, 'ref_type');
$id = (int) Arr::get($it, 'ref_id');
$qty = Arr::get($it, 'quantity');
return in_array($type, ['MATERIAL', 'PRODUCT'], true)
&& $id > 0
&& is_numeric($qty);
}));
if (count($items) === 0) {
continue; // 아이템 없으면 skip
}
$normalized[] = [
'id' => $catId,
'name' => $catName,
'items' => $items,
];
}
// 🔕 전부 비었으면: 기존 BOM 전체 삭제 후 성공
if (count($normalized) === 0) {
$deleted = ProductComponent::where('tenant_id', $tenantId)
->where('parent_product_id', $productId)
->delete();
return [
'deleted_count' => $deleted,
'inserted_count' => 0,
'message' => '모든 BOM 항목이 비어 기존 데이터를 삭제했습니다.',
];
}
// 1) ====== 검증 ======
$v = Validator::make(
['categories' => $normalized],
[
'categories' => ['required', 'array', 'min:1'],
'categories.*.id' => ['nullable', 'integer'],
'categories.*.name' => ['nullable', 'string', 'max:100'],
'categories.*.items' => ['required', 'array', 'min:1'],
'categories.*.items.*.ref_type' => ['required', 'in:MATERIAL,PRODUCT'],
'categories.*.items.*.ref_id' => ['required', 'integer', 'min:1'],
'categories.*.items.*.quantity' => ['required', 'numeric', 'min:0'],
'categories.*.items.*.sort_order' => ['nullable', 'integer', 'min:0'],
]
);
if ($v->fails()) {
throw new ValidationException($v, null, __('error.validation_failed'));
}
// 2) ====== 플랫 레코드 생성 (note 제거) ======
$rows = [];
$now = now();
foreach ($normalized as $cat) {
$catId = Arr::get($cat, 'id');
$catName = Arr::get($cat, 'name');
foreach ($cat['items'] as $idx => $item) {
$rows[] = [
'tenant_id' => $tenantId,
'parent_product_id' => $productId,
'category_id' => $catId,
'category_name' => $catName,
'ref_type' => $item['ref_type'],
'ref_id' => (int) $item['ref_id'],
'quantity' => (string) $item['quantity'],
'sort_order' => isset($item['sort_order']) ? (int) $item['sort_order'] : $idx,
'created_by' => $userId,
'updated_by' => $userId,
'created_at' => $now,
'updated_at' => $now,
];
}
}
// 3) ====== 트랜잭션: 기존 삭제 후 신규 삽입 ======
return DB::transaction(function () use ($tenantId, $productId, $rows) {
$deleted = ProductComponent::where('tenant_id', $tenantId)
->where('parent_product_id', $productId)
->delete();
$inserted = 0;
foreach (array_chunk($rows, 500) as $chunk) {
$ok = ProductComponent::insert($chunk);
$inserted += $ok ? count($chunk) : 0;
}
return [
'deleted_count' => $deleted,
'inserted_count' => $inserted,
'message' => 'BOM 저장 성공',
];
});
}
/** 제품별: 현재 BOM에 쓰인 카테고리 */
public function listCategoriesForProduct(int $productId): array
{
if ($productId <= 0) {
throw new BadRequestHttpException(__('error.bad_request'));
}
$tenantId = $this->tenantId();
$rows = ProductComponent::query()
->where('tenant_id', $tenantId)
->where('parent_product_id', $productId)
->whereNotNull('category_name')
->select([
DB::raw('category_id'),
DB::raw('category_name'),
DB::raw('COUNT(*) as count'),
])
->groupBy('category_id', 'category_name')
->orderByDesc('count')
->orderBy('category_name')
->get()
->toArray();
return $rows;
}
/** 테넌트 전역: 자주 쓰인 카테고리 추천(+검색) */
public function listCategoriesForTenant(?string $q, int $limit = 20): array
{
$tenantId = $this->tenantId();
$query = ProductComponent::query()
->where('tenant_id', $tenantId)
->whereNotNull('category_name')
->select([
DB::raw('category_id'),
DB::raw('category_name'),
DB::raw('COUNT(*) as count'),
])
->groupBy('category_id', 'category_name');
if ($q) {
$query->havingRaw('category_name LIKE ?', ["%{$q}%"]);
}
$rows = $query
->orderByDesc('count')
->orderBy('category_name')
->limit($limit > 0 ? $limit : 20)
->get()
->toArray();
return $rows;
}
public function tree($request, int $productId): array
{
$depth = (int) $request->query('depth', config('products.default_tree_depth', 10));
$resolver = app(ProductComponentResolver::class);
// 트리 배열만 반환 (ApiResponse가 바깥에서 래핑)
return $resolver->resolveTree($productId, $depth);
}
}