feat: ApiResponse<T> 공통 응답 포맷 구현 (#14) #15

seonkyu.kim · 2026-02-09T04:58:31Z

seonkyu.kim commented

2026-02-09 04:58:31 +00:00

📋 작업 요약

모든 API에서 사용할 통일된 응답 포맷 ApiResponse<T> 래퍼 클래스 구현
Success(data) / Fail(code, msg) 정적 팩토리 메서드 제공
제네릭(ApiResponse<T>)과 비제네릭(ApiResponse) 두 가지 버전 지원

Closes #14

🛠️ 작업 내용 (Changes)

SPMS.Domain/Common/ApiResponse.cs — 공통 응답 래퍼 클래스 (result, code, msg, data)
- ApiResponse.Success() / ApiResponse.Fail(code, msg) — 데이터 없는 응답용
- ApiResponse<T>.Success(data) / ApiResponse<T>.Fail(code, msg) — 데이터 포함 응답용
- System.Text.Json.Serialization JsonPropertyName으로 camelCase JSON 직렬화

📢 리뷰어 참고 사항 (To Reviewers)

ErrorCodes.cs는 Issue #10(PR #11)에서 이미 구현 완료되어 별도 변경 없음
init 접근자 사용으로 생성 후 불변(immutable) 보장
Domain 레이어에 위치하여 모든 상위 레이어에서 참조 가능

✅ 체크리스트 (Self Checklist)

빌드(Build)가 성공적으로 수행되었는가?
모든 단위 테스트(Unit Test)를 통과하였는가?
불필요한 로그나 주석을 제거하였는가?
컨벤션(Clean Architecture, Naming)을 준수하였는가?
기밀 정보(비밀번호, 키 등)가 하드코딩 되어있지 않은가?

📸 스크린샷 / 테스트 로그 (Screenshots/Logs)

빌드했습니다.
    경고 0개
    오류 0개

## 📋 작업 요약 - 모든 API에서 사용할 통일된 응답 포맷 `ApiResponse<T>` 래퍼 클래스 구현 - `Success(data)` / `Fail(code, msg)` 정적 팩토리 메서드 제공 - 제네릭(`ApiResponse<T>`)과 비제네릭(`ApiResponse`) 두 가지 버전 지원 ## 🔗 관련 이슈 (Related Issues) Closes #14 ## 🛠️ 작업 내용 (Changes) - [x] `SPMS.Domain/Common/ApiResponse.cs` — 공통 응답 래퍼 클래스 (`result`, `code`, `msg`, `data`) - `ApiResponse.Success()` / `ApiResponse.Fail(code, msg)` — 데이터 없는 응답용 - `ApiResponse<T>.Success(data)` / `ApiResponse<T>.Fail(code, msg)` — 데이터 포함 응답용 - `System.Text.Json.Serialization` JsonPropertyName으로 camelCase JSON 직렬화 ## 📢 리뷰어 참고 사항 (To Reviewers) - ErrorCodes.cs는 Issue #10(PR #11)에서 이미 구현 완료되어 별도 변경 없음 - `init` 접근자 사용으로 생성 후 불변(immutable) 보장 - Domain 레이어에 위치하여 모든 상위 레이어에서 참조 가능 ## ✅ 체크리스트 (Self Checklist) - [x] 빌드(Build)가 성공적으로 수행되었는가? - [x] 모든 단위 테스트(Unit Test)를 통과하였는가? - [x] 불필요한 로그나 주석을 제거하였는가? - [x] 컨벤션(Clean Architecture, Naming)을 준수하였는가? - [x] 기밀 정보(비밀번호, 키 등)가 하드코딩 되어있지 않은가? ## 📸 스크린샷 / 테스트 로그 (Screenshots/Logs) ``` 빌드했습니다. 경고 0개 오류 0개 ```

seonkyu.kim added 1 commit 2026-02-09 04:58:32 +00:00

feat: ApiResponse<T> 공통 응답 포맷 구현 (#14 ) 4f0a4b9bf9

seonkyu.kim requested review from Owners 2026-02-09 04:59:58 +00:00

seonkyu.kim added the

labels 2026-02-09 05:00:05 +00:00

seonkyu.kim self-assigned this 2026-02-09 05:00:06 +00:00