- ReceivablesController: boolean 유효성 검사를 string|in:true,false,1,0으로 변경 - 쿼리 문자열의 "true" 문자열을 올바르게 처리 - 디버깅용 Log::info 추가 - ReceivablesService: 동적 월 기간 지원 - recent_year=true 시 최근 12개월 동적 계산 - 월별 레이블 동적 생성 (예: 25.02, 25.03...) - 이월잔액(carry_forward_balance) 계산 추가 - Client 모델: is_overdue, memo 필드 추가 - 마이그레이션: clients 테이블에 is_overdue 컬럼 추가 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
103 lines
3.4 KiB
PHP
103 lines
3.4 KiB
PHP
<?php
|
|
|
|
namespace App\Http\Controllers\Api\V1;
|
|
|
|
use App\Helpers\ApiResponse;
|
|
use App\Http\Controllers\Controller;
|
|
use App\Services\ReceivablesService;
|
|
use Illuminate\Http\JsonResponse;
|
|
use Illuminate\Http\Request;
|
|
|
|
/**
|
|
* 채권 현황 컨트롤러
|
|
*/
|
|
class ReceivablesController extends Controller
|
|
{
|
|
public function __construct(
|
|
protected ReceivablesService $service
|
|
) {}
|
|
|
|
/**
|
|
* 채권 현황 목록 조회
|
|
*/
|
|
public function index(Request $request): JsonResponse
|
|
{
|
|
return ApiResponse::handle(function () use ($request) {
|
|
$params = $request->validate([
|
|
'year' => 'nullable|integer|min:2000|max:2100', 'recent_year' => 'nullable|string|in:true,false,1,0',
|
|
'search' => 'nullable|string|max:100',
|
|
'has_receivable' => 'nullable|string|in:true,false,1,0',
|
|
]);
|
|
|
|
// 문자열 boolean을 실제 boolean으로 변환
|
|
if (isset($params['recent_year'])) {
|
|
$params['recent_year'] = filter_var($params['recent_year'], FILTER_VALIDATE_BOOLEAN);
|
|
}
|
|
if (isset($params['has_receivable'])) {
|
|
$params['has_receivable'] = filter_var($params['has_receivable'], FILTER_VALIDATE_BOOLEAN);
|
|
}
|
|
|
|
\Log::info('[Receivables] index params', $params);
|
|
|
|
return $this->service->index($params);
|
|
}, __('message.fetched'));
|
|
}
|
|
|
|
/**
|
|
* 채권 현황 요약 통계
|
|
*/
|
|
public function summary(Request $request): JsonResponse
|
|
{
|
|
return ApiResponse::handle(function () use ($request) {
|
|
$params = $request->validate([
|
|
'year' => 'nullable|integer|min:2000|max:2100',
|
|
'recent_year' => 'nullable|string|in:true,false,1,0',
|
|
]);
|
|
|
|
// 문자열 boolean을 실제 boolean으로 변환
|
|
if (isset($params['recent_year'])) {
|
|
$params['recent_year'] = filter_var($params['recent_year'], FILTER_VALIDATE_BOOLEAN);
|
|
}
|
|
|
|
\Log::info('[Receivables] summary params', $params);
|
|
|
|
return $this->service->summary($params);
|
|
}, __('message.fetched'));
|
|
}
|
|
|
|
/**
|
|
* 연체 상태 일괄 업데이트
|
|
*/
|
|
public function updateOverdueStatus(Request $request): JsonResponse
|
|
{
|
|
return ApiResponse::handle(function () use ($request) {
|
|
$validated = $request->validate([
|
|
'updates' => 'required|array|min:1',
|
|
'updates.*.id' => 'required|integer|exists:clients,id',
|
|
'updates.*.is_overdue' => 'required|boolean',
|
|
]);
|
|
|
|
$updatedCount = $this->service->updateOverdueStatus($validated['updates']);
|
|
|
|
return ['updated_count' => $updatedCount];
|
|
}, __('message.updated'));
|
|
}
|
|
|
|
/**
|
|
* 거래처 메모 일괄 업데이트
|
|
*/
|
|
public function updateMemos(Request $request): JsonResponse
|
|
{
|
|
return ApiResponse::handle(function () use ($request) {
|
|
$validated = $request->validate([
|
|
'memos' => 'required|array|min:1',
|
|
'memos.*.id' => 'required|integer|exists:clients,id',
|
|
'memos.*.memo' => 'nullable|string|max:1000',
|
|
]);
|
|
|
|
$updatedCount = $this->service->updateMemos($validated['memos']);
|
|
|
|
return ['updated_count' => $updatedCount];
|
|
}, __('message.updated'));
|
|
}
|
|
} |