25 lines
2.0 KiB
Markdown
25 lines
2.0 KiB
Markdown
# 에이전트 검색 기능 추가
|
|
|
|
## 작업 체크리스트
|
|
- [x] 관리자 에이전트 검색 관련 기존 controller/service/query/test 패턴을 확인한다.
|
|
- [x] 에이전트 검색 API 위치를 확정하고 요청/응답 형태를 정의한다.
|
|
- [x] 에이전트 닉네임 검색 동작을 검증하는 테스트를 먼저 추가한다.
|
|
- [x] 에이전트 닉네임으로 검색해 `memberId`를 식별할 수 있는 조회 기능을 구현한다.
|
|
- [x] 관련 진단/테스트/수동 QA를 수행하고 결과를 기록한다.
|
|
|
|
## 검증 기준
|
|
- 관리자 권한 진입점에서 검색 API가 노출되어야 한다.
|
|
- 검색어로 에이전트 닉네임을 조회했을 때 UI가 사용할 식별자(`memberId`)가 응답에 포함되어야 한다.
|
|
- 기존 관리자 에이전트 read 패키지의 응답/검색 패턴을 따른다.
|
|
|
|
## 검증 기록
|
|
- 1차 구현
|
|
- 무엇을: `admin.partner.agent.read` 패키지에 에이전트 닉네임 검색 API를 추가하고 관련 controller/service/query/test를 확장했다.
|
|
- 왜: 관리자 정산 비율 입력 시 memberId 직접 입력 대신 에이전트 검색 기반 선택을 지원하기 위해
|
|
- 어떻게:
|
|
- `./gradlew test --tests "kr.co.vividnext.sodalive.admin.partner.agent.read.AdminAgentReadControllerTest" --tests "kr.co.vividnext.sodalive.admin.partner.agent.read.AdminAgentReadServiceTest" --tests "kr.co.vividnext.sodalive.admin.partner.agent.read.AdminAgentReadQueryRepositoryTest" --tests "kr.co.vividnext.sodalive.admin.partner.agent.read.AdminAgentReadControllerSecurityTest"` → 성공
|
|
- `./gradlew build` → 성공
|
|
- `./gradlew test --tests "kr.co.vividnext.sodalive.admin.partner.agent.read.AdminAgentReadControllerSecurityTest.shouldAllowAdminRoleForAgentNicknameSearch" --info` → 성공
|
|
- 수동 QA 확인 응답: `{"success":true,"message":null,"data":[{"id":11,"nickname":"agent-a"}],"errorProperty":null}`
|
|
- 참고: Kotlin LSP가 환경에 구성되어 있지 않아 LSP 진단 대신 Gradle compile/test/build 결과로 검증했다.
|