tenantId(); $query = Bill::query() ->where('tenant_id', $tenantId) ->with(['client:id,name', 'bankAccount:id,bank_name,account_name', 'installments']); // 검색어 필터 if (! empty($params['search'])) { $search = $params['search']; $query->where(function ($q) use ($search) { $q->where('bill_number', 'like', "%{$search}%") ->orWhere('client_name', 'like', "%{$search}%") ->orWhere('note', 'like', "%{$search}%") ->orWhereHas('client', function ($q) use ($search) { $q->where('name', 'like', "%{$search}%"); }); }); } // 어음 구분 필터 (received/issued) if (! empty($params['bill_type'])) { $query->where('bill_type', $params['bill_type']); } // 상태 필터 if (! empty($params['status'])) { $query->where('status', $params['status']); } // 거래처 필터 if (! empty($params['client_id'])) { $query->where('client_id', $params['client_id']); } // 전자어음 필터 if (isset($params['is_electronic']) && $params['is_electronic'] !== '') { $query->where('is_electronic', (bool) $params['is_electronic']); } // 발행일 범위 필터 if (! empty($params['issue_start_date'])) { $query->where('issue_date', '>=', $params['issue_start_date']); } if (! empty($params['issue_end_date'])) { $query->where('issue_date', '<=', $params['issue_end_date']); } // 만기일 범위 필터 if (! empty($params['maturity_start_date'])) { $query->where('maturity_date', '>=', $params['maturity_start_date']); } if (! empty($params['maturity_end_date'])) { $query->where('maturity_date', '<=', $params['maturity_end_date']); } // 정렬 $sortBy = $params['sort_by'] ?? 'issue_date'; $sortDir = $params['sort_dir'] ?? 'desc'; $query->orderBy($sortBy, $sortDir); // 페이지네이션 $perPage = $params['per_page'] ?? 20; return $query->paginate($perPage); } /** * 어음 상세 조회 */ public function show(int $id): Bill { $tenantId = $this->tenantId(); return Bill::query() ->where('tenant_id', $tenantId) ->with(['client:id,name', 'bankAccount:id,bank_name,account_name', 'installments', 'creator:id,name']) ->findOrFail($id); } /** * 어음 등록 */ public function store(array $data): Bill { $tenantId = $this->tenantId(); $userId = $this->apiUserId(); return DB::transaction(function () use ($data, $tenantId, $userId) { // 어음번호 자동 생성 (없을 경우) $billNumber = $data['bill_number'] ?? $this->generateBillNumber($tenantId); $bill = new Bill; $bill->tenant_id = $tenantId; $bill->bill_number = $billNumber; $bill->bill_type = $data['bill_type']; $bill->client_id = $data['client_id'] ?? null; $bill->client_name = $data['client_name'] ?? null; $bill->amount = $data['amount']; $bill->issue_date = $data['issue_date']; $bill->maturity_date = $data['maturity_date']; $bill->status = $data['status'] ?? 'stored'; $bill->reason = $data['reason'] ?? null; $bill->installment_count = $data['installment_count'] ?? 0; $bill->note = $data['note'] ?? null; $bill->is_electronic = $data['is_electronic'] ?? false; $bill->bank_account_id = $data['bank_account_id'] ?? null; $bill->created_by = $userId; $bill->updated_by = $userId; $bill->save(); // 차수 관리 저장 if (! empty($data['installments'])) { foreach ($data['installments'] as $installment) { BillInstallment::create([ 'bill_id' => $bill->id, 'installment_date' => $installment['date'], 'amount' => $installment['amount'], 'note' => $installment['note'] ?? null, 'created_by' => $userId, ]); } // 차수 카운트 업데이트 $bill->installment_count = count($data['installments']); $bill->save(); } return $bill->load(['client:id,name', 'bankAccount:id,bank_name,account_name', 'installments']); }); } /** * 어음 수정 */ public function update(int $id, array $data): Bill { $tenantId = $this->tenantId(); $userId = $this->apiUserId(); return DB::transaction(function () use ($id, $data, $tenantId, $userId) { $bill = Bill::query() ->where('tenant_id', $tenantId) ->findOrFail($id); if (isset($data['bill_number'])) { $bill->bill_number = $data['bill_number']; } if (isset($data['bill_type'])) { $bill->bill_type = $data['bill_type']; } if (array_key_exists('client_id', $data)) { $bill->client_id = $data['client_id']; } if (array_key_exists('client_name', $data)) { $bill->client_name = $data['client_name']; } if (isset($data['amount'])) { $bill->amount = $data['amount']; } if (isset($data['issue_date'])) { $bill->issue_date = $data['issue_date']; } if (isset($data['maturity_date'])) { $bill->maturity_date = $data['maturity_date']; } if (isset($data['status'])) { $bill->status = $data['status']; } if (array_key_exists('reason', $data)) { $bill->reason = $data['reason']; } if (array_key_exists('note', $data)) { $bill->note = $data['note']; } if (isset($data['is_electronic'])) { $bill->is_electronic = $data['is_electronic']; } if (array_key_exists('bank_account_id', $data)) { $bill->bank_account_id = $data['bank_account_id']; } $bill->updated_by = $userId; $bill->save(); // 차수 관리 업데이트 (전체 교체) if (isset($data['installments'])) { // 기존 차수 삭제 $bill->installments()->delete(); // 새 차수 추가 foreach ($data['installments'] as $installment) { BillInstallment::create([ 'bill_id' => $bill->id, 'installment_date' => $installment['date'], 'amount' => $installment['amount'], 'note' => $installment['note'] ?? null, 'created_by' => $userId, ]); } // 차수 카운트 업데이트 $bill->installment_count = count($data['installments']); $bill->save(); } return $bill->fresh(['client:id,name', 'bankAccount:id,bank_name,account_name', 'installments']); }); } /** * 어음 삭제 */ public function destroy(int $id): bool { $tenantId = $this->tenantId(); $userId = $this->apiUserId(); return DB::transaction(function () use ($id, $tenantId, $userId) { $bill = Bill::query() ->where('tenant_id', $tenantId) ->findOrFail($id); $bill->deleted_by = $userId; $bill->save(); $bill->delete(); return true; }); } /** * 어음 상태 변경 */ public function updateStatus(int $id, string $status): Bill { $tenantId = $this->tenantId(); $userId = $this->apiUserId(); $bill = Bill::query() ->where('tenant_id', $tenantId) ->findOrFail($id); $bill->status = $status; $bill->updated_by = $userId; $bill->save(); return $bill->fresh(['client:id,name', 'bankAccount:id,bank_name,account_name', 'installments']); } /** * 어음 요약 (기간별 합계) */ public function summary(array $params): array { $tenantId = $this->tenantId(); $query = Bill::query() ->where('tenant_id', $tenantId); // 어음 구분 필터 if (! empty($params['bill_type'])) { $query->where('bill_type', $params['bill_type']); } // 발행일 범위 필터 if (! empty($params['issue_start_date'])) { $query->where('issue_date', '>=', $params['issue_start_date']); } if (! empty($params['issue_end_date'])) { $query->where('issue_date', '<=', $params['issue_end_date']); } // 만기일 범위 필터 if (! empty($params['maturity_start_date'])) { $query->where('maturity_date', '>=', $params['maturity_start_date']); } if (! empty($params['maturity_end_date'])) { $query->where('maturity_date', '<=', $params['maturity_end_date']); } // 전체 합계 $total = (clone $query)->sum('amount'); $count = (clone $query)->count(); // 구분별 합계 $byType = (clone $query) ->select('bill_type', DB::raw('SUM(amount) as total'), DB::raw('COUNT(*) as count')) ->groupBy('bill_type') ->get() ->keyBy('bill_type') ->toArray(); // 상태별 합계 $byStatus = (clone $query) ->select('status', DB::raw('SUM(amount) as total'), DB::raw('COUNT(*) as count')) ->groupBy('status') ->get() ->keyBy('status') ->toArray(); // 만기 임박 (7일 이내) $maturityAlert = (clone $query) ->where('maturity_date', '>=', now()->toDateString()) ->where('maturity_date', '<=', now()->addDays(7)->toDateString()) ->whereNotIn('status', ['paymentComplete', 'collectionComplete', 'dishonored']) ->sum('amount'); return [ 'total_amount' => (float) $total, 'total_count' => $count, 'by_type' => $byType, 'by_status' => $byStatus, 'maturity_alert_amount' => (float) $maturityAlert, ]; } /** * 발행어음 대시보드 상세 조회 (CEO 대시보드 당월 예상 지출내역 me3 모달용) * * @return array{ * summary: array{current_month_total: float, previous_month_total: float, change_rate: float}, * monthly_trend: array, * by_vendor: array, * items: array * } */ public function dashboardDetail(): array { $tenantId = $this->tenantId(); // 현재 월 범위 $currentMonthStart = now()->startOfMonth()->toDateString(); $currentMonthEnd = now()->endOfMonth()->toDateString(); // 전월 범위 $previousMonthStart = now()->subMonth()->startOfMonth()->toDateString(); $previousMonthEnd = now()->subMonth()->endOfMonth()->toDateString(); // 1. 요약 정보 (발행어음 기준) $currentMonthTotal = Bill::query() ->where('tenant_id', $tenantId) ->where('bill_type', 'issued') ->whereBetween('issue_date', [$currentMonthStart, $currentMonthEnd]) ->sum('amount'); $previousMonthTotal = Bill::query() ->where('tenant_id', $tenantId) ->where('bill_type', 'issued') ->whereBetween('issue_date', [$previousMonthStart, $previousMonthEnd]) ->sum('amount'); $changeRate = $previousMonthTotal > 0 ? round((($currentMonthTotal - $previousMonthTotal) / $previousMonthTotal) * 100, 1) : 0; // 2. 월별 추이 (최근 7개월) $monthlyTrend = []; for ($i = 6; $i >= 0; $i--) { $monthStart = now()->subMonths($i)->startOfMonth(); $monthEnd = now()->subMonths($i)->endOfMonth(); $amount = Bill::query() ->where('tenant_id', $tenantId) ->where('bill_type', 'issued') ->whereBetween('issue_date', [$monthStart->toDateString(), $monthEnd->toDateString()]) ->sum('amount'); $monthlyTrend[] = [ 'month' => $monthStart->format('Y-m'), 'amount' => (float) $amount, ]; } // 3. 거래처별 분포 (현재 월) $byVendorRaw = Bill::query() ->where('tenant_id', $tenantId) ->where('bill_type', 'issued') ->whereBetween('issue_date', [$currentMonthStart, $currentMonthEnd]) ->select( DB::raw('COALESCE(client_name, (SELECT name FROM clients WHERE clients.id = bills.client_id)) as vendor_name'), DB::raw('SUM(amount) as amount') ) ->groupBy('client_id', 'client_name') ->orderByDesc('amount') ->get(); $totalAmount = $byVendorRaw->sum('amount'); $byVendor = $byVendorRaw->map(function ($item) use ($totalAmount) { return [ 'vendor_name' => $item->vendor_name ?? '미지정', 'amount' => (float) $item->amount, 'ratio' => $totalAmount > 0 ? round(($item->amount / $totalAmount) * 100, 1) : 0, ]; })->toArray(); // 4. 발행어음 목록 (현재 월) $items = Bill::query() ->where('tenant_id', $tenantId) ->where('bill_type', 'issued') ->whereBetween('issue_date', [$currentMonthStart, $currentMonthEnd]) ->with(['client:id,name']) ->orderBy('maturity_date', 'asc') ->get() ->map(function ($bill) { return [ 'id' => $bill->id, 'vendor_name' => $bill->client?->name ?? $bill->client_name ?? '-', 'issue_date' => $bill->issue_date->format('Y-m-d'), 'maturity_date' => $bill->maturity_date->format('Y-m-d'), 'amount' => (float) $bill->amount, 'status' => $bill->status, 'status_label' => Bill::ISSUED_STATUSES[$bill->status] ?? $bill->status, ]; }) ->toArray(); return [ 'summary' => [ 'current_month_total' => (float) $currentMonthTotal, 'previous_month_total' => (float) $previousMonthTotal, 'change_rate' => $changeRate, ], 'monthly_trend' => $monthlyTrend, 'by_vendor' => $byVendor, 'items' => $items, ]; } /** * 어음번호 자동 생성 */ private function generateBillNumber(int $tenantId): string { $prefix = date('Ym'); $lastBill = Bill::query() ->where('tenant_id', $tenantId) ->where('bill_number', 'like', $prefix.'%') ->orderBy('bill_number', 'desc') ->first(); if ($lastBill) { $lastNumber = (int) substr($lastBill->bill_number, strlen($prefix)); $nextNumber = $lastNumber + 1; } else { $nextNumber = 1; } return $prefix.str_pad((string) $nextNumber, 6, '0', STR_PAD_LEFT); } }