Files
sam-api/app/Services/Construction/HandoverReportService.php
kent 8a5c7b5298 feat(API): Service 로직 개선
- EstimateService, ItemService 기능 추가
- OrderService 공정 연동 개선
- SalaryService, ReceivablesService 수정
- HandoverReportService, SiteBriefingService 추가
- Pricing 서비스 추가

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-13 19:49:06 +09:00

334 lines
13 KiB
PHP

<?php
namespace App\Services\Construction;
use App\Models\Construction\HandoverReport;
use App\Models\Construction\HandoverReportItem;
use App\Models\Construction\HandoverReportManager;
use App\Services\Service;
use Illuminate\Contracts\Pagination\LengthAwarePaginator;
use Illuminate\Support\Facades\DB;
class HandoverReportService extends Service
{
/**
* 인수인계보고서 목록 조회
*/
public function index(array $params): LengthAwarePaginator
{
$tenantId = $this->tenantId();
$query = HandoverReport::query()
->where('tenant_id', $tenantId);
// 검색 필터
if (! empty($params['search'])) {
$search = $params['search'];
$query->where(function ($q) use ($search) {
$q->where('report_number', 'like', "%{$search}%")
->orWhere('site_name', 'like', "%{$search}%")
->orWhere('partner_name', 'like', "%{$search}%");
});
}
// 상태 필터
if (! empty($params['status'])) {
$query->where('status', $params['status']);
}
// 거래처 필터
if (! empty($params['partner_id'])) {
$query->where('partner_id', $params['partner_id']);
}
// 계약담당자 필터
if (! empty($params['contract_manager_id'])) {
$query->where('contract_manager_id', $params['contract_manager_id']);
}
// 공사PM 필터
if (! empty($params['construction_pm_id'])) {
$query->where('construction_pm_id', $params['construction_pm_id']);
}
// 연결 계약 필터
if (! empty($params['contract_id'])) {
$query->where('contract_id', $params['contract_id']);
}
// 날짜 범위 필터
if (! empty($params['start_date'])) {
$query->where('contract_start_date', '>=', $params['start_date']);
}
if (! empty($params['end_date'])) {
$query->where('contract_end_date', '<=', $params['end_date']);
}
// 활성화 상태 필터
if (isset($params['is_active'])) {
$query->where('is_active', $params['is_active']);
}
// 정렬
$sortBy = $params['sort_by'] ?? 'created_at';
$sortDir = $params['sort_dir'] ?? 'desc';
$query->orderBy($sortBy, $sortDir);
// 페이지네이션
$perPage = $params['per_page'] ?? 20;
return $query->paginate($perPage);
}
/**
* 인수인계보고서 상세 조회
*/
public function show(int $id): HandoverReport
{
$tenantId = $this->tenantId();
return HandoverReport::query()
->where('tenant_id', $tenantId)
->with(['contract', 'contractManager', 'constructionPm', 'managers', 'items', 'creator', 'updater'])
->findOrFail($id);
}
/**
* 인수인계보고서 등록
*/
public function store(array $data): HandoverReport
{
$tenantId = $this->tenantId();
$userId = $this->apiUserId();
return DB::transaction(function () use ($data, $tenantId, $userId) {
// 메인 보고서 생성
$report = HandoverReport::create([
'tenant_id' => $tenantId,
'report_number' => $data['report_number'],
'contract_id' => $data['contract_id'] ?? null,
'site_name' => $data['site_name'],
'partner_id' => $data['partner_id'] ?? null,
'partner_name' => $data['partner_name'] ?? null,
'contract_manager_id' => $data['contract_manager_id'] ?? null,
'contract_manager_name' => $data['contract_manager_name'] ?? null,
'construction_pm_id' => $data['construction_pm_id'] ?? null,
'construction_pm_name' => $data['construction_pm_name'] ?? null,
'total_sites' => $data['total_sites'] ?? 0,
'contract_amount' => $data['contract_amount'] ?? 0,
'contract_date' => $data['contract_date'] ?? null,
'contract_start_date' => $data['contract_start_date'] ?? null,
'contract_end_date' => $data['contract_end_date'] ?? null,
'completion_date' => $data['completion_date'] ?? null,
'status' => $data['status'] ?? HandoverReport::STATUS_PENDING,
'has_secondary_piping' => $data['has_secondary_piping'] ?? false,
'secondary_piping_amount' => $data['secondary_piping_amount'] ?? 0,
'secondary_piping_note' => $data['secondary_piping_note'] ?? null,
'has_coating' => $data['has_coating'] ?? false,
'coating_amount' => $data['coating_amount'] ?? 0,
'coating_note' => $data['coating_note'] ?? null,
'external_equipment_cost' => $data['external_equipment_cost'] ?? null,
'special_notes' => $data['special_notes'] ?? null,
'is_active' => $data['is_active'] ?? true,
'created_by' => $userId,
'updated_by' => $userId,
]);
// 공사담당자 생성
if (! empty($data['managers'])) {
$this->syncManagers($report, $data['managers'], $tenantId, $userId);
}
// 계약 ITEM 생성
if (! empty($data['items'])) {
$this->syncItems($report, $data['items'], $tenantId, $userId);
}
return $report->load(['managers', 'items']);
});
}
/**
* 인수인계보고서 수정
*/
public function update(int $id, array $data): HandoverReport
{
$tenantId = $this->tenantId();
$userId = $this->apiUserId();
return DB::transaction(function () use ($id, $data, $tenantId, $userId) {
$report = HandoverReport::query()
->where('tenant_id', $tenantId)
->findOrFail($id);
$report->fill([
'report_number' => $data['report_number'] ?? $report->report_number,
'contract_id' => $data['contract_id'] ?? $report->contract_id,
'site_name' => $data['site_name'] ?? $report->site_name,
'partner_id' => $data['partner_id'] ?? $report->partner_id,
'partner_name' => $data['partner_name'] ?? $report->partner_name,
'contract_manager_id' => $data['contract_manager_id'] ?? $report->contract_manager_id,
'contract_manager_name' => $data['contract_manager_name'] ?? $report->contract_manager_name,
'construction_pm_id' => $data['construction_pm_id'] ?? $report->construction_pm_id,
'construction_pm_name' => $data['construction_pm_name'] ?? $report->construction_pm_name,
'total_sites' => $data['total_sites'] ?? $report->total_sites,
'contract_amount' => $data['contract_amount'] ?? $report->contract_amount,
'contract_date' => $data['contract_date'] ?? $report->contract_date,
'contract_start_date' => $data['contract_start_date'] ?? $report->contract_start_date,
'contract_end_date' => $data['contract_end_date'] ?? $report->contract_end_date,
'completion_date' => $data['completion_date'] ?? $report->completion_date,
'status' => $data['status'] ?? $report->status,
'has_secondary_piping' => $data['has_secondary_piping'] ?? $report->has_secondary_piping,
'secondary_piping_amount' => $data['secondary_piping_amount'] ?? $report->secondary_piping_amount,
'secondary_piping_note' => $data['secondary_piping_note'] ?? $report->secondary_piping_note,
'has_coating' => $data['has_coating'] ?? $report->has_coating,
'coating_amount' => $data['coating_amount'] ?? $report->coating_amount,
'coating_note' => $data['coating_note'] ?? $report->coating_note,
'external_equipment_cost' => $data['external_equipment_cost'] ?? $report->external_equipment_cost,
'special_notes' => $data['special_notes'] ?? $report->special_notes,
'is_active' => $data['is_active'] ?? $report->is_active,
'updated_by' => $userId,
]);
$report->save();
// 공사담당자 동기화
if (array_key_exists('managers', $data)) {
$this->syncManagers($report, $data['managers'] ?? [], $tenantId, $userId);
}
// 계약 ITEM 동기화
if (array_key_exists('items', $data)) {
$this->syncItems($report, $data['items'] ?? [], $tenantId, $userId);
}
return $report->fresh(['managers', 'items']);
});
}
/**
* 인수인계보고서 삭제
*/
public function destroy(int $id): bool
{
$tenantId = $this->tenantId();
$userId = $this->apiUserId();
return DB::transaction(function () use ($id, $tenantId, $userId) {
$report = HandoverReport::query()
->where('tenant_id', $tenantId)
->findOrFail($id);
$report->deleted_by = $userId;
$report->save();
$report->delete();
return true;
});
}
/**
* 인수인계보고서 일괄 삭제
*/
public function bulkDestroy(array $ids): bool
{
$tenantId = $this->tenantId();
$userId = $this->apiUserId();
return DB::transaction(function () use ($ids, $tenantId, $userId) {
$reports = HandoverReport::query()
->where('tenant_id', $tenantId)
->whereIn('id', $ids)
->get();
foreach ($reports as $report) {
$report->deleted_by = $userId;
$report->save();
$report->delete();
}
return true;
});
}
/**
* 인수인계보고서 통계 조회
*/
public function stats(array $params): array
{
$tenantId = $this->tenantId();
$query = HandoverReport::query()
->where('tenant_id', $tenantId);
// 날짜 범위 필터
if (! empty($params['start_date'])) {
$query->where('contract_start_date', '>=', $params['start_date']);
}
if (! empty($params['end_date'])) {
$query->where('contract_end_date', '<=', $params['end_date']);
}
$totalCount = (clone $query)->count();
$pendingCount = (clone $query)->where('status', HandoverReport::STATUS_PENDING)->count();
$completedCount = (clone $query)->where('status', HandoverReport::STATUS_COMPLETED)->count();
$totalAmount = (clone $query)->sum('contract_amount');
$totalSites = (clone $query)->sum('total_sites');
return [
'total_count' => $totalCount,
'pending_count' => $pendingCount,
'completed_count' => $completedCount,
'total_amount' => (float) $totalAmount,
'total_sites' => (int) $totalSites,
];
}
/**
* 공사담당자 동기화
*/
private function syncManagers(HandoverReport $report, array $managers, int $tenantId, int $userId): void
{
// 기존 담당자 삭제
$report->managers()->delete();
// 새 담당자 생성
foreach ($managers as $index => $manager) {
HandoverReportManager::create([
'tenant_id' => $tenantId,
'handover_report_id' => $report->id,
'name' => $manager['name'],
'non_performance_reason' => $manager['non_performance_reason'] ?? null,
'signature' => $manager['signature'] ?? null,
'sort_order' => $index,
'created_by' => $userId,
'updated_by' => $userId,
]);
}
}
/**
* 계약 ITEM 동기화
*/
private function syncItems(HandoverReport $report, array $items, int $tenantId, int $userId): void
{
// 기존 아이템 삭제
$report->items()->delete();
// 새 아이템 생성
foreach ($items as $index => $item) {
HandoverReportItem::create([
'tenant_id' => $tenantId,
'handover_report_id' => $report->id,
'item_no' => $item['item_no'] ?? ($index + 1),
'name' => $item['name'],
'product' => $item['product'] ?? null,
'quantity' => $item['quantity'] ?? 0,
'remark' => $item['remark'] ?? null,
'created_by' => $userId,
'updated_by' => $userId,
]);
}
}
}