feat: 대시보드 기능 개발

Author: HuitaePark

src/main/java/com/waitit/capstone/domain/dashboard/controller/DashboardController.java

@@ -0,0 +1,80 @@
+package com.waitit.capstone.domain.dashboard.controller;
+
+import com.waitit.capstone.domain.dashboard.dto.*;
+import com.waitit.capstone.domain.dashboard.service.DashboardService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+@RestController
+@RequestMapping("/api/v1")
+@RequiredArgsConstructor
+@Tag(name = "대시보드 API", description = "가게 대시보드 통계 및 관리 관련 API")
+public class DashboardController {
+
+    private final DashboardService dashboardService;
+
+    @GetMapping("/visitors/statistics")
+    @Operation(summary = "방문 고객 통계 조회", description = "기간별 신규/재방문 고객 비율 등 방문 통계를 조회합니다.")
+    // TODO: 로그인한 사용자가 자신의 가게 정보만 볼 수 있도록 보안 로직 추가 필요
+    public ResponseEntity<VisitorStatisticsResponse> getVisitorStatistics(
+            @RequestParam Long storeId,
+            @RequestParam String dateRange) {
+        VisitorStatisticsResponse stats = dashboardService.getVisitorStatistics(storeId, dateRange);
+        return ResponseEntity.ok(stats);
+    }
+
+    @GetMapping("/waiting/trends")
+    @Operation(summary = "대기인원 추세 및 예측 조회", description = "기간별 시간대 실제/예측 대기 인원 추세를 조회합니다.")
+    // TODO: 로그인한 사용자가 자신의 가게 정보만 볼 수 있도록 보안 로직 추가 필요
+    public ResponseEntity<WaitingTrendsResponse> getWaitingTrends(
+            @RequestParam Long storeId,
+            @RequestParam String dateRange) {
+        WaitingTrendsResponse trends = dashboardService.getWaitingTrends(storeId, dateRange);
+        return ResponseEntity.ok(trends);
+    }
+
+    @GetMapping("/reports/summary")
+    @Operation(summary = "리포트 분석 조회", description = "주간/월간 단위 방문자, 이탈률, 재방문률을 종합하여 조회합니다.")
+    // TODO: 로그인한 사용자가 자신의 가게 정보만 볼 수 있도록 보안 로직 추가 필요
+    public ResponseEntity<ReportSummaryResponse> getReportSummary(
+            @RequestParam Long storeId,
+            @RequestParam(defaultValue = "WEEKLY") String type) {
+        ReportSummaryResponse summary = dashboardService.getReportSummary(storeId, type);
+        return ResponseEntity.ok(summary);
+    }
+
+    @GetMapping("/reviews/statistics")
+    @Operation(summary = "리뷰 및 대기 취소 사유 조회", description = "기간별 대기 취소 사유 통계와 리뷰 목록을 조회합니다.")
+    // TODO: 로그인한 사용자가 자신의 가게 정보만 볼 수 있도록 보안 로직 추가 필요
+    public ResponseEntity<ReviewAndCancelStatsResponse> getReviewAndCancelStats(
+            @RequestParam Long storeId,
+            @RequestParam String dateRange,
+            @RequestParam(required = false) Integer ratingMin) {
+        ReviewAndCancelStatsResponse stats = dashboardService.getReviewAndCancelStats(storeId, dateRange, ratingMin);
+        return ResponseEntity.ok(stats);
+    }
+
+    @GetMapping("/promotions/events")
+    @Operation(summary = "프로모션/이벤트 목록 조회", description = "특정 가게의 모든 프로모션 및 기념일 목록을 조회합니다.")
+    // TODO: 로그인한 사용자가 자신의 가게 정보만 볼 수 있도록 보안 로직 추가 필요
+    public ResponseEntity<List<PromotionEventResponse>> getPromotionEvents(@RequestParam Long storeId) {
+        List<PromotionEventResponse> events = dashboardService.getPromotionEvents(storeId);
+        return ResponseEntity.ok(events);
+    }
+
+    @PostMapping("/promotions/events")
+    @Operation(summary = "프로모션/이벤트 생성", description = "새로운 프로모션 또는 기념일을 등록합니다.")
+    @PreAuthorize("hasRole('HOST') or hasRole('ADMIN')") // 자영업자 또는 관리자만 생성 가능
+    public ResponseEntity<Void> createPromotionEvent(@Valid @RequestBody CreatePromotionEventRequest request) {
+        dashboardService.createPromotionEvent(request);
+        return ResponseEntity.status(HttpStatus.CREATED).build();
+    }
+}

src/main/java/com/waitit/capstone/domain/dashboard/dto/CancelReasonStatsDto.java

@@ -0,0 +1,11 @@
+package com.waitit.capstone.domain.dashboard.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+@Getter
+@AllArgsConstructor
+public class CancelReasonStatsDto {
+    private String reason;
+    private Long count;
+}

src/main/java/com/waitit/capstone/domain/dashboard/dto/CreatePromotionEventRequest.java

@@ -0,0 +1,24 @@
+package com.waitit.capstone.domain.dashboard.dto;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import lombok.Getter;
+import lombok.Setter;
+
+import java.time.LocalDate;
+
+@Getter
+@Setter
+public class CreatePromotionEventRequest {
+
+    @NotNull(message = "가게 ID는 필수입니다.")
+    private Long storeId;
+
+    @NotBlank(message = "이벤트 제목은 필수입니다.")
+    private String title;
+
+    @NotNull(message = "시작일은 필수입니다.")
+    private LocalDate startDate;
+
+    private LocalDate endDate; // 종료일은 선택사항
+}

src/main/java/com/waitit/capstone/domain/dashboard/dto/HourlyWaitingStats.java

@@ -0,0 +1,11 @@
+package com.waitit.capstone.domain.dashboard.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+@Getter
+@AllArgsConstructor
+public class HourlyWaitingStats {
+    private Integer hour;
+    private Double averageQueueSize;
+}

src/main/java/com/waitit/capstone/domain/dashboard/dto/PromotionEventResponse.java

@@ -0,0 +1,27 @@
+package com.waitit.capstone.domain.dashboard.dto;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.waitit.capstone.domain.dashboard.entity.PromotionEvent;
+import lombok.Builder;
+import lombok.Getter;
+
+import java.time.format.DateTimeFormatter;
+
+@Getter
+@Builder
+@JsonInclude(JsonInclude.Include.NON_NULL) // end 필드가 null일 경우 JSON에서 제외
+public class PromotionEventResponse {
+
+    private String start;
+    private String end;
+    private String title;
+
+    public static PromotionEventResponse from(PromotionEvent event) {
+        DateTimeFormatter formatter = DateTimeFormatter.ISO_LOCAL_DATE; // yyyy-MM-dd 형식
+        return PromotionEventResponse.builder()
+                .title(event.getTitle())
+                .start(event.getStartDate().format(formatter))
+                .end(event.getEndDate() != null ? event.getEndDate().format(formatter) : null)
+                .build();
+    }
+}

src/main/java/com/waitit/capstone/domain/dashboard/dto/ReportSummaryData.java

@@ -0,0 +1,13 @@
+package com.waitit.capstone.domain.dashboard.dto;
+
+import lombok.Builder;
+import lombok.Getter;
+
+@Getter
+@Builder
+public class ReportSummaryData {
+    private String label;
+    private long visitors;
+    private double dropRate;
+    private double returnRate;
+}

src/main/java/com/waitit/capstone/domain/dashboard/dto/ReportSummaryResponse.java

@@ -0,0 +1,13 @@
+package com.waitit.capstone.domain.dashboard.dto;
+
+import lombok.Builder;
+import lombok.Getter;
+
+import java.util.List;
+
+@Getter
+@Builder
+public class ReportSummaryResponse {
+    private String periodType;
+    private List<ReportSummaryData> data;
+}

src/main/java/com/waitit/capstone/domain/dashboard/dto/ReviewAndCancelStatsResponse.java

@@ -0,0 +1,13 @@
+package com.waitit.capstone.domain.dashboard.dto;
+
+import lombok.Builder;
+import lombok.Getter;
+
+import java.util.List;
+
+@Getter
+@Builder
+public class ReviewAndCancelStatsResponse {
+    private List<CancelReasonStatsDto> cancelReasons;
+    private List<ReviewSummaryDto> reviews;
+}

src/main/java/com/waitit/capstone/domain/dashboard/dto/ReviewSummaryDto.java

@@ -0,0 +1,23 @@
+package com.waitit.capstone.domain.dashboard.dto;
+
+import com.waitit.capstone.domain.dashboard.entity.Review;
+import lombok.Builder;
+import lombok.Getter;
+
+import java.time.format.DateTimeFormatter;
+
+@Getter
+@Builder
+public class ReviewSummaryDto {
+    private String date;
+    private int rating;
+    private String comment;
+
+    public static ReviewSummaryDto from(Review review) {
+        return ReviewSummaryDto.builder()
+                .date(review.getCreatedAt().format(DateTimeFormatter.ISO_LOCAL_DATE))
+                .rating(review.getRating())
+                .comment(review.getComment())
+                .build();
+    }
+}

src/main/java/com/waitit/capstone/domain/dashboard/dto/VisitorStatisticsResponse.java

@@ -0,0 +1,13 @@
+package com.waitit.capstone.domain.dashboard.dto;
+
+import lombok.Builder;
+import lombok.Getter;
+
+@Getter
+@Builder
+public class VisitorStatisticsResponse {
+    private long totalVisitors;
+    private long newVisitors;
+    private long returningVisitors;
+    private double returnRate;
+}