feat: [equipment] 설비관리 API 백엔드 구현 (Phase 1)
- 모델 6개: Equipment, EquipmentInspection, EquipmentInspectionDetail, EquipmentInspectionTemplate, EquipmentRepair, EquipmentProcess
- InspectionCycle Enum: 6주기(일/주/월/격월/분기/반기) 날짜 해석
- 서비스 4개: EquipmentService, EquipmentInspectionService, EquipmentRepairService, EquipmentPhotoService
- 컨트롤러 4개: CRUD + 점검 토글/결과 설정/메모/초기화 + 템플릿 관리 + 수리이력 + 사진
- FormRequest 6개: 설비등록/수정, 수리이력, 점검템플릿, 토글, 메모
- 라우트 26개: equipment prefix 하위 RESTful 엔드포인트
- i18n 메시지: message.equipment.*, error.equipment.*
- 마이그레이션: equipments/equipment_repairs options JSON 컬럼 추가
2026-03-12 10:52:30 +09:00
|
|
|
<?php
|
|
|
|
|
|
|
|
|
|
namespace App\Services\Equipment;
|
|
|
|
|
|
|
|
|
|
use App\Models\Equipment\Equipment;
|
2026-03-12 18:47:39 +09:00
|
|
|
use App\Models\Equipment\EquipmentInspection;
|
feat: [equipment] 설비관리 API 백엔드 구현 (Phase 1)
- 모델 6개: Equipment, EquipmentInspection, EquipmentInspectionDetail, EquipmentInspectionTemplate, EquipmentRepair, EquipmentProcess
- InspectionCycle Enum: 6주기(일/주/월/격월/분기/반기) 날짜 해석
- 서비스 4개: EquipmentService, EquipmentInspectionService, EquipmentRepairService, EquipmentPhotoService
- 컨트롤러 4개: CRUD + 점검 토글/결과 설정/메모/초기화 + 템플릿 관리 + 수리이력 + 사진
- FormRequest 6개: 설비등록/수정, 수리이력, 점검템플릿, 토글, 메모
- 라우트 26개: equipment prefix 하위 RESTful 엔드포인트
- i18n 메시지: message.equipment.*, error.equipment.*
- 마이그레이션: equipments/equipment_repairs options JSON 컬럼 추가
2026-03-12 10:52:30 +09:00
|
|
|
use App\Services\Service;
|
|
|
|
|
use Illuminate\Contracts\Pagination\LengthAwarePaginator;
|
|
|
|
|
use Illuminate\Support\Facades\DB;
|
|
|
|
|
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
|
|
|
|
|
|
|
|
|
|
class EquipmentService extends Service
|
|
|
|
|
{
|
|
|
|
|
public function index(array $filters = []): LengthAwarePaginator
|
|
|
|
|
{
|
|
|
|
|
$query = Equipment::query()->with(['manager', 'subManager']);
|
|
|
|
|
|
|
|
|
|
if (! empty($filters['search'])) {
|
|
|
|
|
$search = $filters['search'];
|
|
|
|
|
$query->where(function ($q) use ($search) {
|
|
|
|
|
$q->where('equipment_code', 'like', "%{$search}%")
|
|
|
|
|
->orWhere('name', 'like', "%{$search}%");
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
if (! empty($filters['status'])) {
|
|
|
|
|
$query->byStatus($filters['status']);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
if (! empty($filters['production_line'])) {
|
|
|
|
|
$query->byLine($filters['production_line']);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
if (! empty($filters['equipment_type'])) {
|
|
|
|
|
$query->byType($filters['equipment_type']);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
$sortBy = $filters['sort_by'] ?? 'sort_order';
|
|
|
|
|
$sortDir = $filters['sort_direction'] ?? 'asc';
|
|
|
|
|
$query->orderBy($sortBy, $sortDir);
|
|
|
|
|
|
|
|
|
|
return $query->paginate($filters['per_page'] ?? 20);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public function show(int $id): Equipment
|
|
|
|
|
{
|
|
|
|
|
$equipment = Equipment::with(['manager', 'subManager', 'inspectionTemplates', 'repairs', 'processes', 'photos'])->find($id);
|
|
|
|
|
|
|
|
|
|
if (! $equipment) {
|
|
|
|
|
throw new NotFoundHttpException(__('error.equipment.not_found'));
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
return $equipment;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public function store(array $data): Equipment
|
|
|
|
|
{
|
|
|
|
|
return DB::transaction(function () use ($data) {
|
|
|
|
|
$data['tenant_id'] = $this->tenantId();
|
|
|
|
|
|
|
|
|
|
return Equipment::create($data);
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public function update(int $id, array $data): Equipment
|
|
|
|
|
{
|
|
|
|
|
return DB::transaction(function () use ($id, $data) {
|
|
|
|
|
$equipment = Equipment::find($id);
|
|
|
|
|
|
|
|
|
|
if (! $equipment) {
|
|
|
|
|
throw new NotFoundHttpException(__('error.equipment.not_found'));
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
$equipment->update($data);
|
|
|
|
|
|
|
|
|
|
return $equipment->fresh();
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public function destroy(int $id): bool
|
|
|
|
|
{
|
|
|
|
|
return DB::transaction(function () use ($id) {
|
|
|
|
|
$equipment = Equipment::find($id);
|
|
|
|
|
|
|
|
|
|
if (! $equipment) {
|
|
|
|
|
throw new NotFoundHttpException(__('error.equipment.not_found'));
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
return $equipment->delete();
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public function restore(int $id): Equipment
|
|
|
|
|
{
|
|
|
|
|
return DB::transaction(function () use ($id) {
|
|
|
|
|
$equipment = Equipment::onlyTrashed()->find($id);
|
|
|
|
|
|
|
|
|
|
if (! $equipment) {
|
|
|
|
|
throw new NotFoundHttpException(__('error.equipment.not_found'));
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
$equipment->restore();
|
|
|
|
|
|
|
|
|
|
return $equipment->fresh();
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public function toggleActive(int $id): Equipment
|
|
|
|
|
{
|
|
|
|
|
return DB::transaction(function () use ($id) {
|
|
|
|
|
$equipment = Equipment::find($id);
|
|
|
|
|
|
|
|
|
|
if (! $equipment) {
|
|
|
|
|
throw new NotFoundHttpException(__('error.equipment.not_found'));
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
$equipment->update(['is_active' => ! $equipment->is_active]);
|
|
|
|
|
|
|
|
|
|
return $equipment->fresh();
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public function stats(): array
|
|
|
|
|
{
|
|
|
|
|
$total = Equipment::count();
|
|
|
|
|
$active = Equipment::where('status', 'active')->count();
|
|
|
|
|
$idle = Equipment::where('status', 'idle')->count();
|
|
|
|
|
$disposed = Equipment::where('status', 'disposed')->count();
|
|
|
|
|
|
2026-03-12 18:47:39 +09:00
|
|
|
// 설비 유형별 현황
|
|
|
|
|
$typeDistribution = Equipment::where('status', '!=', 'disposed')
|
|
|
|
|
->whereNotNull('equipment_type')
|
|
|
|
|
->selectRaw('equipment_type, count(*) as count')
|
|
|
|
|
->groupBy('equipment_type')
|
|
|
|
|
->orderByDesc('count')
|
|
|
|
|
->get()
|
|
|
|
|
->toArray();
|
|
|
|
|
|
|
|
|
|
// 이번달 점검 현황
|
|
|
|
|
$yearMonth = now()->format('Y-m');
|
|
|
|
|
$targetCount = Equipment::where('status', 'active')->count();
|
|
|
|
|
$completedCount = EquipmentInspection::where('year_month', $yearMonth)->distinct('equipment_id')->count('equipment_id');
|
|
|
|
|
$issueCount = EquipmentInspection::where('year_month', $yearMonth)
|
|
|
|
|
->where(function ($q) {
|
|
|
|
|
$q->whereNotNull('issue_note')->where('issue_note', '!=', '');
|
|
|
|
|
})
|
|
|
|
|
->count();
|
|
|
|
|
|
|
|
|
|
return [
|
|
|
|
|
'total' => $total,
|
|
|
|
|
'active' => $active,
|
|
|
|
|
'idle' => $idle,
|
|
|
|
|
'disposed' => $disposed,
|
|
|
|
|
'type_distribution' => $typeDistribution,
|
|
|
|
|
'inspection_stats' => [
|
|
|
|
|
'target_count' => $targetCount,
|
|
|
|
|
'completed_count' => $completedCount,
|
|
|
|
|
'issue_count' => $issueCount,
|
|
|
|
|
],
|
|
|
|
|
];
|
feat: [equipment] 설비관리 API 백엔드 구현 (Phase 1)
- 모델 6개: Equipment, EquipmentInspection, EquipmentInspectionDetail, EquipmentInspectionTemplate, EquipmentRepair, EquipmentProcess
- InspectionCycle Enum: 6주기(일/주/월/격월/분기/반기) 날짜 해석
- 서비스 4개: EquipmentService, EquipmentInspectionService, EquipmentRepairService, EquipmentPhotoService
- 컨트롤러 4개: CRUD + 점검 토글/결과 설정/메모/초기화 + 템플릿 관리 + 수리이력 + 사진
- FormRequest 6개: 설비등록/수정, 수리이력, 점검템플릿, 토글, 메모
- 라우트 26개: equipment prefix 하위 RESTful 엔드포인트
- i18n 메시지: message.equipment.*, error.equipment.*
- 마이그레이션: equipments/equipment_repairs options JSON 컬럼 추가
2026-03-12 10:52:30 +09:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public function options(): array
|
|
|
|
|
{
|
|
|
|
|
return [
|
|
|
|
|
'equipment_types' => Equipment::getEquipmentTypes(),
|
|
|
|
|
'production_lines' => Equipment::getProductionLines(),
|
|
|
|
|
'statuses' => Equipment::getStatuses(),
|
|
|
|
|
'equipment_list' => Equipment::active()
|
|
|
|
|
->orderBy('sort_order')
|
|
|
|
|
->orderBy('name')
|
|
|
|
|
->get(['id', 'equipment_code', 'name', 'equipment_type', 'production_line']),
|
|
|
|
|
];
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public function typeStats(): array
|
|
|
|
|
{
|
|
|
|
|
return Equipment::where('status', '!=', 'disposed')
|
|
|
|
|
->selectRaw('equipment_type, count(*) as count')
|
|
|
|
|
->groupBy('equipment_type')
|
|
|
|
|
->pluck('count', 'equipment_type')
|
|
|
|
|
->toArray();
|
|
|
|
|
}
|
|
|
|
|
}
|