2.0 KiB
2.0 KiB
에이전트 검색 기능 추가
작업 체크리스트
- 관리자 에이전트 검색 관련 기존 controller/service/query/test 패턴을 확인한다.
- 에이전트 검색 API 위치를 확정하고 요청/응답 형태를 정의한다.
- 에이전트 닉네임 검색 동작을 검증하는 테스트를 먼저 추가한다.
- 에이전트 닉네임으로 검색해
memberId를 식별할 수 있는 조회 기능을 구현한다. - 관련 진단/테스트/수동 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 결과로 검증했다.
- 무엇을: