Merge pull request #190 from GoTogether-Inc/feature/#184

[feat] 구매/참가자 관리 목록 엑셀 다운로드 API 구현

Author: m3k0813

build.gradle

@@ -68,6 +68,9 @@ dependencies {
     // Prometheus & Actuator
     implementation 'org.springframework.boot:spring-boot-starter-actuator'
     implementation 'io.micrometer:micrometer-registry-prometheus'
+
+    // POI
+    implementation 'org.apache.poi:poi-ooxml:5.2.3'
 }
 
 tasks.named('test') {

src/main/java/com/gotogether/domain/hostchannel/controller/HostChannelApi.java

@@ -295,4 +295,25 @@ ApiResponse<?> approveOrderStatus(
 		@Parameter(description = "주문 상태 변경 요청 데이터", required = true)
 		@RequestBody @Valid OrderStatusRequestDTO request
 	);
+
+	@Operation(
+		summary = "구매/참가자 관리 목록 엑셀 다운로드",
+		description = "구매/참가자 관리 목록을 엑셀 형식으로 다운로드합니다."
+	)
+	@ApiResponses(value = {
+		@io.swagger.v3.oas.annotations.responses.ApiResponse(
+			responseCode = "200",
+			description = "구매/참가자 관리 목록 엑셀 다운로드 성공",
+			content = @Content(schema = @Schema(implementation = org.springframework.core.io.Resource.class))
+		),
+		@io.swagger.v3.oas.annotations.responses.ApiResponse(
+			responseCode = "404",
+			description = "EVENT4001: 이벤트가 없습니다."
+		)
+	})
+	@GetMapping("/dashboard/participant-management/excel")
+	org.springframework.http.ResponseEntity<org.springframework.core.io.Resource> exportParticipantManagementExcel(
+		@Parameter(description = "이벤트 ID", required = true) 
+		@RequestParam Long eventId
+	);
 } 

src/main/java/com/gotogether/domain/hostchannel/controller/HostChannelController.java

@@ -33,6 +33,9 @@
 import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
 
+import java.net.URLEncoder;
+import java.nio.charset.StandardCharsets;
+
 @RestController
 @RequiredArgsConstructor
 @RequestMapping("/api/v1/host-channels")
@@ -132,4 +135,20 @@ public ApiResponse<?> approveOrderStatus(
 		hostChannelService.approveOrderStatus(request.getOrderId());
 		return ApiResponse.onSuccess("주문 승인 완료");
 	}
+
+	@Override
+	public org.springframework.http.ResponseEntity<org.springframework.core.io.Resource> exportParticipantManagementExcel(
+	    @RequestParam Long eventId
+	) {
+	    byte[] excelData = hostChannelService.generateParticipantManagementExcel(eventId);
+	    String fileName = hostChannelService.generateParticipantManagementExcelFileName(eventId);
+	    String encodedFileName = URLEncoder.encode(fileName, StandardCharsets.UTF_8)
+	        .replaceAll("\\+", "%20"); 
+
+	    return org.springframework.http.ResponseEntity.ok()
+	        .header(org.springframework.http.HttpHeaders.CONTENT_DISPOSITION,
+	            "attachment; filename*=UTF-8''" + encodedFileName)
+	        .contentType(org.springframework.http.MediaType.parseMediaType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"))
+	        .body(new org.springframework.core.io.ByteArrayResource(excelData));
+	}
 }

src/main/java/com/gotogether/domain/hostchannel/service/HostChannelService.java

@@ -39,4 +39,8 @@ List<ParticipantManagementResponseDTO> getParticipantManagement(Long eventId, St
 	HostDashboardResponseDTO getHostDashboard(Long eventId);
 
 	void approveOrderStatus(Long orderId);
+
+	byte[] generateParticipantManagementExcel(Long eventId);
+	
+	String generateParticipantManagementExcelFileName(Long eventId);
 }

src/main/java/com/gotogether/domain/hostchannel/service/HostChannelServiceImpl.java

@@ -2,7 +2,9 @@
 
 import java.util.List;
 import java.util.Optional;
+import java.util.Set;
 import java.util.stream.Collectors;
+import java.util.LinkedHashSet;
 
 import org.springframework.data.domain.Page;
 import org.springframework.data.domain.Pageable;
@@ -39,6 +41,10 @@
 import com.gotogether.global.apipayload.code.status.ErrorStatus;
 import com.gotogether.global.apipayload.exception.GeneralException;
 import com.gotogether.global.common.service.S3UploadService;
+import com.gotogether.global.util.ExcelGenerator;
+import com.gotogether.domain.ticketoptionassignment.entity.TicketOptionAssignment;
+import com.gotogether.domain.ticketoptionassignment.repository.TicketOptionAssignmentRepository;
+import com.gotogether.domain.ticketoptionanswer.repository.TicketOptionAnswerRepository;
 
 import lombok.RequiredArgsConstructor;
 
@@ -56,6 +62,8 @@ public class HostChannelServiceImpl implements HostChannelService {
 	private final EventFacade eventFacade;
 	private final TicketQrCodeService ticketQrCodeService;
 	private final S3UploadService s3UploadService;
+	private final TicketOptionAssignmentRepository ticketOptionAssignmentRepository;
+	private final TicketOptionAnswerRepository ticketOptionAnswerRepository;
 
 	@Override
 	@Transactional
@@ -224,6 +232,37 @@ public void approveOrderStatus(Long orderId) {
 		order.approveOrder();
 	}
 
+	@Override
+	@Transactional(readOnly = true)
+	public byte[] generateParticipantManagementExcel(Long eventId) {
+		List<Ticket> tickets = ticketRepository.findByEventId(eventId);
+		List<Order> orders = orderRepository.findCompletedOrdersByEventId(eventId, OrderStatus.COMPLETED);
+		
+		Set<String> optionNames = extractOptionNames(tickets);
+		
+		try {
+			return ExcelGenerator.generateParticipantExcel(orders, optionNames, 
+				orderId -> ticketOptionAnswerRepository.findByOrderId(orderId));
+		} catch (RuntimeException e) {
+			throw new GeneralException(ErrorStatus._EXCEL_GENERATION_FAILED);
+		}
+	}
+
+	@Override
+	@Transactional(readOnly = true)
+	public String generateParticipantManagementExcelFileName(Long eventId) {
+		Event event = eventRepository.findById(eventId)
+			.orElseThrow(() -> new GeneralException(ErrorStatus._EVENT_NOT_FOUND));
+		
+		String eventName = event.getTitle()
+			.replaceAll("[\\/:*?\"<>|]", "") 
+			.replaceAll("\\s+", "_");
+		
+		String currentDate = java.time.LocalDate.now().toString();
+		
+		return String.format("%s_구매참가자목록_%s.xlsx", eventName, currentDate);
+	}
+
 	private User getUser(Long userId) {
 		return userRepository.findById(userId)
 			.orElseThrow(() -> new GeneralException(ErrorStatus._USER_NOT_FOUND));
@@ -274,4 +313,23 @@ private void updateProfileImageToFinal(HostChannel hostChannel, String imageUrl)
 		String finalUrl = s3UploadService.moveTempImageToFinal(imageUrl);
 		hostChannel.updateProfileImageUrl(finalUrl);
 	}
+
+	private Set<String> extractOptionNames(List<Ticket> tickets) {
+		Set<String> optionNames = new LinkedHashSet<>();
+		
+		for (Ticket ticket : tickets) {
+			List<TicketOptionAssignment> assignments = ticketOptionAssignmentRepository.findAllByTicket(ticket);
+			
+			for (TicketOptionAssignment assignment : assignments) {
+				if (assignment != null && assignment.getTicketOption() != null) {
+					String optionName = assignment.getTicketOption().getName();
+					if (optionName != null && !optionName.trim().isEmpty()) {
+						optionNames.add(optionName);
+					}
+				}
+			}
+		}
+		
+		return optionNames;
+	}
 }

src/main/java/com/gotogether/domain/ticketoptionanswer/repository/TicketOptionAnswerRepository.java

@@ -30,4 +30,6 @@ WHERE e.ticketOption.id IN (
 	List<TicketOptionAnswer> findByTicketId(@Param("ticketId") Long ticketId);
 
 	boolean existsByTicketOption(TicketOption ticketOption);
+
+	List<TicketOptionAnswer> findByOrderId(Long orderId);
 }

src/main/java/com/gotogether/global/apipayload/code/status/ErrorStatus.java

@@ -66,7 +66,9 @@ public enum ErrorStatus implements BaseErrorCode {
 	// 미사용
 	_TICKET_OPTION_ANSWER_ALREADY_EXISTS(HttpStatus.BAD_REQUEST, "TICKET_OPTION_ANSWER4002", "해당 티켓 옵션에 대한 응답이 이미 존재합니다."),
 
-	_TERM_ALREADY_EXISTS(HttpStatus.BAD_REQUEST, "TERM4001", "이미 약관에 동의한 사용자입니다.");
+	_TERM_ALREADY_EXISTS(HttpStatus.BAD_REQUEST, "TERM4001", "이미 약관에 동의한 사용자입니다."),
+
+	_EXCEL_GENERATION_FAILED(HttpStatus.INTERNAL_SERVER_ERROR, "EXCEL5001", "엑셀 파일 생성에 실패했습니다.");
 
 	private final HttpStatus httpStatus;
 	private final String code;

src/main/java/com/gotogether/global/util/ExcelGenerator.java

@@ -0,0 +1,104 @@
+package com.gotogether.global.util;
+
+import java.io.ByteArrayOutputStream;
+import java.io.IOException;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import org.apache.poi.ss.usermodel.Row;
+import org.apache.poi.ss.usermodel.Sheet;
+import org.apache.poi.ss.usermodel.Workbook;
+import org.apache.poi.xssf.usermodel.XSSFWorkbook;
+
+import com.gotogether.domain.order.entity.Order;
+import com.gotogether.domain.ticketoptionanswer.entity.TicketOptionAnswer;
+
+import lombok.AccessLevel;
+import lombok.NoArgsConstructor;
+
+@NoArgsConstructor(access = AccessLevel.PRIVATE)
+public class ExcelGenerator {
+
+	private static final String SHEET_NAME = "구매참가자목록";
+	private static final String[] HEADERS = {"이름", "이메일", "휴대폰 번호", "구매 일자", "티켓 이름"};
+
+	public static byte[] generateParticipantExcel(List<Order> orders, Set<String> optionNames, 
+			java.util.function.Function<Long, List<TicketOptionAnswer>> answerProvider) {
+		try (Workbook workbook = new XSSFWorkbook();
+			 ByteArrayOutputStream out = new ByteArrayOutputStream()) {
+			
+			Sheet sheet = workbook.createSheet(SHEET_NAME);
+			
+			createHeaderRow(sheet, optionNames);
+			createDataRows(sheet, orders, optionNames, answerProvider);
+			
+			workbook.write(out);
+			return out.toByteArray();
+		} catch (IOException e) {
+			throw new RuntimeException("엑셀 파일 생성 중 오류 발생: ", e);
+		}
+	}
+
+	private static void createHeaderRow(Sheet sheet, Set<String> optionNames) {
+		Row headerRow = sheet.createRow(0);
+		int colIdx = 0;
+		
+		for (String header : HEADERS) {
+			headerRow.createCell(colIdx++).setCellValue(header);
+		}
+		
+		for (String optionName : optionNames) {
+			headerRow.createCell(colIdx++).setCellValue(optionName);
+		}
+	}
+
+	private static void createDataRows(Sheet sheet, List<Order> orders, Set<String> optionNames,
+			java.util.function.Function<Long, List<TicketOptionAnswer>> answerProvider) {
+		int rowIdx = 1;
+		
+		for (Order order : orders) {
+			Row row = sheet.createRow(rowIdx++);
+			int cellIdx = 0;
+			
+			row.createCell(cellIdx++).setCellValue(order.getUser().getName());
+			row.createCell(cellIdx++).setCellValue(order.getUser().getEmail());
+			row.createCell(cellIdx++).setCellValue(order.getUser().getPhoneNumber());
+			row.createCell(cellIdx++).setCellValue(order.getCreatedAt().toLocalDate().toString());
+			row.createCell(cellIdx++).setCellValue(order.getTicket().getName());
+			
+			Map<String, String> optionAnswerMap = createOptionAnswerMap(order, answerProvider);
+			for (String optionName : optionNames) {
+				row.createCell(cellIdx++).setCellValue(optionAnswerMap.getOrDefault(optionName, ""));
+			}
+		}
+	}
+
+	private static Map<String, String> createOptionAnswerMap(Order order, 
+			java.util.function.Function<Long, List<TicketOptionAnswer>> answerProvider) {
+		Map<String, String> optionAnswerMap = new java.util.HashMap<>();
+		
+		List<TicketOptionAnswer> answers = answerProvider.apply(order.getId());
+		for (TicketOptionAnswer answer : answers) {
+			String optionName = answer.getTicketOption().getName();
+			String value = getAnswerValue(answer);
+			
+			if (optionAnswerMap.containsKey(optionName)) {
+				value = optionAnswerMap.get(optionName) + ", " + value;
+			}
+			optionAnswerMap.put(optionName, value);
+		}
+		
+		return optionAnswerMap;
+	}
+
+	private static String getAnswerValue(TicketOptionAnswer answer) {
+		if (answer.getAnswerText() != null) {
+			return answer.getAnswerText();
+		}
+		if (answer.getTicketOptionChoice() != null) {
+			return answer.getTicketOptionChoice().getName();
+		}
+		return "";
+	}
+}