From 4373369133f99f11bca6ef51ffe6c2de147d1f42 Mon Sep 17 00:00:00 2001
From: kent <shine1324@gmail.com>
Date: Sun, 21 Dec 2025 16:05:54 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20TODO-004=20=ED=94=84=EB=A1=A0=ED=8A=B8?=
 =?UTF-8?q?=EC=97=94=EB=93=9C=20client=5Ftype=20=EC=BD=94=EB=93=9C?=
 =?UTF-8?q?=EA=B0=92=20=EC=A0=84=EC=86=A1=20=EA=B0=9C=EC=84=A0=20=ED=95=AD?=
 =?UTF-8?q?=EB=AA=A9=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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

Co-Authored-By: Claude <noreply@anthropic.com>
---
 TODO.md | 41 ++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 40 insertions(+), 1 deletion(-)

diff --git a/TODO.md b/TODO.md
index 50683fd..16c708f 100644
--- a/TODO.md
+++ b/TODO.md
@@ -1,6 +1,6 @@
 # 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/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은(는) 유효하지 않습니다."]
+    }
+  }
+}
+```
+
 ---
 
 ## 🟢 개선 (최적화)