package com.kt.event.analytics.controller;

import com.kt.event.analytics.dto.response.UserAnalyticsDashboardResponse;
import com.kt.event.analytics.service.UserAnalyticsService;
import com.kt.event.common.dto.ApiResponse;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.v3.oas.annotations.tags.Tag;
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.format.annotation.DateTimeFormat;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;

import java.time.LocalDateTime;

/**
 * User Analytics Dashboard Controller
 *
 * 사용자 전체 이벤트 통합 성과 대시보드 API
 */
@Tag(name = "User Analytics", description = "사용자 전체 이벤트 통합 성과 분석 API")
@Slf4j
@RestController
@RequestMapping("/api/v1/users")
@RequiredArgsConstructor
public class UserAnalyticsDashboardController {

    private final UserAnalyticsService userAnalyticsService;

    /**
     * 사용자 전체 성과 대시보드 조회
     *
     * @param userId    사용자 ID
     * @param startDate 조회 시작 날짜
     * @param endDate   조회 종료 날짜
     * @param refresh   캐시 갱신 여부
     * @return 전체 통합 성과 대시보드
     */
    @Operation(
        summary = "사용자 전체 성과 대시보드 조회",
        description = "사용자의 모든 이벤트 성과를 통합하여 조회합니다."
    )
    @GetMapping("/{userId}/analytics")
    public ResponseEntity<ApiResponse<UserAnalyticsDashboardResponse>> getUserAnalytics(
        @Parameter(description = "사용자 ID", required = true)
        @PathVariable String userId,

        @Parameter(description = "조회 시작 날짜 (ISO 8601 format)")
        @RequestParam(required = false)
        @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME)
        LocalDateTime startDate,

        @Parameter(description = "조회 종료 날짜 (ISO 8601 format)")
        @RequestParam(required = false)
        @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME)
        LocalDateTime endDate,

        @Parameter(description = "캐시 갱신 여부")
        @RequestParam(required = false, defaultValue = "false")
        Boolean refresh
    ) {
        log.info("사용자 전체 성과 대시보드 조회 API 호출: userId={}, refresh={}", userId, refresh);

        UserAnalyticsDashboardResponse response = userAnalyticsService.getUserDashboardData(
            userId, startDate, endDate, refresh
        );

        return ResponseEntity.ok(ApiResponse.success(response));
    }
}
