Merge pull request #214 from festimap-org/develop

HeeChanN · web-flow · commit b20e45c8efba · 2025-10-31T22:35:17.000+09:00
feat : 선택사항 변경 및 회원정보 csv 내보내기
diff --git a/src/main/java/com/halo/eventer/domain/stamp/controller/v2/StampUserAdminController.java b/src/main/java/com/halo/eventer/domain/stamp/controller/v2/StampUserAdminController.java
@@ -1,8 +1,12 @@
 package com.halo.eventer.domain.stamp.controller.v2;
 
+import java.io.IOException;
+import java.nio.file.Path;
 import jakarta.validation.Valid;
 import jakarta.validation.constraints.Min;
 
+import org.springframework.core.io.FileSystemResource;
+import org.springframework.core.io.Resource;
 import org.springframework.web.bind.annotation.*;
 
 import com.halo.eventer.domain.stamp.dto.mission.request.MissionClearReqDto;
@@ -77,4 +81,11 @@ public StampUserUserIdResDto getStampUserUuid(
             @PathVariable @Min(1) long festivalId, @PathVariable @Min(1) long stampId, @PathVariable String uuid) {
         return stampUserAdminService.getStampUserId(festivalId, stampId, uuid);
     }
+
+    @GetMapping(value = "/export", produces = "text/csv; charset=UTF-8")
+    public Resource exportStampUsers(@PathVariable @Min(1) long festivalId, @PathVariable @Min(1) long stampId)
+            throws IOException {
+        Path file = stampUserAdminService.exportStampUser(festivalId, stampId);
+        return new FileSystemResource(file);
+    }
 }
diff --git a/src/main/java/com/halo/eventer/domain/stamp/dto/stamp/request/StampTourLandingPageReqDto.java b/src/main/java/com/halo/eventer/domain/stamp/dto/stamp/request/StampTourLandingPageReqDto.java
@@ -23,7 +23,6 @@ public class StampTourLandingPageReqDto {
     @NotEmpty
     private String iconImgUrl;
 
-    @NotEmpty
     private String description;
 
     @NotNull
diff --git a/src/main/java/com/halo/eventer/domain/stamp/dto/stamp/request/StampTourParticipateGuidePageReqDto.java b/src/main/java/com/halo/eventer/domain/stamp/dto/stamp/request/StampTourParticipateGuidePageReqDto.java
@@ -20,12 +20,9 @@ public class StampTourParticipateGuidePageReqDto {
 
     private String mediaUrl;
 
-    @NotBlank
     private String summary;
 
-    @NotBlank
     private String details;
 
-    @NotBlank
     private String additional;
 }
diff --git a/src/main/java/com/halo/eventer/domain/stamp/repository/StampUserRepository.java b/src/main/java/com/halo/eventer/domain/stamp/repository/StampUserRepository.java
@@ -1,6 +1,7 @@
 package com.halo.eventer.domain.stamp.repository;
 
 import java.util.Optional;
+import java.util.stream.Stream;
 
 import org.springframework.data.domain.Page;
 import org.springframework.data.domain.Pageable;
@@ -17,6 +18,9 @@ public interface StampUserRepository extends JpaRepository<StampUser, Long> {
 
     Optional<StampUser> findByStampIdAndPhoneAndName(Long stampId, String phone, String name);
 
+    @Query("select su from StampUser su where su.stamp.id = :stampId")
+    Stream<StampUser> findByStampId(Long stampId);
+
     @Query(
             """
            select su
diff --git a/src/main/java/com/halo/eventer/domain/stamp/service/v2/StampUserAdminService.java b/src/main/java/com/halo/eventer/domain/stamp/service/v2/StampUserAdminService.java
@@ -1,7 +1,18 @@
 package com.halo.eventer.domain.stamp.service.v2;
 
+import java.io.BufferedWriter;
+import java.io.IOException;
+import java.io.UncheckedIOException;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.Paths;
+import java.nio.file.StandardOpenOption;
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
 import java.util.Comparator;
 import java.util.List;
+import java.util.stream.Stream;
 
 import org.springframework.data.domain.Page;
 import org.springframework.data.domain.PageRequest;
@@ -123,6 +134,59 @@ public StampUserUserIdResDto getStampUserId(long festivalId, long stampId, Strin
         return new StampUserUserIdResDto(stampUser.getId());
     }
 
+    @Transactional(readOnly = true)
+    public Path exportStampUser(long festivalId, long stampId) throws IOException {
+        ensureStamp(festivalId, stampId);
+        final DateTimeFormatter TS_FMT = DateTimeFormatter.ofPattern("yyyyMMdd_HHmmss");
+        final DateTimeFormatter CSV_TIME_FMT = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
+        final String filename =
+                "stamp_users_%d_%s.csv".formatted(stampId, LocalDateTime.now().format(TS_FMT));
+        final Path filePath = Paths.get(filename);
+        try (BufferedWriter writer = Files.newBufferedWriter(
+                        filePath,
+                        StandardCharsets.UTF_8,
+                        StandardOpenOption.CREATE,
+                        StandardOpenOption.TRUNCATE_EXISTING);
+                Stream<StampUser> stream = stampUserRepository.findByStampId(stampId)) {
+            writer.write("\uFEFF");
+            writer.write("UUID,전화번호,이름,참여인원,완료여부,등록일시");
+            writer.newLine();
+            stream.forEach(s -> writeRow(writer, s, CSV_TIME_FMT));
+        }
+
+        return filePath;
+    }
+
+    private void writeRow(BufferedWriter w, StampUser s, DateTimeFormatter timeFmt) {
+        try {
+            final String uuid = nullSafe(s.getUuid());
+            final String phone = escape(nullSafe(encryptService.decryptInfo(s.getPhone())));
+            final String name = escape(nullSafe(encryptService.decryptInfo(s.getName())));
+            final String count = String.valueOf(s.getParticipantCount());
+            final String done = String.valueOf(s.isFinished());
+            final String cAt =
+                    (s.getCreatedAt() == null) ? "" : s.getCreatedAt().format(timeFmt);
+            w.write(String.join(",", uuid, phone, name, count, done, cAt));
+            w.newLine();
+        } catch (IOException e) {
+            throw new UncheckedIOException(e);
+        }
+    }
+
+    private String escape(String value) {
+        if (value == null || value.isEmpty()) return "";
+        boolean needQuote = value.indexOf(',') >= 0
+                || value.indexOf('"') >= 0
+                || value.indexOf('\n') >= 0
+                || value.indexOf('\r') >= 0;
+        String v = value.replace("\"", "\"\"");
+        return needQuote ? "\"" + v + "\"" : v;
+    }
+
+    private String nullSafe(String v) {
+        return (v == null) ? "" : v;
+    }
+
     private void ensureStamp(long festivalId, long stampId) {
         Stamp stamp = loadStampOrThrow(stampId);
         stamp.ensureStampInFestival(festivalId);
diff --git a/src/main/java/com/halo/eventer/global/config/security/CorsConfig.java b/src/main/java/com/halo/eventer/global/config/security/CorsConfig.java
@@ -35,7 +35,7 @@ public CorsConfigurationSource customCorsConfigurationSource() {
 
         configuration.setAllowedOriginPatterns(ALLOWED_ORIGINS);
         configuration.setAllowedMethods(Arrays.asList("GET", "POST", "PUT", "DELETE", "PATCH", "OPTIONS"));
-        configuration.setAllowedHeaders(Arrays.asList("Content-Type", "Authorization", "X-Requested-With"));
+        configuration.setAllowedHeaders(Arrays.asList("*"));
         configuration.setAllowCredentials(true);
 
         UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
diff --git a/src/test/java/com/halo/eventer/domain/stamp/v2/api_docs/StampUserAdminDocs.java b/src/test/java/com/halo/eventer/domain/stamp/v2/api_docs/StampUserAdminDocs.java
@@ -214,6 +214,22 @@ public static RestDocumentationResultHandler getUserIdByUuid() {
                         .build()));
     }
 
+    public static RestDocumentationResultHandler exportCsv() {
+        return document(
+                "v2-stampuser-export",
+                resource(builder()
+                        .tag(TAG)
+                        .summary("사용자 CSV 내보내기")
+                        .description("지정된 축제/스탬프투어의 사용자 목록을 CSV(UTF-8)로 다운로드합니다.")
+                        .pathParameters(
+                                parameterWithName("festivalId").description("축제 ID (>=1)"),
+                                parameterWithName("stampId").description("스탬프투어 ID (>=1)"))
+                        .requestHeaders(headerWithName("Authorization").description("JWT Access 토큰 (ADMIN)"))
+                        // CSV는 JSON 필드가 없으므로 responseFields 생략
+                        .responseHeaders(headerWithName("Content-Type").description("text/csv; charset=UTF-8"))
+                        .build()));
+    }
+
     // 공통 에러 문서
     public static RestDocumentationResultHandler error(String id) {
         return document(
diff --git a/src/test/java/com/halo/eventer/domain/stamp/v2/controller/StampUserAdminControllerTest.java b/src/test/java/com/halo/eventer/domain/stamp/v2/controller/StampUserAdminControllerTest.java
@@ -1,11 +1,15 @@
 package com.halo.eventer.domain.stamp.v2.controller;
 
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
 import java.time.LocalDateTime;
 import java.util.List;
 import java.util.Map;
 
 import org.junit.jupiter.api.Nested;
 import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.io.TempDir;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.test.autoconfigure.restdocs.AutoConfigureRestDocs;
 import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
@@ -342,4 +346,52 @@ class UUID로_userId_조회 {
                     .andDo(StampUserAdminDocs.getUserIdByUuid());
         }
     }
+
+    @Nested
+    class CSV_내보내기 {
+
+        @TempDir
+        Path tempDir;
+
+        @Test
+        @WithMockUser(roles = "ADMIN")
+        void 성공() throws Exception {
+            String csv = "번호,UUID,전화번호,이름,참여인원,완료여부,등록일시\n" + "1,uuid-1,010-1234-5678,홍길동,2,완료,2025-10-01 12:34:56\n";
+            Path csvFile = tempDir.resolve("stamp_users.csv");
+            Files.write(csvFile, csv.getBytes(StandardCharsets.UTF_8));
+
+            given(service.exportStampUser(축제_ID, 스탬프_ID)).willReturn(csvFile);
+
+            // when & then
+            mockMvc.perform(get(
+                                    "/api/v2/admin/festivals/{festivalId}/stamp-tours/{stampId}/users/export",
+                                    축제_ID,
+                                    스탬프_ID)
+                            .header(HttpHeaders.AUTHORIZATION, AUTH))
+                    .andExpect(status().isOk())
+                    .andExpect(content().contentType(MediaType.valueOf("text/csv; charset=UTF-8")))
+                    .andExpect(content().string(csv))
+                    .andDo(StampUserAdminDocs.exportCsv());
+        }
+
+        @Test
+        void 실패_권한없음() throws Exception {
+            mockMvc.perform(get(
+                            "/api/v2/admin/festivals/{festivalId}/stamp-tours/{stampId}/users/export", 축제_ID, 스탬프_ID))
+                    .andExpect(status().isUnauthorized())
+                    .andDo(StampUserAdminDocs.error("v2-stampuser-export-unauthorized"));
+        }
+
+        @Test
+        @WithMockUser(roles = "ADMIN")
+        void 실패_축제ID_검증() throws Exception {
+            mockMvc.perform(get(
+                                    "/api/v2/admin/festivals/{festivalId}/stamp-tours/{stampId}/users/export",
+                                    잘못된_ID,
+                                    스탬프_ID) // @Min(1) 위반
+                            .header(HttpHeaders.AUTHORIZATION, AUTH))
+                    .andExpect(status().isBadRequest())
+                    .andDo(StampUserAdminDocs.error("v2-stampuser-export-badrequest"));
+        }
+    }
 }

Original file line number	Diff line number	Diff line change
`@@ -20,12 +20,9 @@ public class StampTourParticipateGuidePageReqDto {`
`20`	`20`
`21`	`21`	`private String mediaUrl;`
`22`	`22`
`23`		`- @NotBlank`
`24`	`23`	`private String summary;`
`25`	`24`
`26`		`- @NotBlank`
`27`	`25`	`private String details;`
`28`	`26`
`29`		`- @NotBlank`
`30`	`27`	`private String additional;`
`31`	`28`	`}`