Analytics Service 프론트엔드 연동을 위한 DTO 필드명 수정 및 증감 데이터 추가

- DTO 필드명 통일 (프론트엔드 호환)
  - totalParticipants → participants
  - channelName → channel
  - totalInvestment → totalCost

- 증감 데이터 필드 추가
  - participantsDelta: 참여자 증감 (현재 0, TODO)
  - targetRoi: 목표 ROI (EventStats에서 가져옴)

- EventStats 엔티티 스키마 변경
  - targetRoi 컬럼 추가 (BigDecimal, default: 0)

- Service 로직 수정
  - AnalyticsService: 필드명 변경 및 증감 데이터 적용
  - ROICalculator: totalCost 필드명 변경
  - UserAnalyticsService: 필드명 변경 및 증감 데이터 적용

- 검증 문서 추가
  - frontend-backend-validation.md: 수정 내용 및 다음 단계 정리

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

analytics-service/src/main/java/com/kt/event/analytics/dto/response/AnalyticsSummary.java

@@ -17,7 +17,12 @@ public class AnalyticsSummary {
     /**
      * 총 참여자 수
      */
-    private Integer totalParticipants;
+    private Integer participants;
+
+    /**
+     * 참여자 증감 (이전 기간 대비)
+     */
+    private Integer participantsDelta;
 
     /**
      * 총 조회수
@@ -44,6 +49,11 @@ public class AnalyticsSummary {
      */
     private Integer averageEngagementTime;
 
+    /**
+     * 목표 ROI (%)
+     */
+    private Double targetRoi;
+
     /**
      * SNS 반응 통계
      */

analytics-service/src/main/java/com/kt/event/analytics/dto/response/ChannelSummary.java

@@ -17,7 +17,7 @@ public class ChannelSummary {
     /**
      * 채널명
      */
-    private String channelName;
+    private String channel;
 
     /**
      * 조회수

analytics-service/src/main/java/com/kt/event/analytics/dto/response/RoiSummary.java

@@ -19,7 +19,7 @@ public class RoiSummary {
     /**
      * 총 투자 비용 (원)
      */
-    private BigDecimal totalInvestment;
+    private BigDecimal totalCost;
 
     /**
      * 예상 매출 증대 (원)

analytics-service/src/main/java/com/kt/event/analytics/entity/EventStats.java

@@ -63,6 +63,13 @@ public class EventStats extends BaseTimeEntity {
     @Builder.Default
     private BigDecimal estimatedRoi = BigDecimal.ZERO;
 
+    /**
+     * 목표 ROI (%)
+     */
+    @Column(precision = 10, scale = 2)
+    @Builder.Default
+    private BigDecimal targetRoi = BigDecimal.ZERO;
+
     /**
      * 매출 증가율 (%)
      */

analytics-service/src/main/java/com/kt/event/analytics/service/AnalyticsService.java

@@ -179,12 +179,14 @@ public class AnalyticsService {
             .build();
 
         return AnalyticsSummary.builder()
-            .totalParticipants(eventStats.getTotalParticipants())
+            .participants(eventStats.getTotalParticipants())
+            .participantsDelta(0) // TODO: 이전 기간 데이터와 비교하여 계산
             .totalViews(totalViews)
             .totalReach(totalReach)
             .engagementRate(Math.round(engagementRate * 10.0) / 10.0)
             .conversionRate(Math.round(conversionRate * 10.0) / 10.0)
             .averageEngagementTime(145) // 고정값 (실제로는 외부 API에서 가져와야 함)
+            .targetRoi(eventStats.getTargetRoi() != null ? eventStats.getTargetRoi().doubleValue() : null)
             .socialInteractions(socialStats)
             .build();
     }
@@ -202,7 +204,7 @@ public class AnalyticsService {
                 (stats.getParticipants() * 100.0 / stats.getDistributionCost().doubleValue()) : 0.0;
 
             summaries.add(ChannelSummary.builder()
-                .channelName(stats.getChannelName())
+                .channel(stats.getChannelName())
                 .views(stats.getViews())
                 .participants(stats.getParticipants())
                 .engagementRate(Math.round(engagementRate * 10.0) / 10.0)

analytics-service/src/main/java/com/kt/event/analytics/service/ROICalculator.java

@@ -192,7 +192,7 @@ public class ROICalculator {
         }
 
         return RoiSummary.builder()
-            .totalInvestment(eventStats.getTotalInvestment())
+            .totalCost(eventStats.getTotalInvestment())
             .expectedRevenue(eventStats.getExpectedRevenue())
             .netProfit(netProfit)
             .roi(roi)

analytics-service/src/main/java/com/kt/event/analytics/service/UserAnalyticsService.java

@@ -190,7 +190,8 @@ public class UserAnalyticsService {
         double avgConversionRate = totalParticipants > 0 ? (double) totalConversions / totalParticipants * 100 : 0.0;
 
         return AnalyticsSummary.builder()
-                .totalParticipants(totalParticipants)
+                .participants(totalParticipants)
+                .participantsDelta(0) // TODO: 이전 기간 데이터와 비교하여 계산
                 .totalViews(totalViews)
                 .engagementRate(Math.round(avgEngagementRate * 10) / 10.0)
                 .conversionRate(Math.round(avgConversionRate * 10) / 10.0)
@@ -231,7 +232,7 @@ public class UserAnalyticsService {
                             : 0.0;
 
                     return ChannelSummary.builder()
-                            .channelName(channelName)
+                            .channel(channelName)
                             .participants(participants)
                             .views(views)
                             .engagementRate(Math.round(engagementRate * 10) / 10.0)
@@ -263,7 +264,7 @@ public class UserAnalyticsService {
                 : 0.0;
 
         return RoiSummary.builder()
-                .totalInvestment(totalInvestment)
+                .totalCost(totalInvestment)
                 .expectedRevenue(totalExpectedRevenue)
                 .netProfit(totalProfit)
                 .roi(Math.round(roi * 10) / 10.0)
@@ -316,7 +317,8 @@ public class UserAnalyticsService {
      */
     private AnalyticsSummary buildEmptyAnalyticsSummary() {
         return AnalyticsSummary.builder()
-                .totalParticipants(0)
+                .participants(0)
+                .participantsDelta(0)
                 .totalViews(0)
                 .engagementRate(0.0)
                 .conversionRate(0.0)
@@ -328,7 +330,7 @@ public class UserAnalyticsService {
      */
     private RoiSummary buildEmptyRoiSummary() {
         return RoiSummary.builder()
-                .totalInvestment(BigDecimal.ZERO)
+                .totalCost(BigDecimal.ZERO)
                 .expectedRevenue(BigDecimal.ZERO)
                 .netProfit(BigDecimal.ZERO)
                 .roi(0.0)