From 0ba23f79875035f4532cec7cc5bb51280656d5d8 Mon Sep 17 00:00:00 2001 From: Klaus Date: Thu, 5 Mar 2026 14:12:19 +0900 Subject: [PATCH] =?UTF-8?q?docs(calculate):=20=EA=B4=80=EB=A6=AC=EC=9E=90?= =?UTF-8?q?=20=EC=A0=95=EC=82=B0=20=ED=8E=98=EC=9D=B4=EC=A7=95=20=EC=9E=91?= =?UTF-8?q?=EC=97=85=20=EA=B3=84=ED=9A=8D=EA=B3=BC=20=EA=B2=80=EC=A6=9D=20?= =?UTF-8?q?=EA=B8=B0=EB=A1=9D=EC=9D=84=20=EB=82=A8=EA=B8=B4=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/20260305_관리자정산페이징추가.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) create mode 100644 docs/20260305_관리자정산페이징추가.md diff --git a/docs/20260305_관리자정산페이징추가.md b/docs/20260305_관리자정산페이징추가.md new file mode 100644 index 00000000..63e81d4e --- /dev/null +++ b/docs/20260305_관리자정산페이징추가.md @@ -0,0 +1,14 @@ +- [x] 페이징 미적용 관리자 정산 API 식별 +- [x] Controller에 Pageable 파라미터 추가 및 Service 호출에 offset/limit 전달 +- [x] Service/Repository 쿼리에 offset/limit 반영 +- [x] 정적 진단 및 테스트/빌드 검증 + +## 검증 기록 + +### 1차 구현 +- 무엇을: 관리자 정산 API 중 페이징이 없던 `/admin/calculate/live`, `/admin/calculate/content-list`, `/admin/calculate/content-donation-list`에 `Pageable` 기반 페이징을 추가하고, 응답을 `totalCount + items` 구조로 변경했다. 또한 동일 쿼리를 사용하는 엑셀 다운로드 로직이 기존과 동일하게 전체 데이터를 내려주도록 totalCount 기반 전체 조회 방식으로 맞췄다. +- 왜: 조회 건수가 많아질 수 있는 정산 목록 API에서 페이지 단위 조회를 지원해 응답 크기와 조회 성능을 안정적으로 관리하기 위해서다. +- 어떻게: + - 정적 진단: `lsp_diagnostics`로 Kotlin 파일 진단을 시도했으나, 실행 환경에 Kotlin LSP가 설정되어 있지 않아 수행 불가(도구 에러 확인). + - 테스트: `./gradlew test` 실행, `BUILD SUCCESSFUL` 확인. + - 빌드: `./gradlew build -x test` 실행, `BUILD SUCCESSFUL` 확인.