docs: TODO-004 프론트엔드 client_type 코드값 전송 개선 항목 추가

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
2025-12-21 16:05:54 +09:00
parent 0c22bd8b1f
commit 4373369133

41
TODO.md
View File

@@ -1,6 +1,6 @@
# SAM Project TODO # SAM Project TODO
> **마지막 업데이트**: 2025-12-20 > **마지막 업데이트**: 2025-12-21
--- ---
@@ -72,6 +72,45 @@
- `docs/projects/api-integration/phase-3-api-mapping/mapping-matrix.md` - `docs/projects/api-integration/phase-3-api-mapping/mapping-matrix.md`
- `docs/projects/api-integration/phase-3-api-mapping/gap-analysis.md` - `docs/projects/api-integration/phase-3-api-mapping/gap-analysis.md`
### [TODO-004] 프론트엔드 client_type 코드값 전송 개선
**발견일**: 2025-12-21
**우선순위**: 🟡 중요
**카테고리**: 데이터 정합성
**현재 상태**:
- 프론트엔드에서 `client_type`에 한글 이름(`매입`, `매출`) 전송
- API는 `common_codes.code` 값(`PURCHASE`, `SALES`) 기대
- 422 Validation Error 발생
**임시 해결**:
- API `ClientStoreRequest`, `ClientUpdateRequest`에서 `prepareForValidation()` 추가
- 한글 name → code 자동 변환 처리
**영구 해결 필요**:
| 파일 | 수정 내용 |
|------|----------|
| `react/src/hooks/useClientList.ts` | client_type 전송 시 code 값 사용 |
| `react/src/components/clients/*` | 폼에서 code/name 구분 처리 |
**유효한 코드값**:
| code | name |
|------|------|
| `PURCHASE` | 매입 |
| `SALES` | 매출 |
| `BOTH` | 매입매출 |
**관련 에러**:
```json
{
"error": {
"details": {
"client_type": ["선택된 client type은(는) 유효하지 않습니다."]
}
}
}
```
--- ---
## 🟢 개선 (최적화) ## 🟢 개선 (최적화)