package com.kt.event.analytics.controller;

import com.kt.event.analytics.dto.response.UserTimelineAnalyticsResponse;
import com.kt.event.analytics.service.UserTimelineAnalyticsService;
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;
import java.util.Arrays;
import java.util.List;

/**
 * User Timeline Analytics Controller
 */
@Tag(name = "User Timeline", description = "사용자 전체 이벤트 시간대별 분석 API")
@Slf4j
@RestController
@RequestMapping("/users")
@RequiredArgsConstructor
public class UserTimelineAnalyticsController {

    private final UserTimelineAnalyticsService userTimelineAnalyticsService;

    @Operation(
        summary = "사용자 전체 시간대별 참여 추이",
        description = "사용자의 모든 이벤트 시간대별 데이터를 통합하여 분석합니다. (userId 기반 전체 이벤트 조회)"
    )
    @GetMapping("/{userId}/analytics/timeline")
    public ResponseEntity<ApiResponse<UserTimelineAnalyticsResponse>> getUserTimelineAnalytics(
        @Parameter(description = "사용자 ID", required = true)
        @PathVariable String userId,

        @Parameter(description = "시간 간격 단위 (hourly, daily, weekly, monthly)")
        @RequestParam(required = false, defaultValue = "daily")
        String interval,

        @Parameter(description = "조회할 지표 목록 (쉼표로 구분)")
        @RequestParam(required = false)
        String metrics,

        @Parameter(description = "캐시 갱신 여부")
        @RequestParam(required = false, defaultValue = "false")
        Boolean refresh
    ) {
        log.info("사용자 타임라인 분석 API 호출: userId={}, interval={}", userId, interval);

        List<String> metricList = metrics != null && !metrics.isBlank()
            ? Arrays.asList(metrics.split(","))
            : null;

        UserTimelineAnalyticsResponse response = userTimelineAnalyticsService.getUserTimelineAnalytics(
            userId, interval, metricList, refresh
        );

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