✨ [Feat] 어드민 페이지 API, 방문자 로그 스케쥴러, 몽고DB 의존성 추가

build.gradle

@@ -59,6 +59,8 @@ dependencies {
     implementation 'org.springframework.boot:spring-boot-starter-mail'
     implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
 
+    // MongoDB
+    implementation 'org.springframework.boot:spring-boot-starter-data-mongodb'
 
     // test
     testImplementation 'org.springframework.boot:spring-boot-starter-test'

src/main/java/org/withtime/be/withtimebe/WithTimeBeApplication.java

@@ -1,15 +1,31 @@
 package org.withtime.be.withtimebe;
 
+import java.util.TimeZone;
+
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.context.annotation.ComponentScan;
+import org.springframework.context.annotation.FilterType;
 import org.springframework.data.jpa.repository.config.EnableJpaAuditing;
+import org.springframework.data.jpa.repository.config.EnableJpaRepositories;
+import org.springframework.data.mongodb.repository.config.EnableMongoRepositories;
+import org.springframework.scheduling.annotation.EnableScheduling;
+import org.withtime.be.withtimebe.domain.log.repository.VisitLogRepository;
+
+import jakarta.annotation.PostConstruct;
 
+@EnableScheduling
 @EnableJpaAuditing
+@EnableJpaRepositories(basePackages = {"org.withtime.be"}, excludeFilters = {
+    @ComponentScan.Filter(type = FilterType.ASSIGNABLE_TYPE, classes = VisitLogRepository.class)})
+@EnableMongoRepositories(basePackageClasses = VisitLogRepository.class)
 @SpringBootApplication
 public class WithTimeBeApplication {
 
     public static void main(String[] args) {
         SpringApplication.run(WithTimeBeApplication.class, args);
     }
 
+    @PostConstruct
+    public void init() { TimeZone.setDefault(TimeZone.getTimeZone("Asia/Seoul")); } // JVM 기본 TimeZone 설정
 }

src/main/java/org/withtime/be/withtimebe/domain/date/entity/BusinessTime.java

@@ -3,6 +3,7 @@
 import jakarta.persistence.*;
 import lombok.*;
 import org.withtime.be.withtimebe.domain.date.entity.enums.Day;
+import org.withtime.be.withtimebe.domain.dateplace.entity.DatePlace;
 import org.withtime.be.withtimebe.global.common.BaseEntity;
 
 import java.time.LocalTime;

src/main/java/org/withtime/be/withtimebe/domain/date/entity/DatePlaceDateCourse.java

@@ -2,6 +2,8 @@
 
 import jakarta.persistence.*;
 import lombok.*;
+
+import org.withtime.be.withtimebe.domain.dateplace.entity.DatePlace;
 import org.withtime.be.withtimebe.global.common.BaseEntity;
 
 @Entity

src/main/java/org/withtime/be/withtimebe/domain/date/entity/DatePlacePlaceCategory.java

@@ -3,6 +3,7 @@
 import jakarta.persistence.*;
 import lombok.*;
 
+import org.withtime.be.withtimebe.domain.dateplace.entity.DatePlace;
 import org.withtime.be.withtimebe.global.common.BaseEntity;
 
 @Entity

src/main/java/org/withtime/be/withtimebe/domain/date/entity/Item.java

@@ -2,6 +2,8 @@
 
 import jakarta.persistence.*;
 import lombok.*;
+
+import org.withtime.be.withtimebe.domain.dateplace.entity.DatePlace;
 import org.withtime.be.withtimebe.global.common.BaseEntity;
 
 @Entity

src/main/java/org/withtime/be/withtimebe/domain/dateplace/controller/DatePlaceQueryController.java

@@ -0,0 +1,41 @@
+package org.withtime.be.withtimebe.domain.dateplace.controller;
+
+import org.namul.api.payload.response.DefaultResponse;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.web.PageableDefault;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+import org.withtime.be.withtimebe.domain.dateplace.converter.DatePlaceConverter;
+import org.withtime.be.withtimebe.domain.dateplace.dto.response.DatePlaceResponseDTO;
+import org.withtime.be.withtimebe.domain.dateplace.entity.DatePlace;
+import org.withtime.be.withtimebe.domain.dateplace.service.query.DatePlaceQueryService;
+import org.withtime.be.withtimebe.global.annotation.SwaggerPageable;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import lombok.RequiredArgsConstructor;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/api/v1/dateplaces")
+public class DatePlaceQueryController {
+
+	private final DatePlaceQueryService datePlaceQueryService;
+
+	@Operation(summary = "어드민 페이지 데이트 장소 조회 API by 피우 [Only Admin]", description = "어드민 페이지에서 데이트 장소를 조회하는 API입니다. 어드민만 사용 가능합니다.")
+	@ApiResponses(value = {
+		@ApiResponse(responseCode = "200", description = "성공입니다.")
+	})
+	@SwaggerPageable
+	@GetMapping("/management")
+	public DefaultResponse<DatePlaceResponseDTO.DatePlaceManagementList> findDatePlaceManagement(
+		@PageableDefault(page = 0, size = 10) Pageable pageable
+	) {
+		Page<DatePlace> result = datePlaceQueryService.findDatePlaces(pageable);
+		DatePlaceResponseDTO.DatePlaceManagementList response = DatePlaceConverter.toDatePlaceManagementList(result);
+		return DefaultResponse.ok(response);
+	}
+}

src/main/java/org/withtime/be/withtimebe/domain/dateplace/converter/DatePlaceConverter.java

@@ -0,0 +1,52 @@
+package org.withtime.be.withtimebe.domain.dateplace.converter;
+
+import java.util.List;
+
+import org.springframework.data.domain.Page;
+import org.withtime.be.withtimebe.domain.date.entity.PlaceCategory;
+import org.withtime.be.withtimebe.domain.dateplace.dto.response.DatePlaceResponseDTO;
+import org.withtime.be.withtimebe.domain.dateplace.entity.DatePlace;
+
+public class DatePlaceConverter {
+
+	public static DatePlaceResponseDTO.DatePlaceManagementList toDatePlaceManagementList(Page<DatePlace> datePlacePage) {
+
+		List<DatePlaceResponseDTO.DatePlaceManagement> datePlaceManagementList = datePlacePage.stream()
+			.map(DatePlaceConverter::toDatePlaceManagement)
+			.toList();
+
+		return DatePlaceResponseDTO.DatePlaceManagementList.builder()
+			.datePlaceManagementList(datePlaceManagementList)
+			.totalPages(datePlacePage.getTotalPages())
+			.currentPage(datePlacePage.getNumber())
+			.currentSize(datePlacePage.getNumberOfElements())
+			.hasNextPage(datePlacePage.hasNext())
+			.build();
+	}
+
+	public static DatePlaceResponseDTO.DatePlaceManagement toDatePlaceManagement(DatePlace datePlace) {
+
+		List<DatePlaceResponseDTO.PlaceCategory> placeCategoryList = datePlace.getDatePlacePlaceCategoryList().stream()
+			.map(datePlacePlaceCategory -> toPlaceCategory(datePlacePlaceCategory.getPlaceCategory()))
+			.toList();
+
+		return DatePlaceResponseDTO.DatePlaceManagement.builder()
+			.datePlaceId(datePlace.getId())
+			.name(datePlace.getName())
+			.tel(datePlace.getTel())
+			.averagePrice(datePlace.getAveragePrice())
+			.lotNumberAddress(datePlace.getLotNumberAddress())
+			.placeType(datePlace.getPlaceType().getLabel())
+			.placeCategoryList(placeCategoryList)
+			.build();
+	}
+
+	public static DatePlaceResponseDTO.PlaceCategory toPlaceCategory(PlaceCategory placeCategory) {
+
+		return DatePlaceResponseDTO.PlaceCategory.builder()
+			.placeCategoryId(placeCategory.getId())
+			.placeCategoryType(placeCategory.getCategoryType().name())
+			.label(placeCategory.getLabel())
+			.build();
+	}
+}

src/main/java/org/withtime/be/withtimebe/domain/dateplace/dto/response/DatePlaceResponseDTO.java

@@ -0,0 +1,35 @@
+package org.withtime.be.withtimebe.domain.dateplace.dto.response;
+
+import java.util.List;
+
+import lombok.Builder;
+
+public class DatePlaceResponseDTO {
+
+	@Builder
+	public record DatePlaceManagementList(
+		List<DatePlaceManagement> datePlaceManagementList,
+		Integer totalPages,	// 전체 페이지 개수
+		Integer currentPage,	// 현재 페이지 번호
+		Integer currentSize,	// 현재 페이지의 크기
+		Boolean hasNextPage	// 다음 페이지 존재 여부
+	) {}
+
+	@Builder
+	public record DatePlaceManagement(
+		Long datePlaceId,	// 데이트 장소 식별자 값
+		String name,	// 장소 이름
+		String tel,		// 전화 번호
+		Integer averagePrice,	// 평균 가격
+		String lotNumberAddress,	// 지번 주소
+		String placeType,	// 장소 유형
+		List<PlaceCategory> placeCategoryList	// 카테고리 목록
+	) {}
+
+	@Builder
+	public record PlaceCategory(
+		Long placeCategoryId,
+		String placeCategoryType,
+		String label
+	) {}
+}

src/main/java/org/withtime/be/withtimebe/domain/date/entity/DatePlace.java → src/main/java/org/withtime/be/withtimebe/domain/dateplace/entity/DatePlace.java

@@ -1,9 +1,15 @@
-package org.withtime.be.withtimebe.domain.date.entity;
+package org.withtime.be.withtimebe.domain.dateplace.entity;
+
+import java.util.ArrayList;
+import java.util.List;
 
 import jakarta.persistence.*;
 import lombok.*;
 
-import org.withtime.be.withtimebe.domain.date.entity.enums.PlaceType;
+import org.hibernate.annotations.BatchSize;
+import org.withtime.be.withtimebe.domain.date.entity.DatePlacePlaceCategory;
+import org.withtime.be.withtimebe.domain.date.entity.PlaceCategory;
+import org.withtime.be.withtimebe.domain.dateplace.entity.enums.PlaceType;
 import org.withtime.be.withtimebe.global.common.BaseEntity;
 
 @Entity
@@ -49,4 +55,9 @@ public class DatePlace extends BaseEntity {
     @Enumerated(EnumType.STRING)
     @Column(name = "place_type")
     private PlaceType placeType;
+
+    @OneToMany(mappedBy = "datePlace")
+    @BatchSize(size = 10)
+    @Builder.Default
+    private List<DatePlacePlaceCategory> datePlacePlaceCategoryList = new ArrayList<>();
 }

src/main/java/org/withtime/be/withtimebe/domain/date/entity/enums/PlaceType.java → src/main/java/org/withtime/be/withtimebe/domain/dateplace/entity/enums/PlaceType.java

@@ -1,4 +1,4 @@
-package org.withtime.be.withtimebe.domain.date.entity.enums;
+package org.withtime.be.withtimebe.domain.dateplace.entity.enums;
 
 import lombok.AllArgsConstructor;
 import lombok.Getter;

src/main/java/org/withtime/be/withtimebe/domain/dateplace/repository/DatePlaceRepository.java

@@ -0,0 +1,7 @@
+package org.withtime.be.withtimebe.domain.dateplace.repository;
+
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.withtime.be.withtimebe.domain.dateplace.entity.DatePlace;
+
+public interface DatePlaceRepository extends JpaRepository<DatePlace, Long> {
+}

src/main/java/org/withtime/be/withtimebe/domain/dateplace/service/query/DatePlaceQueryService.java

@@ -0,0 +1,9 @@
+package org.withtime.be.withtimebe.domain.dateplace.service.query;
+
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.withtime.be.withtimebe.domain.dateplace.entity.DatePlace;
+
+public interface DatePlaceQueryService {
+	Page<DatePlace> findDatePlaces(Pageable pageable);
+}

src/main/java/org/withtime/be/withtimebe/domain/dateplace/service/query/DatePlaceQueryServiceImpl.java

@@ -0,0 +1,24 @@
+package org.withtime.be.withtimebe.domain.dateplace.service.query;
+
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import org.withtime.be.withtimebe.domain.dateplace.entity.DatePlace;
+import org.withtime.be.withtimebe.domain.dateplace.repository.DatePlaceRepository;
+
+import lombok.RequiredArgsConstructor;
+
+@Service
+@RequiredArgsConstructor
+@Transactional(readOnly = true)
+public class DatePlaceQueryServiceImpl implements DatePlaceQueryService {
+
+	private final DatePlaceRepository datePlaceRepository;
+
+	@Override
+	public Page<DatePlace> findDatePlaces(Pageable pageable) {
+		return datePlaceRepository.findAll(pageable);
+	}
+}

src/main/java/org/withtime/be/withtimebe/domain/log/controller/query/VisitLogQueryController.java

@@ -0,0 +1,54 @@
+package org.withtime.be.withtimebe.domain.log.controller.query;
+
+import java.time.LocalDate;
+import java.util.List;
+
+import org.namul.api.payload.response.DefaultResponse;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+import org.withtime.be.withtimebe.domain.log.converter.VisitLogConverter;
+import org.withtime.be.withtimebe.domain.log.dto.response.VisitLogResponseDTO;
+import org.withtime.be.withtimebe.domain.log.model.VisitLog;
+import org.withtime.be.withtimebe.domain.log.service.query.VisitLogQueryService;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import lombok.RequiredArgsConstructor;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/api/v1/visit-logs")
+public class VisitLogQueryController {
+
+	private final VisitLogQueryService visitLogQueryService;
+
+	@Operation(summary = "최근 일주일 간 일별 방문자 수 조회 API by 피우 [Only Admin]", description = "일주일 간 일별 방문자 수 조회 API입니다. 어드민만 사용 가능합니다.")
+	@ApiResponses(value = {
+		@ApiResponse(responseCode = "200", description = "성공입니다.")
+	})
+	@GetMapping("/daily")
+	public DefaultResponse<VisitLogResponseDTO.DailyVisitLogList> findDailyVisitLogList() {
+		List<VisitLog> result = visitLogQueryService.findDailyVisitLogList();
+		VisitLogResponseDTO.DailyVisitLogList response = VisitLogConverter.toDailyVisitLogList(result);
+		return DefaultResponse.ok(response);
+	}
+
+	@Operation(summary = "하루동안 시간대 별 방문자 수 추이 조회 API by 피우 [Only Admin]", description = "하루동안 시간대 별 방문자 수 추이 조회 API 입니다. 어드민만 사용 가능합니다.")
+	@ApiResponses(value = {
+		@ApiResponse(responseCode = "200", description = "성공입니다.")
+	})
+	@Parameter(name = "date", description = "예) 2025-01-01")
+	@GetMapping("/hourly")
+	public DefaultResponse<VisitLogResponseDTO.HourlyVisitLogList> findHourlyVisitLog(
+		@RequestParam("date") LocalDate date
+	) {
+		List<VisitLog> result = visitLogQueryService.findHourlyVisitLogList(date);
+		VisitLogResponseDTO.HourlyVisitLogList response = VisitLogConverter.toHourlyVisitLogList(date, result);
+		return DefaultResponse.ok(response);
+	}
+
+}

src/main/java/org/withtime/be/withtimebe/domain/log/converter/VisitLogConverter.java

@@ -0,0 +1,57 @@
+package org.withtime.be.withtimebe.domain.log.converter;
+
+import java.time.LocalDate;
+import java.util.Comparator;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+import org.withtime.be.withtimebe.domain.log.dto.response.VisitLogResponseDTO;
+import org.withtime.be.withtimebe.domain.log.model.VisitLog;
+
+public class VisitLogConverter {
+
+	public static VisitLogResponseDTO.DailyVisitLogList toDailyVisitLogList(List<VisitLog> visitLogList) {
+
+		Map<LocalDate, Long> result = visitLogList.stream()
+			.collect(Collectors.groupingBy(VisitLog::getDate, Collectors.summingLong(VisitLog::getCount)));
+
+		List<VisitLogResponseDTO.DailyVisitLog> dailyVisitLogList = result.entrySet().stream()
+			.sorted(Map.Entry.comparingByKey())
+			.map(entry -> toDailyVisitLog(entry.getKey(), entry.getValue()))
+			.toList();
+
+		return VisitLogResponseDTO.DailyVisitLogList.builder()
+			.dailyVisitLogList(dailyVisitLogList)
+			.build();
+	}
+
+	public static VisitLogResponseDTO.DailyVisitLog toDailyVisitLog(LocalDate localDate, Long totalCount) {
+
+		return VisitLogResponseDTO.DailyVisitLog.builder()
+			.date(localDate)
+			.count(totalCount)
+			.build();
+	}
+
+	public static VisitLogResponseDTO.HourlyVisitLogList toHourlyVisitLogList(LocalDate date, List<VisitLog> visitLogList) {
+
+		List<VisitLogResponseDTO.HourlyVisitLog> hourlyVisitLogList = visitLogList.stream()
+			.sorted(Comparator.comparing(VisitLog::getHour))
+			.map(VisitLogConverter::toHourlyVisitLog)
+			.toList();
+
+		return VisitLogResponseDTO.HourlyVisitLogList.builder()
+			.date(date)
+			.hourlyVisitLogList(hourlyVisitLogList)
+			.build();
+	}
+
+	public static VisitLogResponseDTO.HourlyVisitLog toHourlyVisitLog(VisitLog visitLog) {
+
+		return VisitLogResponseDTO.HourlyVisitLog.builder()
+			.hour(visitLog.getHour())
+			.count(visitLog.getCount())
+			.build();
+	}
+}