SamProject/sam-api
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(API): 채권현황 동적월 지원 및 year=0 파라미터 버그 수정

Browse Source 
- 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>
This commit is contained in:
권혁성
2026-01-02 14:47:51 +09:00
parent 4e59bbf574
commit 4fa38e39e6
5 changed files with 375 additions and 136 deletions
Download Patch File Download Diff File Expand all files Collapse all files

60
app/Http/Controllers/Api/V1/ReceivablesController.php
View File

@@ -24,11 +24,21 @@ public function index(Request $request): JsonResponse
{
return ApiResponse::handle(function () use ($request) {
$params = $request->validate([
'year' => 'nullable|integer|min:2000|max:2100',
'year' => 'nullable|integer|min:2000|max:2100', 'recent_year' => 'nullable|string|in:true,false,1,0',
'search' => 'nullable|string|max:100',
'has_receivable' => 'nullable|boolean',
'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'));
}
@@ -41,9 +51,53 @@ 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'));
}
}