Files
sodalive-backend-spring-boot/docs/20260415_에이전트정산기본비율7퍼센트변경.md

1.9 KiB

에이전트 정산 기본 비율 7퍼센트 변경 계획

  • AgentCalculateQueryRepository의 agent settlement fallback 10 적용 지점을 확인하고 7로 변경한다.
  • Kotlin 응답 계산 모델의 agent settlement fallback 10 상수를 7로 변경해 DB 집계와 계산 로직을 일치시킨다.
  • 기본 fallback 10을 전제한 관련 테스트 기대값을 7 기준으로 수정한다.
  • 관련 테스트와 진단을 실행하고 결과를 문서 하단 검증 기록에 누적한다.

검증 기록

  • 1차 구현
    • 무엇을: 에이전트 정산 비율 미설정 시 적용되는 기본 fallback 값을 10%에서 7%로 변경했다. AgentCalculateQueryRepository의 native SQL COALESCE(asr.settlement_ratio, ...)와 Kotlin 계산 모델 두 곳의 DEFAULT_AGENT_SETTLEMENT_RATIO를 함께 조정하고, 관련 테스트 기대값을 7% 기준으로 갱신했다.
    • 왜: 현재 에이전트 정산 기본 비율 정책이 10%가 아니라 7%여야 하므로, DB 집계 결과와 Kotlin 응답 계산 결과가 동일한 기본값을 사용하도록 맞춰야 한다.
    • 어떻게:
      • ./gradlew test --tests kr.co.vividnext.sodalive.partner.agent.calculate.AgentCalculateServiceTest --tests kr.co.vividnext.sodalive.partner.agent.calculate.AgentCalculateQueryRepositoryTest → 실패. 7% 기준으로 먼저 바꾼 테스트가 기존 10% fallback 구현 때문에 깨지는 것을 확인했다.
      • ./gradlew test --tests kr.co.vividnext.sodalive.partner.agent.calculate.AgentCalculateServiceTest --tests kr.co.vividnext.sodalive.partner.agent.calculate.AgentCalculateQueryRepositoryTest --tests kr.co.vividnext.sodalive.admin.partner.agent.read.AdminAgentReadCurrentMonthListSummaryTest → 성공.
      • ./gradlew ktlintCheck → 성공.
      • ./gradlew build → 성공.
      • src/main/kotlin에서 COALESCE(asr.settlement_ratio, 10)DEFAULT_AGENT_SETTLEMENT_RATIO = 10 검색 → 미검출.