SamProject/sam-api
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

refactor: products/materials 테이블 및 관련 코드 삭제

Browse Source 
- products, materials, product_components 테이블 삭제 마이그레이션
- FK 제약조건 정리 (orders, order_items, material_receipts, lots)
- 관련 Models 삭제: Product, Material, ProductComponent 등
- 관련 Controllers 삭제: ProductController, MaterialController, ProductBomItemController
- 관련 Services 삭제: ProductService, MaterialService, ProductBomService
- 관련 Requests, Swagger 파일 삭제
- 라우트 정리: /products, /materials 엔드포인트 제거

모든 품목 관리는 /items 엔드포인트로 통합됨
item_id_mappings 테이블에 ID 매핑 보존

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
권혁성
2025-12-14 00:20:09 +09:00
parent a486595d07
commit 039fd623df
23 changed files with 158 additions and 4111 deletions
Download Patch File Download Diff File Expand all files Collapse all files

519
app/Services/MaterialService.php
View File

@@ -1,519 +0,0 @@
<?php
namespace App\Services;
use App\Constants\SystemFields;
use App\Models\ItemMaster\ItemField;
use App\Models\Materials\Material;
use Illuminate\Support\Facades\Validator;
class MaterialService extends Service
{
/**
* materials 테이블의 고정 컬럼 목록 조회 (SystemFields + ItemField 기반)
*/
private function getKnownFields(): array
{
$tenantId = $this->tenantId();
// 1. SystemFields에서 materials 테이블 고정 컬럼
$systemFields = SystemFields::getReservedKeys(SystemFields::SOURCE_TABLE_MATERIALS);
// 2. ItemField에서 storage_type='column'인 필드의 field_key 조회
$columnFields = ItemField::where('tenant_id', $tenantId)
->where('source_table', 'materials')
->where('storage_type', 'column')
->whereNotNull('field_key')
->pluck('field_key')
->toArray();
// 3. 추가적인 API 전용 필드 (DB 컬럼이 아니지만 API에서 사용하는 필드)
$apiFields = ['item_type', 'type_code', 'bom'];
return array_unique(array_merge($systemFields, $columnFields, $apiFields));
}
/**
* 정의된 필드 외의 동적 필드를 options로 추출
*/
private function extractDynamicOptions(array $params): array
{
$knownFields = $this->getKnownFields();
$dynamicOptions = [];
foreach ($params as $key => $value) {
if (! in_array($key, $knownFields) && $value !== null && $value !== '') {
$dynamicOptions[$key] = $value;
}
}
return $dynamicOptions;
}
/**
* 기존 options 배열과 동적 필드를 병합
* - 기존 options가 [{label, value}] 배열이면 동적 필드를 배열 항목으로 추가
* - 기존 options가 {key: value} 맵이면 동적 필드를 맵에 병합
*/
private function mergeOptionsWithDynamic($existingOptions, array $dynamicOptions): array
{
if (! is_array($existingOptions) || empty($existingOptions)) {
// 기존 options가 없으면 동적 필드만 반환
return $dynamicOptions;
}
// 기존 options가 연관 배열(맵)인지 판별
$isAssoc = array_keys($existingOptions) !== range(0, count($existingOptions) - 1);
if ($isAssoc) {
// 맵 형태면 단순 병합
return array_merge($existingOptions, $dynamicOptions);
}
// 배열 형태 [{label, value}]면 동적 필드를 배열 항목으로 추가
foreach ($dynamicOptions as $key => $value) {
$existingOptions[] = ['label' => $key, 'value' => $value];
}
return $existingOptions;
}
/** 공통 검증 헬퍼 */
protected function v(array $input, array $rules)
{
$v = Validator::make($input, $rules);
if ($v->fails()) {
return ['error' => $v->errors()->first(), 'code' => 422];
}
return $v->validated();
}
/** 목록 */
public function getMaterials(array $params)
{
$tenantId = $this->tenantId();
$p = $this->v($params, [
'q' => 'nullable|string|max:100',
'category' => 'nullable|integer|min:1',
'page' => 'nullable|integer|min:1',
'per_page' => 'nullable|integer|min:1|max:200',
]);
if (isset($p['error'])) {
return $p;
}
$q = Material::query()
->where('tenant_id', $tenantId); // SoftDeletes가 있으면 기본적으로 deleted_at IS NULL
if (! empty($p['category'])) {
$q->where('category_id', (int) $p['category']);
}
if (! empty($p['q'])) {
$kw = '%'.$p['q'].'%';
$q->where(function ($w) use ($kw) {
$w->where('item_name', 'like', $kw)
->orWhere('name', 'like', $kw)
->orWhere('material_code', 'like', $kw)
->orWhere('search_tag', 'like', $kw);
});
}
$q->orderBy('id');
$perPage = $p['per_page'] ?? 20;
$page = $p['page'] ?? null;
return $q->paginate($perPage, ['*'], 'page', $page);
}
/** 단건 조회 */
public function getMaterial(int $id)
{
$tenantId = $this->tenantId();
/** @var Material|null $row */
$row = Material::query()
->where('tenant_id', $tenantId)
->find($id);
if (! $row) {
return ['error' => '자재를 찾을 수 없습니다.', 'code' => 404];
}
// 모델에서 casts가 없을 수 있으니 안전하게 배열화
$row->attributes = is_array($row->attributes) ? $row->attributes : ($row->attributes ? json_decode($row->attributes, true) : null);
$row->options = is_array($row->options) ? $row->options : ($row->options ? json_decode($row->options, true) : null);
return $row;
}
/** 등록 */
public function setMaterial(array $params)
{
$tenantId = $this->tenantId();
$userId = $this->apiUserId();
// 동적 필드를 options에 병합
$dynamicOptions = $this->extractDynamicOptions($params);
if (! empty($dynamicOptions)) {
$existingOptions = $params['options'] ?? [];
$params['options'] = $this->mergeOptionsWithDynamic($existingOptions, $dynamicOptions);
}
$p = $this->v($params, [
'category_id' => 'nullable|integer|min:1',
'name' => 'required|string|max:100',
'unit' => 'required|string|max:10',
'is_inspection' => 'nullable|in:Y,N',
'search_tag' => 'nullable|string',
'remarks' => 'nullable|string',
'attributes' => 'nullable|array', // [{label,value,unit}] 또는 map
'options' => 'nullable|array', // [{label,value,unit}] 또는 map
'material_code' => 'nullable|string|max:50',
'specification' => 'nullable|string|max:100',
]);
if (isset($p['error'])) {
return $p;
}
// material_code 중복 체크 (삭제된 레코드 포함 - DB unique 제약은 deleted_at 무시)
if (! empty($p['material_code'])) {
$duplicate = Material::withTrashed()
->where('tenant_id', $tenantId)
->where('material_code', $p['material_code'])
->first(['id', 'name', 'deleted_at']);
if ($duplicate) {
if ($duplicate->deleted_at) {
return [
'error' => "자재코드 '{$p['material_code']}'가 삭제된 자재에서 사용 중입니다. 해당 자재를 복구하거나 완전 삭제 후 다시 시도하세요.",
'code' => 422,
'deleted_material_id' => $duplicate->id,
];
}
return ['error' => "자재코드 '{$p['material_code']}'가 이미 존재합니다.", 'code' => 422];
}
}
// 기존 normalizeAttributes 사용(그대로), options는 새 normalizeOptions 사용
$attributes = $this->normalizeAttributes($p['attributes'] ?? null);
$options = $this->normalizeOptions($p['options'] ?? null);
$itemName = $this->buildItemName($p['name'], $attributes);
$specText = $p['specification'] ?? $this->buildSpecText($attributes);
$m = new Material;
$m->tenant_id = $tenantId;
$m->category_id = $p['category_id'] ?? null;
$m->name = $p['name'];
$m->item_name = $itemName;
$m->specification = $specText;
$m->material_code = $p['material_code'] ?? null;
$m->unit = $p['unit'];
$m->is_inspection = $p['is_inspection'] ?? 'N';
$m->search_tag = $p['search_tag'] ?? null;
$m->remarks = $p['remarks'] ?? null;
$m->attributes = $attributes ?? null;
$m->options = $options ?? null;
$m->created_by = $userId ?? 0;
$m->updated_by = $userId ?? null;
$m->save();
return $this->getMaterial($m->id);
}
/** 수정 */
public function updateMaterial(int $id, array $params = [])
{
$tenantId = $this->tenantId();
$userId = $this->apiUserId();
/** @var Material|null $exists */
$exists = Material::query()->where('tenant_id', $tenantId)->find($id);
if (! $exists) {
return ['error' => '자재를 찾을 수 없습니다.', 'code' => 404];
}
// 동적 필드를 options에 병합
$dynamicOptions = $this->extractDynamicOptions($params);
if (! empty($dynamicOptions)) {
$existingOptions = $params['options'] ?? [];
$params['options'] = $this->mergeOptionsWithDynamic($existingOptions, $dynamicOptions);
}
$p = $this->v($params, [
'category_id' => 'nullable|integer|min:1',
'name' => 'nullable|string|max:100',
'unit' => 'nullable|string|max:10',
'is_inspection' => 'nullable|in:Y,N',
'search_tag' => 'nullable|string',
'remarks' => 'nullable|string',
'attributes' => 'nullable|array', // [{label,value,unit}] 또는 map
'options' => 'nullable|array', // [{label,value,unit}] 또는 map
'material_code' => 'nullable|string|max:50',
'specification' => 'nullable|string|max:100',
]);
if (isset($p['error'])) {
return $p;
}
// material_code 중복 체크 (삭제된 레코드 포함 - DB unique 제약은 deleted_at 무시)
$finalMaterialCode = $p['material_code'] ?? $exists->material_code;
if (! empty($finalMaterialCode)) {
$duplicate = Material::withTrashed()
->where('tenant_id', $tenantId)
->where('material_code', $finalMaterialCode)
->where('id', '!=', $id)
->first(['id', 'name', 'deleted_at']);
if ($duplicate) {
if ($duplicate->deleted_at) {
return [
'error' => "자재코드 '{$finalMaterialCode}'가 삭제된 자재에서 사용 중입니다. 해당 자재를 복구하거나 완전 삭제 후 다시 시도하세요.",
'code' => 422,
'deleted_material_id' => $duplicate->id,
];
}
return ['error' => "자재코드 '{$finalMaterialCode}'가 이미 존재합니다.", 'code' => 422];
}
}
$currentAttrs = is_array($exists->attributes) ? $exists->attributes
: ($exists->attributes ? json_decode($exists->attributes, true) : null);
$currentOpts = is_array($exists->options) ? $exists->options
: ($exists->options ? json_decode($exists->options, true) : null);
// 변경 점만 정규화
$attrs = array_key_exists('attributes', $p)
? $this->normalizeAttributes($p['attributes'])
: $currentAttrs;
$opts = array_key_exists('options', $p)
? $this->normalizeOptions($p['options'])
: $currentOpts;
$baseName = array_key_exists('name', $p) ? ($p['name'] ?? $exists->name) : $exists->name;
$exists->category_id = $p['category_id'] ?? $exists->category_id;
$exists->name = $baseName;
$exists->item_name = $this->buildItemName($baseName, $attrs);
$exists->specification = array_key_exists('specification', $p)
? ($p['specification'] ?? null)
: ($exists->specification ?: $this->buildSpecText($attrs));
$exists->material_code = $p['material_code'] ?? $exists->material_code;
$exists->unit = $p['unit'] ?? $exists->unit;
$exists->is_inspection = $p['is_inspection'] ?? $exists->is_inspection;
$exists->search_tag = $p['search_tag'] ?? $exists->search_tag;
$exists->remarks = $p['remarks'] ?? $exists->remarks;
if (array_key_exists('attributes', $p)) {
$exists->attributes = $attrs;
}
if (array_key_exists('options', $p)) {
$exists->options = $opts;
}
$exists->updated_by = $userId ?? $exists->updated_by;
$exists->save();
return $this->getMaterial($exists->id);
}
/** 삭제(소프트) */
public function destroyMaterial(int $id)
{
$tenantId = $this->tenantId();
/** @var Material|null $row */
$row = Material::query()
->where('tenant_id', $tenantId)
->find($id);
if (! $row) {
return ['error' => '자재를 찾을 수 없습니다.', 'code' => 404];
}
// 사용 중인 자재 삭제 방지
$usageCheck = $this->checkMaterialUsage($id, $tenantId);
if ($usageCheck['in_use']) {
return [
'error' => '사용 중인 자재는 삭제할 수 없습니다.',
'code' => 422,
'usage' => $usageCheck['details'],
];
}
$row->delete();
return ['id' => $id, 'deleted_at' => now()->toDateTimeString()];
}
/**
* 자재 사용 여부 체크
* - material_receipts: 입고 내역
* - lots: 로트 관리
* - product_components: BOM 구성품 (ref_type='MATERIAL')
*/
private function checkMaterialUsage(int $materialId, int $tenantId): array
{
$details = [];
// 1. 입고 내역 체크
$receiptCount = \App\Models\Materials\MaterialReceipt::where('tenant_id', $tenantId)
->where('material_id', $materialId)
->count();
if ($receiptCount > 0) {
$details['receipts'] = $receiptCount;
}
// 2. 로트 체크
$lotCount = \App\Models\Qualitys\Lot::where('tenant_id', $tenantId)
->where('material_id', $materialId)
->count();
if ($lotCount > 0) {
$details['lots'] = $lotCount;
}
// 3. BOM 구성품 체크 (ref_type='MATERIAL', ref_id=material_id)
$bomCount = \App\Models\Products\ProductComponent::where('tenant_id', $tenantId)
->where('ref_type', 'MATERIAL')
->where('ref_id', $materialId)
->count();
if ($bomCount > 0) {
$details['bom_components'] = $bomCount;
}
return [
'in_use' => ! empty($details),
'details' => $details,
];
}
/* -------------------------
헬퍼: 규격/품목명 빌더
attributes 예시:
[
{"label":"두께","value":"10","unit":"T"},
{"label":"길이","value":"150","unit":"CM"}
]
→ item_name: "철판 10T 150CM"
→ specification: "두께 10T, 길이 150CM"
------------------------- */
private function normalizeAttributes(?array $attrs): ?array
{
if (! $attrs) {
return null;
}
$out = [];
foreach ($attrs as $a) {
if (! is_array($a)) {
continue;
}
$label = trim((string) ($a['label'] ?? ''));
$value = trim((string) ($a['value'] ?? ''));
$unit = trim((string) ($a['unit'] ?? ''));
if ($label === '' && $value === '' && $unit === '') {
continue;
}
$out[] = ['label' => $label, 'value' => $value, 'unit' => $unit];
}
return $out ?: null;
}
private function buildItemName(string $name, ?array $attrs): string
{
if (! $attrs || count($attrs) === 0) {
return $name;
}
$parts = [];
foreach ($attrs as $a) {
$value = (string) ($a['value'] ?? '');
$unit = (string) ($a['unit'] ?? '');
$chunk = trim($value.$unit);
if ($chunk !== '') {
$parts[] = $chunk;
}
}
return trim($name.' '.implode(' ', $parts));
}
private function buildSpecText(?array $attrs): ?string
{
if (! $attrs || count($attrs) === 0) {
return null;
}
$parts = [];
foreach ($attrs as $a) {
$label = (string) ($a['label'] ?? '');
$value = (string) ($a['value'] ?? '');
$unit = (string) ($a['unit'] ?? '');
$valueWithUnit = trim($value.$unit);
if ($label !== '' && $valueWithUnit !== '') {
$parts[] = "{$label} {$valueWithUnit}";
} elseif ($valueWithUnit !== '') {
$parts[] = $valueWithUnit;
}
}
return $parts ? implode(', ', $parts) : null;
}
/**
* options 입력을 [{label, value, unit}] 형태로 정규화.
* - 맵 형태 {"key": "value"}도 배열로 변환
* - 항상 [{label, value, unit}] 형태로 저장
*/
private function normalizeOptions(?array $in): ?array
{
if (! $in) {
return null;
}
// 연관 맵 형태인지 간단 판별
$isAssoc = array_keys($in) !== range(0, count($in) - 1);
if ($isAssoc) {
// 맵 형태를 [{label, value, unit}] 배열로 변환
$out = [];
foreach ($in as $k => $v) {
$label = trim((string) $k);
$value = is_scalar($v) ? trim((string) $v) : json_encode($v, JSON_UNESCAPED_UNICODE);
if ($label !== '' || $value !== '') {
$out[] = ['label' => $label, 'value' => $value, 'unit' => ''];
}
}
return $out ?: null;
}
// 리스트(triple) 정규화
$out = [];
foreach ($in as $a) {
if (! is_array($a)) {
continue;
}
$label = trim((string) ($a['label'] ?? ''));
$value = trim((string) ($a['value'] ?? ''));
$unit = trim((string) ($a['unit'] ?? ''));
if ($label === '' && $value === '') {
continue;
}
$out[] = ['label' => $label, 'value' => $value, 'unit' => $unit];
}
return $out ?: null;
}
}