where('payment_method', 'card') ->with(['card', 'card.assignedUser', 'creator']); // 날짜 필터 if (! empty($params['start_date'])) { $query->where(function ($q) use ($params) { $q->whereDate('used_at', '>=', $params['start_date']) ->orWhere(function ($q2) use ($params) { $q2->whereNull('used_at') ->whereDate('withdrawal_date', '>=', $params['start_date']); }); }); } if (! empty($params['end_date'])) { $query->where(function ($q) use ($params) { $q->whereDate('used_at', '<=', $params['end_date']) ->orWhere(function ($q2) use ($params) { $q2->whereNull('used_at') ->whereDate('withdrawal_date', '<=', $params['end_date']); }); }); } // 카드 필터 if (! empty($params['card_id'])) { $query->where('card_id', $params['card_id']); } // 검색 (카드번호, 가맹점명, 적요) if (! empty($params['search'])) { $search = $params['search']; $query->where(function ($q) use ($search) { $q->where('merchant_name', 'like', "%{$search}%") ->orWhere('description', 'like', "%{$search}%") ->orWhereHas('card', function ($cardQ) use ($search) { $cardQ->where('card_name', 'like', "%{$search}%") ->orWhere('card_company', 'like', "%{$search}%"); }); }); } // 정렬 $sortBy = $params['sort_by'] ?? 'used_at'; $sortDir = $params['sort_dir'] ?? 'desc'; // 정렬 필드 매핑 $sortableFields = [ 'used_at' => DB::raw('COALESCE(used_at, withdrawal_date)'), 'amount' => 'amount', 'merchant_name' => 'merchant_name', 'created_at' => 'created_at', ]; if (array_key_exists($sortBy, $sortableFields)) { $query->orderBy($sortableFields[$sortBy], $sortDir); } else { $query->orderBy(DB::raw('COALESCE(used_at, withdrawal_date)'), 'desc'); } $perPage = $params['per_page'] ?? 20; return $query->paginate($perPage); } /** * 카드 거래 요약 통계 * * @param array{start_date?: string, end_date?: string} $params * @return array{ * previous_month_total: float, * current_month_total: float, * total_count: int, * total_amount: float * } */ public function summary(array $params = []): array { // 전월 기준일 계산 $currentDate = now(); $currentMonthStart = $currentDate->copy()->startOfMonth()->toDateString(); $currentMonthEnd = $currentDate->copy()->endOfMonth()->toDateString(); $previousMonthStart = $currentDate->copy()->subMonth()->startOfMonth()->toDateString(); $previousMonthEnd = $currentDate->copy()->subMonth()->endOfMonth()->toDateString(); // 전월 카드 사용액 $previousMonthTotal = Withdrawal::query() ->where('payment_method', 'card') ->where(function ($q) use ($previousMonthStart, $previousMonthEnd) { $q->whereBetween(DB::raw('DATE(COALESCE(used_at, withdrawal_date))'), [$previousMonthStart, $previousMonthEnd]); }) ->sum('amount'); // 당월 카드 사용액 $currentMonthTotal = Withdrawal::query() ->where('payment_method', 'card') ->where(function ($q) use ($currentMonthStart, $currentMonthEnd) { $q->whereBetween(DB::raw('DATE(COALESCE(used_at, withdrawal_date))'), [$currentMonthStart, $currentMonthEnd]); }) ->sum('amount'); // 조회 기간 내 총 건수/금액 (옵션) $periodQuery = Withdrawal::query()->where('payment_method', 'card'); if (! empty($params['start_date'])) { $periodQuery->where(DB::raw('DATE(COALESCE(used_at, withdrawal_date))'), '>=', $params['start_date']); } if (! empty($params['end_date'])) { $periodQuery->where(DB::raw('DATE(COALESCE(used_at, withdrawal_date))'), '<=', $params['end_date']); } $totalCount = $periodQuery->count(); $totalAmount = (clone $periodQuery)->sum('amount'); return [ 'previous_month_total' => (float) $previousMonthTotal, 'current_month_total' => (float) $currentMonthTotal, 'total_count' => $totalCount, 'total_amount' => (float) $totalAmount, ]; } /** * 계정과목 일괄 수정 * * @param array $ids 거래 ID 배열 * @param string $accountCode 계정과목 코드 * @return int 수정된 건수 */ public function bulkUpdateAccountCode(array $ids, string $accountCode): int { return Withdrawal::query() ->whereIn('id', $ids) ->where('payment_method', 'card') ->update([ 'account_code' => $accountCode, 'updated_by' => $this->apiUserId(), ]); } /** * 단일 카드 거래 조회 */ public function show(int $id): ?Withdrawal { return Withdrawal::query() ->where('payment_method', 'card') ->with(['card', 'card.assignedUser', 'creator']) ->find($id); } }