sodalive-backend-spring-boot/docs/20260413_에이전트크리에이터소속시간UTC변환.md

작업 개요

• AdminAgentCreatorService의 소속 등록 시 assignedAt 입력값을 한국 시간에서 UTC로 변환해 저장한다.
• AdminAgentCreatorService의 소속 해제 시 unassignedAt 입력값을 한국 시간에서 UTC로 변환해 검증 후 저장한다.
• AdminAgentCreatorServiceTest에 한국 시간 입력이 UTC로 저장되는 회귀 테스트를 추가한다.
• 변경 파일 진단과 Gradle 검증(test, ktlintCheck)을 수행하고 결과를 기록한다.
• LocalDateTimeExtensions에 타임존 입력 기반 UTC 변환 확장함수를 추가하고 기본 타임존을 KST로 둔다.
• AdminAgentCreatorService의 시간 변환을 확장함수 호출로 리팩터링한다.
• 확장함수 테스트와 관련 서비스 테스트를 다시 검증하고 기록한다.

---

검증 기록

1차 구현

• 무엇을: 관리자 에이전트-크리에이터 소속 등록/해제 시각의 UTC 저장 정합성 보정.
• 왜: 요청 시각은 한국 시간 기준인데 현재 DB에는 변환 없이 그대로 저장되어 실제 저장 기준과 맞지 않음.
• 어떻게:
  • AdminAgentCreatorServiceTest에 등록 저장값 UTC 변환, 해제 저장값 UTC 변환, 해제 시각 비교 UTC 기준 검증 테스트를 추가했다.
  • AdminAgentCreatorService에서 assignedAt/unassignedAt를 저장 및 비교 전에 Asia/Seoul -> UTC로 변환하도록 수정했다.
  • lsp_diagnostics 실행: .kt 확장자용 LSP 서버 미설정으로 도구 진단 불가.
  • ./gradlew test --tests "kr.co.vividnext.sodalive.admin.partner.agent.assignment.AdminAgentCreatorServiceTest" 실행: 성공(BUILD SUCCESSFUL).
  • ./gradlew ktlintCheck 실행: 성공(BUILD SUCCESSFUL).

2차 수정

• 무엇을: Asia/Seoul -> UTC 변환 책임을 LocalDateTime 확장함수로 이동하고 서비스는 그 확장함수를 사용하도록 리팩터링.
• 왜: 서비스 레이어의 타임존 변환 중복을 줄이고, 동일한 변환 규칙을 재사용 가능한 확장함수로 통일하기 위함.
• 어떻게:
  • LocalDateTimeExtensionsTest에 기본 KST 변환과 사용자 지정 타임존 변환 테스트를 먼저 추가했고, 확장함수 부재 상태에서 실패함을 확인했다.
  • LocalDateTimeExtensions에 convertToUtc(timeZone: ZoneId = Asia/Seoul) 확장함수를 추가했다.
  • AdminAgentCreatorService는 내부 변환 함수를 제거하고 request.assignedAt.convertToUtc() / request.unassignedAt.convertToUtc()를 사용하도록 수정했다.
  • ./gradlew test --tests "kr.co.vividnext.sodalive.extensions.LocalDateTimeExtensionsTest" --tests "kr.co.vividnext.sodalive.admin.partner.agent.assignment.AdminAgentCreatorServiceTest" 실행: 성공(BUILD SUCCESSFUL).
  • ./gradlew ktlintCheck 실행: 성공(BUILD SUCCESSFUL).