develop -> main

src/main/java/gg/agit/konect/admin/website/controller/AdminWebsiteClubSheetImportApi.java

@@ -0,0 +1,46 @@
+package gg.agit.konect.admin.website.controller;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+
+import gg.agit.konect.admin.website.dto.AdminWebsiteClubSheetImportConfirmRequest;
+import gg.agit.konect.admin.website.dto.AdminWebsiteClubSheetImportPreviewResponse;
+import gg.agit.konect.admin.website.dto.AdminWebsiteClubSheetImportRequest;
+import gg.agit.konect.admin.website.dto.AdminWebsiteClubSheetImportResponse;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+
+@Tag(name = "(Admin) Website Club Sheet Import", description = "konect.space 대학별 동아리 목록 시트 등록 API")
+@RequestMapping("/admin/konect/universities")
+public interface AdminWebsiteClubSheetImportApi {
+
+    @Operation(
+        summary = "Google Sheets 동아리 등록 양식을 읽고 미리보기 JSON을 반환한다.",
+        description = """
+            고정된 작성 시트 양식의 A~F 컬럼을 읽어 KONECT 웹사이트용 동아리 JSON을 생성합니다.
+            이 API는 DB에 저장하지 않고, 사용자가 확인/수정할 수 있는 중간 결과만 반환합니다.
+            """
+    )
+    @PostMapping("/{universityId}/clubs/sheet/import/preview")
+    ResponseEntity<AdminWebsiteClubSheetImportPreviewResponse> previewClubs(
+        @PathVariable(name = "universityId") Integer universityId,
+        @Valid @RequestBody AdminWebsiteClubSheetImportRequest request
+    );
+
+    @Operation(
+        summary = "미리보기 JSON을 최종 동아리 목록으로 저장한다.",
+        description = """
+            preview 응답을 그대로 보내거나 수정한 뒤 보내면 web_club에 저장합니다.
+            enabled=false인 항목과 이미 같은 대학에 등록된 같은 이름의 동아리는 저장하지 않습니다.
+            """
+    )
+    @PostMapping("/{universityId}/clubs/sheet/import/confirm")
+    ResponseEntity<AdminWebsiteClubSheetImportResponse> confirmImport(
+        @PathVariable(name = "universityId") Integer universityId,
+        @Valid @RequestBody AdminWebsiteClubSheetImportConfirmRequest request
+    );
+}

src/main/java/gg/agit/konect/admin/website/controller/AdminWebsiteClubSheetImportController.java

@@ -0,0 +1,43 @@
+package gg.agit.konect.admin.website.controller;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import gg.agit.konect.admin.website.dto.AdminWebsiteClubSheetImportConfirmRequest;
+import gg.agit.konect.admin.website.dto.AdminWebsiteClubSheetImportPreviewResponse;
+import gg.agit.konect.admin.website.dto.AdminWebsiteClubSheetImportRequest;
+import gg.agit.konect.admin.website.dto.AdminWebsiteClubSheetImportResponse;
+import gg.agit.konect.admin.website.service.AdminWebsiteClubSheetImportService;
+import gg.agit.konect.domain.user.enums.UserRole;
+import gg.agit.konect.global.auth.annotation.Auth;
+import lombok.RequiredArgsConstructor;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/admin/konect/universities")
+@Auth(roles = {UserRole.ADMIN})
+public class AdminWebsiteClubSheetImportController implements AdminWebsiteClubSheetImportApi {
+
+    private final AdminWebsiteClubSheetImportService adminWebsiteClubSheetImportService;
+
+    @Override
+    public ResponseEntity<AdminWebsiteClubSheetImportPreviewResponse> previewClubs(
+        Integer universityId,
+        AdminWebsiteClubSheetImportRequest request
+    ) {
+        AdminWebsiteClubSheetImportPreviewResponse response =
+            adminWebsiteClubSheetImportService.previewClubs(universityId, request.spreadsheetUrl());
+        return ResponseEntity.ok(response);
+    }
+
+    @Override
+    public ResponseEntity<AdminWebsiteClubSheetImportResponse> confirmImport(
+        Integer universityId,
+        AdminWebsiteClubSheetImportConfirmRequest request
+    ) {
+        AdminWebsiteClubSheetImportResponse response =
+            adminWebsiteClubSheetImportService.confirmImport(universityId, request.clubs());
+        return ResponseEntity.ok(response);
+    }
+}

src/main/java/gg/agit/konect/admin/website/dto/AdminWebsiteClubSheetImportConfirmRequest.java

@@ -0,0 +1,46 @@
+package gg.agit.konect.admin.website.dto;
+
+import java.util.List;
+
+import gg.agit.konect.domain.club.enums.ClubCategory;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+
+public record AdminWebsiteClubSheetImportConfirmRequest(
+
+    @NotEmpty
+    List<@Valid ConfirmClub> clubs
+) {
+
+    public record ConfirmClub(
+        int rowNumber,
+
+        @NotBlank
+        @Size(max = 50)
+        String name,
+
+        @NotNull
+        ClubCategory clubCategory,
+
+        @NotBlank
+        @Size(max = 20)
+        String topic,
+
+        @NotBlank
+        @Size(max = 30)
+        String description,
+
+        @NotNull
+        String introduce,
+
+        @NotBlank
+        @Size(max = 255)
+        String categoryEmoji,
+
+        boolean enabled
+    ) {
+    }
+}

src/main/java/gg/agit/konect/admin/website/dto/AdminWebsiteClubSheetImportPreviewResponse.java

@@ -0,0 +1,38 @@
+package gg.agit.konect.admin.website.dto;
+
+import java.util.List;
+
+import gg.agit.konect.domain.club.enums.ClubCategory;
+
+public record AdminWebsiteClubSheetImportPreviewResponse(
+    Integer universityId,
+    int previewCount,
+    List<PreviewClub> clubs,
+    List<String> warnings
+) {
+
+    public static AdminWebsiteClubSheetImportPreviewResponse of(
+        Integer universityId,
+        List<PreviewClub> clubs,
+        List<String> warnings
+    ) {
+        return new AdminWebsiteClubSheetImportPreviewResponse(
+            universityId,
+            clubs.size(),
+            clubs,
+            warnings == null ? List.of() : warnings
+        );
+    }
+
+    public record PreviewClub(
+        int rowNumber,
+        String name,
+        ClubCategory clubCategory,
+        String topic,
+        String description,
+        String introduce,
+        String categoryEmoji,
+        boolean enabled
+    ) {
+    }
+}

src/main/java/gg/agit/konect/admin/website/dto/AdminWebsiteClubSheetImportRequest.java

@@ -0,0 +1,17 @@
+package gg.agit.konect.admin.website.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Pattern;
+
+public record AdminWebsiteClubSheetImportRequest(
+
+    @Schema(
+        description = "동아리 등록 양식 Google Sheets URL",
+        example = "https://docs.google.com/spreadsheets/d/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms/edit"
+    )
+    @NotBlank
+    @Pattern(regexp = "^https://docs\\.google\\.com/spreadsheets/(?:u/\\d+/)?d/[A-Za-z0-9_-]+.*")
+    String spreadsheetUrl
+) {
+}

src/main/java/gg/agit/konect/admin/website/dto/AdminWebsiteClubSheetImportResponse.java

@@ -0,0 +1,22 @@
+package gg.agit.konect.admin.website.dto;
+
+import java.util.List;
+
+public record AdminWebsiteClubSheetImportResponse(
+    int importedCount,
+    int skippedCount,
+    List<String> warnings
+) {
+
+    public static AdminWebsiteClubSheetImportResponse of(
+        int importedCount,
+        int skippedCount,
+        List<String> warnings
+    ) {
+        return new AdminWebsiteClubSheetImportResponse(
+            importedCount,
+            skippedCount,
+            warnings == null ? List.of() : warnings
+        );
+    }
+}