feat: 행사 API 추가

src/main/java/gg/agit/konect/domain/event/controller/EventApi.java

@@ -0,0 +1,75 @@
+package gg.agit.konect.domain.event.controller;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+
+import gg.agit.konect.domain.event.dto.EventBoothMapResponse;
+import gg.agit.konect.domain.event.dto.EventBoothsResponse;
+import gg.agit.konect.domain.event.dto.EventContentsResponse;
+import gg.agit.konect.domain.event.dto.EventHomeResponse;
+import gg.agit.konect.domain.event.dto.EventMiniEventsResponse;
+import gg.agit.konect.domain.event.dto.EventProgramsResponse;
+import gg.agit.konect.domain.event.enums.EventProgramType;
+import gg.agit.konect.global.auth.annotation.UserId;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.constraints.Min;
+
+@Tag(name = "(Normal) Event: 행사", description = "행사 API")
+@RequestMapping("/events")
+public interface EventApi {
+
+    @Operation(summary = "행사 홈 정보를 조회한다.")
+    @GetMapping("/{eventId}/home")
+    ResponseEntity<EventHomeResponse> getEventHome(
+        @PathVariable Integer eventId,
+        @UserId Integer userId
+    );
+
+    @Operation(summary = "행사 프로그램 목록을 조회한다.")
+    @GetMapping("/{eventId}/programs")
+    ResponseEntity<EventProgramsResponse> getEventPrograms(
+        @PathVariable Integer eventId,
+        @RequestParam(defaultValue = "ALL") EventProgramType type,
+        @RequestParam(defaultValue = "1") @Min(1) Integer page,
+        @RequestParam(defaultValue = "20") @Min(1) Integer limit,
+        @UserId Integer userId
+    );
+
+    @Operation(summary = "행사 부스 목록을 조회한다.")
+    @GetMapping("/{eventId}/booths")
+    ResponseEntity<EventBoothsResponse> getEventBooths(
+        @PathVariable Integer eventId,
+        @RequestParam(required = false) String category,
+        @RequestParam(required = false) String keyword,
+        @RequestParam(defaultValue = "1") @Min(1) Integer page,
+        @RequestParam(defaultValue = "20") @Min(1) Integer limit
+    );
+
+    @Operation(summary = "행사 부스 맵을 조회한다.")
+    @GetMapping("/{eventId}/booth-map")
+    ResponseEntity<EventBoothMapResponse> getEventBoothMap(
+        @PathVariable Integer eventId
+    );
+
+    @Operation(summary = "행사 미니 이벤트 목록을 조회한다.")
+    @GetMapping("/{eventId}/mini-events")
+    ResponseEntity<EventMiniEventsResponse> getEventMiniEvents(
+        @PathVariable Integer eventId,
+        @RequestParam(defaultValue = "1") @Min(1) Integer page,
+        @RequestParam(defaultValue = "20") @Min(1) Integer limit,
+        @UserId Integer userId
+    );
+
+    @Operation(summary = "행사 콘텐츠 목록을 조회한다.")
+    @GetMapping("/{eventId}/contents")
+    ResponseEntity<EventContentsResponse> getEventContents(
+        @PathVariable Integer eventId,
+        @RequestParam(required = false) String category,
+        @RequestParam(defaultValue = "1") @Min(1) Integer page,
+        @RequestParam(defaultValue = "20") @Min(1) Integer limit
+    );
+}

src/main/java/gg/agit/konect/domain/event/controller/EventController.java

@@ -0,0 +1,58 @@
+package gg.agit.konect.domain.event.controller;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.RestController;
+
+import gg.agit.konect.domain.event.dto.EventBoothMapResponse;
+import gg.agit.konect.domain.event.dto.EventBoothsResponse;
+import gg.agit.konect.domain.event.dto.EventContentsResponse;
+import gg.agit.konect.domain.event.dto.EventHomeResponse;
+import gg.agit.konect.domain.event.dto.EventMiniEventsResponse;
+import gg.agit.konect.domain.event.dto.EventProgramsResponse;
+import gg.agit.konect.domain.event.enums.EventProgramType;
+import gg.agit.konect.domain.event.service.EventService;
+import lombok.RequiredArgsConstructor;
+
+@RestController
+@Validated
+@RequiredArgsConstructor
+public class EventController implements EventApi {
+
+    private final EventService eventService;
+
+    @Override
+    public ResponseEntity<EventHomeResponse> getEventHome(Integer eventId, Integer userId) {
+        return ResponseEntity.ok(eventService.getEventHome(eventId, userId));
+    }
+
+    @Override
+    public ResponseEntity<EventProgramsResponse> getEventPrograms(Integer eventId, EventProgramType type, Integer page,
+        Integer limit,
+        Integer userId) {
+        return ResponseEntity.ok(eventService.getEventPrograms(eventId, type, page, limit, userId));
+    }
+
+    @Override
+    public ResponseEntity<EventBoothsResponse> getEventBooths(Integer eventId, String category, String keyword,
+        Integer page, Integer limit) {
+        return ResponseEntity.ok(eventService.getEventBooths(eventId, category, keyword, page, limit));
+    }
+
+    @Override
+    public ResponseEntity<EventBoothMapResponse> getEventBoothMap(Integer eventId) {
+        return ResponseEntity.ok(eventService.getEventBoothMap(eventId));
+    }
+
+    @Override
+    public ResponseEntity<EventMiniEventsResponse> getEventMiniEvents(Integer eventId, Integer page, Integer limit,
+        Integer userId) {
+        return ResponseEntity.ok(eventService.getEventMiniEvents(eventId, page, limit, userId));
+    }
+
+    @Override
+    public ResponseEntity<EventContentsResponse> getEventContents(Integer eventId, String category, Integer page,
+        Integer limit) {
+        return ResponseEntity.ok(eventService.getEventContents(eventId, category, page, limit));
+    }
+}

src/main/java/gg/agit/konect/domain/event/dto/EventBoothMapResponse.java

@@ -0,0 +1,28 @@
+package gg.agit.konect.domain.event.dto;
+
+import java.util.List;
+
+public record EventBoothMapResponse(
+    String mapImageUrl,
+    List<ZoneResponse> zones,
+    List<BoothMapItemResponse> booths
+) {
+
+    public record ZoneResponse(
+        String code,
+        String label
+    ) {
+    }
+
+    public record BoothMapItemResponse(
+        Integer boothId,
+        String name,
+        String zone,
+        Integer x,
+        Integer y,
+        Integer width,
+        Integer height,
+        String status
+    ) {
+    }
+}

src/main/java/gg/agit/konect/domain/event/dto/EventBoothSummaryResponse.java

@@ -0,0 +1,12 @@
+package gg.agit.konect.domain.event.dto;
+
+public record EventBoothSummaryResponse(
+    Integer boothId,
+    String name,
+    String category,
+    String locationLabel,
+    String zone,
+    String thumbnailUrl,
+    boolean open
+) {
+}

src/main/java/gg/agit/konect/domain/event/dto/EventBoothsResponse.java

@@ -0,0 +1,12 @@
+package gg.agit.konect.domain.event.dto;
+
+import java.util.List;
+
+public record EventBoothsResponse(
+    Long totalCount,
+    Integer currentCount,
+    Integer totalPage,
+    Integer currentPage,
+    List<EventBoothSummaryResponse> booths
+) {
+}

src/main/java/gg/agit/konect/domain/event/dto/EventContentSummaryResponse.java

@@ -0,0 +1,13 @@
+package gg.agit.konect.domain.event.dto;
+
+import java.time.LocalDateTime;
+
+public record EventContentSummaryResponse(
+    Integer contentId,
+    String title,
+    String thumbnailUrl,
+    String type,
+    String summary,
+    LocalDateTime publishedAt
+) {
+}

src/main/java/gg/agit/konect/domain/event/dto/EventContentsResponse.java

@@ -0,0 +1,12 @@
+package gg.agit.konect.domain.event.dto;
+
+import java.util.List;
+
+public record EventContentsResponse(
+    Long totalCount,
+    Integer currentCount,
+    Integer totalPage,
+    Integer currentPage,
+    List<EventContentSummaryResponse> contents
+) {
+}

src/main/java/gg/agit/konect/domain/event/dto/EventHomeResponse.java

@@ -0,0 +1,30 @@
+package gg.agit.konect.domain.event.dto;
+
+import java.time.LocalDateTime;
+
+public record EventHomeResponse(
+    Integer eventId,
+    String title,
+    String subtitle,
+    String posterImageUrl,
+    LocalDateTime startAt,
+    LocalDateTime endAt,
+    String notice,
+    Summary summary,
+    UserStatus userStatus
+) {
+
+    public record Summary(
+        Integer programCount,
+        Integer boothCount,
+        Integer eventCount,
+        Integer contentCount
+    ) {
+    }
+
+    public record UserStatus(
+        Integer point,
+        Integer participatedEventCount
+    ) {
+    }
+}

src/main/java/gg/agit/konect/domain/event/dto/EventMiniEventSummaryResponse.java

@@ -0,0 +1,12 @@
+package gg.agit.konect.domain.event.dto;
+
+public record EventMiniEventSummaryResponse(
+    Integer miniEventId,
+    String title,
+    String thumbnailUrl,
+    String description,
+    String reward,
+    String status,
+    boolean joined
+) {
+}

src/main/java/gg/agit/konect/domain/event/dto/EventMiniEventsResponse.java

@@ -0,0 +1,12 @@
+package gg.agit.konect.domain.event.dto;
+
+import java.util.List;
+
+public record EventMiniEventsResponse(
+    Long totalCount,
+    Integer currentCount,
+    Integer totalPage,
+    Integer currentPage,
+    List<EventMiniEventSummaryResponse> miniEvents
+) {
+}

src/main/java/gg/agit/konect/domain/event/dto/EventProgramSummaryResponse.java

@@ -0,0 +1,12 @@
+package gg.agit.konect.domain.event.dto;
+
+public record EventProgramSummaryResponse(
+    Integer programId,
+    String title,
+    String description,
+    String thumbnailUrl,
+    Integer rewardPoint,
+    String status,
+    boolean participated
+) {
+}

src/main/java/gg/agit/konect/domain/event/dto/EventProgramsResponse.java

@@ -0,0 +1,15 @@
+package gg.agit.konect.domain.event.dto;
+
+import java.util.List;
+
+import gg.agit.konect.domain.event.enums.EventProgramType;
+
+public record EventProgramsResponse(
+    Long totalCount,
+    Integer currentCount,
+    Integer totalPage,
+    Integer currentPage,
+    EventProgramType type,
+    List<EventProgramSummaryResponse> programs
+) {
+}

src/main/java/gg/agit/konect/domain/event/enums/EventBoothMapItemStatus.java

@@ -0,0 +1,7 @@
+package gg.agit.konect.domain.event.enums;
+
+public enum EventBoothMapItemStatus {
+    OPEN,
+    CLOSED,
+    HIDDEN
+}

src/main/java/gg/agit/konect/domain/event/enums/EventContentType.java

@@ -0,0 +1,7 @@
+package gg.agit.konect.domain.event.enums;
+
+public enum EventContentType {
+    ARTICLE,
+    IMAGE,
+    VIDEO
+}

src/main/java/gg/agit/konect/domain/event/enums/EventProgramType.java

@@ -0,0 +1,7 @@
+package gg.agit.konect.domain.event.enums;
+
+public enum EventProgramType {
+    ALL,
+    POINT,
+    RESONANCE
+}

src/main/java/gg/agit/konect/domain/event/enums/EventProgressStatus.java

@@ -0,0 +1,7 @@
+package gg.agit.konect.domain.event.enums;
+
+public enum EventProgressStatus {
+    UPCOMING,
+    ONGOING,
+    ENDED
+}

src/main/java/gg/agit/konect/domain/event/enums/EventStatus.java

@@ -0,0 +1,7 @@
+package gg.agit.konect.domain.event.enums;
+
+public enum EventStatus {
+    DRAFT,
+    PUBLISHED,
+    ENDED
+}

src/main/java/gg/agit/konect/domain/event/model/Event.java

@@ -0,0 +1,52 @@
+package gg.agit.konect.domain.event.model;
+
+import static jakarta.persistence.GenerationType.IDENTITY;
+import static lombok.AccessLevel.PROTECTED;
+
+import java.time.LocalDateTime;
+
+import gg.agit.konect.domain.event.enums.EventStatus;
+import gg.agit.konect.global.model.BaseEntity;
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.EnumType;
+import jakarta.persistence.Enumerated;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.Id;
+import jakarta.persistence.Table;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@Entity
+@Table(name = "event")
+@NoArgsConstructor(access = PROTECTED)
+public class Event extends BaseEntity {
+
+    @Id
+    @GeneratedValue(strategy = IDENTITY)
+    @Column(name = "id", nullable = false, updatable = false, unique = true)
+    private Integer id;
+
+    @Column(name = "title", nullable = false, length = 100)
+    private String title;
+
+    @Column(name = "subtitle", length = 255)
+    private String subtitle;
+
+    @Column(name = "poster_image_url", length = 255)
+    private String posterImageUrl;
+
+    @Column(name = "notice", columnDefinition = "TEXT")
+    private String notice;
+
+    @Column(name = "start_at", nullable = false)
+    private LocalDateTime startAt;
+
+    @Column(name = "end_at", nullable = false)
+    private LocalDateTime endAt;
+
+    @Enumerated(EnumType.STRING)
+    @Column(name = "status", nullable = false, length = 20)
+    private EventStatus status;
+}