[HCR-425] Hotfix/hsc 425

[bon0512]

📝작업 내용

관리자 통계 api 속도를 줄이기 위한 쿼리튜닝, 인덱스, 캐시 처리

👀변경 사항

기능 영역	파일	변경 내용
캐시 기능 활성화	build.gradle	spring-boot-starter-cache, caffeine 의존성 추가
캐시 기능 활성화	HolliverseApplication.java	@EnableCaching 추가
캐시 정책 설정	application.yaml	regional-metrics, regional-top-plans 캐시 spec 설정 추가
캐시 정책 설정	CacheConfig.java	Caffeine 캐시 매니저 구성 캐시 이름 상수 정의 CompositeCacheManager 구현
관리자 통계 캐시 적용	RetrieveRegionalMetricUseCase.java	@Cacheable(..., key = "#requestDto.yyyymm()", sync = true) 적용
관리자 통계 캐시 적용	RetrieveRegionalTopPlanUseCase.java	@Cacheable(..., sync = true) 적용
조회 쿼리 개선	AdminRegionalTopPlanDao.java	distinct → count(*) → row_number() 구조로 재작성

🎫 Jira Ticket

• Jira Ticket: HCR-425

#️⃣관련 이슈

• closes [HSC-425] 관리자 통계 캐시처리 #285

[gemini-code-assist]

Code Review

이번 풀 리퀘스트는 관리자 통계 기능을 위한 캐싱 인프라 구축과 AdminRegionalTopPlanDao의 쿼리 성능 개선을 포함하고 있습니다. Caffeine 캐시를 도입하여 지역별 지표 및 요금제 데이터를 캐싱하도록 설정하였으며, jOOQ 쿼리를 리팩토링하여 중복 제거 및 카운트 로직을 최적화했습니다. 다만, 새로운 설정 클래스의 등록 방식이 프로젝트 스타일 가이드를 위반하고 있으며, 불필요한 코드와 표준 라이브러리 미사용, 그리고 데이터 타입 불일치 문제가 발견되어 수정이 필요합니다.

[github-actions]

🧪 Test Coverage Report (JaCoCo)

기준(soft, workflow는 실패 안 함): Overall line 70% / branch 50%, Changed line 80% / branch 60% · Generated: 2026-04-03 18:05 UTC

Scope	Line	Branch	Line Graph	Branch Graph	Verdict
Overall	39.0%	28.2%	████████░░░░░░░░░░░░	██████░░░░░░░░░░░░░░	⚠️⚠️
Changed	5.0%	0.0%	█░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░	⚠️⚠️

Package line spark (sample): ▃▂▁▂▂▄▄·▇█▁▆▆▆·▆▁▂▆█▇▃▁▁▁██▁▁▃
Package branch spark (sample): ▃▁·▁▁·▁·▇··▅▆▅·▅▁▂▅▇▇▂▁·▁·█▁▁▁

📦 Package coverage (worst 10)

Rank	Package	Line	Branch	Lines	Line Graph	Branch Graph
1	site.holliverse.shared.monitoring	0.0%	N/A	125	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░
2	site.holliverse.customer.coupon.application	0.0%	0.0%	61	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░
3	site.holliverse.infra.kafka.consumer	0.0%	0.0%	44	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░
4	site.holliverse.customer.integration.fastapi	0.0%	0.0%	28	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░
5	site.holliverse.customer.application.usecase.counsel	0.0%	0.0%	14	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░
6	site.holliverse.customer.coupon.web	0.0%	0.0%	12	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░
7	site.holliverse.shared.config.runtime	0.0%	N/A	11	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░
8	site.holliverse.customer.web.util	0.0%	0.0%	8	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░
9	site.holliverse.auth.handler	0.0%	N/A	8	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░
10	site.holliverse.admin.domain.model.churn.feature	0.0%	N/A	8	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░

🧨 Lowest coverage classes (worst 10)

Rank	Class	Line	Branch	Lines	Line Graph	Branch Graph
1	site.holliverse.shared.monitoring.CustomerMetrics	0.0%	N/A	98	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░
2	site.holliverse.customer.application.usecase.log.UserLogService	0.0%	0.0%	62	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░
3	site.holliverse.infra.kafka.consumer.RecommendationKafkaConsumer	0.0%	0.0%	44	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░
4	site.holliverse.customer.application.usecase.recommendation.RecommendationKafkaConsumeUseCase	0.0%	0.0%	42	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░
5	site.holliverse.admin.application.usecase.CalculateLogChurnScoreService	0.0%	0.0%	38	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░
6	site.holliverse.admin.application.usecase.CalculateChurnScoreService	0.0%	0.0%	37	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░
7	site.holliverse.customer.coupon.application.UseMemberCouponUseCase	0.0%	0.0%	34	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░
8	site.holliverse.admin.application.usecase.ChurnRiskReason$ReasonCode	0.0%	0.0%	31	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░
9	site.holliverse.customer.integration.fastapi.FastApiRecommendationClient	0.0%	0.0%	28	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░
10	site.holliverse.shared.monitoring.CustomerMonitoringBinder	0.0%	N/A	27	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░

🧩 Changed files coverage breakdown (5 files)

File	Line	Branch	Lines	Verdict	Line Graph	Branch Graph
src/main/java/site/holliverse/admin/application/usecase/RetrieveRegionalTopPlanUseCase.java	0.0%	0.0%	19	⚠️⚠️	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░
src/main/java/site/holliverse/admin/application/usecase/RetrieveRegionalMetricUseCase.java	100.0%	N/A	1	✅✅	████████████████████	░░░░░░░░░░░░░░░░░░░░
src/main/java/site/holliverse/HolliverseApplication.java	N/A	N/A	0	✅✅	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░
src/main/java/site/holliverse/admin/query/dao/AdminRegionalTopPlanDao.java	N/A	N/A	0	✅✅	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░
src/main/java/site/holliverse/shared/config/cache/CacheConfig.java	N/A	N/A	0	✅✅	░░░░░░░░░░░░░░░░░░░░	░░░░░░░░░░░░░░░░░░░░

---

🔎 HTML 리포트: Actions → Artifacts → jacoco-html · XML: jacoco-xml