Merge pull request #42 from INU-Software-Design/NEEIS-91-feature/report

[Neeis 91-feature/report] 상담내역 보고서 PDF 생성

Author: 82everywin

.DS_Store

@@ -17,7 +17,8 @@ bin/
 !**/src/main/**/bin/
 !**/src/test/**/bin/
 
-src/main/resources/**
+src/main/resources/firebase/**
+src/main/resources/application.properties
 application.properties
 .env
 

.gitignore

@@ -32,6 +32,7 @@ jacoco {
 dependencies {
     implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
     implementation 'org.springframework.boot:spring-boot-starter-web'
+    implementation 'org.thymeleaf.extras:thymeleaf-extras-springsecurity6'
     compileOnly 'org.projectlombok:lombok'
     runtimeOnly 'com.mysql:mysql-connector-j'
     annotationProcessor 'org.projectlombok:lombok'
@@ -60,12 +61,22 @@ dependencies {
 
     // FCM
     implementation 'com.google.firebase:firebase-admin:9.4.3'
+
+    // Excel
+    implementation 'org.apache.poi:poi:5.2.5'
+    implementation 'org.apache.poi:poi-ooxml:5.2.5'
+
+    // PDF
+    implementation 'com.openhtmltopdf:openhtmltopdf-slf4j:1.0.10' // 로그용 (선택)
+    implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
+    implementation 'com.itextpdf:itext7-core:7.1.2'
+    implementation 'com.itextpdf:html2pdf:3.0.2'
 }
 
+
 tasks.named('test') {
     useJUnitPlatform()
     finalizedBy  jacocoTestReport
-
 }
 
 // jacoco Report 생성

build.gradle

@@ -1,23 +1,21 @@
 package com.neeis.neeis.domain.counsel;
 
-public enum CounselCategory {
-    // 대학
-    UNIVERSITY,
-
-    // 취업
-    CAREER,
-
-    // 가정
-    FAMILY,
+import lombok.Getter;
 
-    // 학업
-    ACADEMIC,
+@Getter
+public enum CounselCategory {
+    UNIVERSITY("대학"),
+    CAREER("취업"),
+    FAMILY("가정"),
+    ACADEMIC("학업"),
+    PERSONAL("개인"),
+    OTHER("기타");
 
-    // 개인
-    PERSONAL,
+    private final String displayName;
 
-    // 기타
-    OTHER;
+    CounselCategory(String displayName) {
+        this.displayName = displayName;
+    }
 
     public static boolean exists(String value) {
         for(CounselCategory c : CounselCategory.values()) {

src/.DS_Store

@@ -26,7 +26,7 @@ public class CounselController {
     private final CounselService counselService;
 
     @PostMapping
-    @Operation(summary = "상담 작성", description = "교사가 학생과의 상담 기록을 작성합니다. <br>" +
+    @Operation(summary = "[교사 전용] 상담 작성", description = "교사가 학생과의 상담 기록을 작성합니다. <br>" +
             "상담 종류:  UNIVERSITY(대학), CAREER(취업), FAMILY(가정), ACADEMIC(학업), PERSONAL(개인), OTHER(기타) 가 존재합니다." )
     public ResponseEntity<CommonResponse<CounselResponseDto>> postCounsel(
             @AuthenticationPrincipal UserDetails userDetails,
@@ -55,7 +55,7 @@ public ResponseEntity<CommonResponse<List<CounselDetailDto>>> getCounsels(
     }
 
     @PutMapping("/{counselId}")
-    @Operation(summary = "상담 수정", description = "상담 내용을 수정합니다.<br> " +
+    @Operation(summary = "[교사 전용] 상담 수정", description = "상담 내용을 수정합니다.<br> " +
             "조회시 제공받은 counselId를 path parameter로 입력해주세요.")
     public ResponseEntity<CommonResponse<CounselDetailDto>> updateCounsel(
             @AuthenticationPrincipal UserDetails userDetails,

src/main/.DS_Store

@@ -0,0 +1,126 @@
+package com.neeis.neeis.domain.counsel.controller;
+
+import com.neeis.neeis.domain.counsel.service.CounselPdfService;
+import com.neeis.neeis.domain.counsel.service.CounselService;
+import com.neeis.neeis.global.jwt.CustomUserDetails;
+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 io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.HttpHeaders;
+import org.springframework.http.MediaType;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.*;
+
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
+
+/**
+ * 상담 보고서 PDF API 컨트롤러
+ *
+ * 기존 CounselService를 통해 실제 데이터베이스의 상담 데이터를 PDF로 생성합니다.
+ */
+@Slf4j
+@RestController
+@RequestMapping("/reports/counsels")
+@RequiredArgsConstructor
+@Tag(name = "상담 PDF", description = "상담 보고서 PDF 생성 API")
+public class CounselPdfController {
+
+    // ✅ CounselService 사용 (CounselPdfService 대신)
+    private final CounselPdfService counselPdfService;
+
+    @GetMapping("/{counselId}/pdf")
+    @Operation(summary = "개별 상담 PDF 생성", description = "특정 상담에 대한 PDF 보고서를 생성합니다.")
+    @ApiResponses({
+            @ApiResponse(responseCode = "200", description = "PDF 생성 성공"),
+            @ApiResponse(responseCode = "403", description = "접근 권한 없음"),
+            @ApiResponse(responseCode = "404", description = "상담을 찾을 수 없음")
+    })
+    public ResponseEntity<byte[]> generateSingleCounselPdf(
+            @Parameter(description = "상담 ID", required = true)
+            @PathVariable Long counselId,
+            @AuthenticationPrincipal CustomUserDetails userDetails) {
+
+        log.info("개별 상담 PDF 생성 요청 - 사용자: {}, 상담ID: {}", userDetails.getUsername(), counselId);
+
+        try {
+            // CounselService를 통해 PDF 생성 (실제 데이터 사용)
+            byte[] pdfBytes = counselPdfService.generateSingleCounselPdf(userDetails.getUsername(), counselId);
+
+            // 파일명 생성 (상담ID_날짜.pdf)
+            String filename = String.format("counsel_report_%d_%s.pdf",
+                    counselId,
+                    LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyyMMdd_HHmmss")));
+
+            // HTTP 응답 헤더 설정
+            HttpHeaders headers = createPdfHeaders(filename, pdfBytes.length);
+
+            log.info("개별 상담 PDF 생성 완료 - 파일명: {}, 크기: {} bytes", filename, pdfBytes.length);
+
+            return ResponseEntity.ok()
+                    .headers(headers)
+                    .body(pdfBytes);
+
+        } catch (Exception e) {
+            log.error("개별 상담 PDF 생성 실패 - 상담ID: {}, 오류: {}", counselId, e.getMessage(), e);
+            throw e;
+        }
+    }
+
+    @GetMapping("/students/{studentId}/history/pdf")
+    @Operation(summary = "학생별 상담 이력 PDF 생성", description = "특정 학생의 모든 상담 이력을 PDF로 생성합니다.")
+    @ApiResponses({
+            @ApiResponse(responseCode = "200", description = "PDF 생성 성공"),
+            @ApiResponse(responseCode = "403", description = "접근 권한 없음"),
+            @ApiResponse(responseCode = "404", description = "상담 이력을 찾을 수 없음")
+    })
+    public ResponseEntity<byte[]> generateStudentCounselHistoryPdf(
+            @Parameter(description = "학생 ID", required = true)
+            @PathVariable Long studentId,
+            @AuthenticationPrincipal CustomUserDetails userDetails) {
+
+        log.info("학생 상담 이력 PDF 생성 요청 - 사용자: {}, 학생ID: {}", userDetails.getUsername(), studentId);
+
+        try {
+            // CounselService를 통해 PDF 생성 (실제 데이터 사용)
+            byte[] pdfBytes = counselPdfService.generateStudentCounselHistoryPdf(userDetails.getUsername(), studentId);
+
+            // 파일명 생성 (student_counsel_history_학생ID_날짜.pdf)
+            String filename = String.format("student_counsel_history_%d_%s.pdf",
+                    studentId,
+                    LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyyMMdd_HHmmss")));
+
+            // HTTP 응답 헤더 설정
+            HttpHeaders headers = createPdfHeaders(filename, pdfBytes.length);
+
+            log.info("학생 상담 이력 PDF 생성 완료 - 파일명: {}, 크기: {} bytes", filename, pdfBytes.length);
+
+            return ResponseEntity.ok()
+                    .headers(headers)
+                    .body(pdfBytes);
+
+        } catch (Exception e) {
+            log.error("학생 상담 이력 PDF 생성 실패 - 학생ID: {}, 오류: {}", studentId, e.getMessage(), e);
+            throw e;
+        }
+    }
+
+    /**
+     * PDF 응답을 위한 HTTP 헤더 생성
+     */
+    private HttpHeaders createPdfHeaders(String filename, int contentLength) {
+        HttpHeaders headers = new HttpHeaders();
+        headers.setContentType(MediaType.APPLICATION_PDF);
+        headers.setContentDispositionFormData("attachment", filename);
+        headers.setContentLength(contentLength);
+        headers.add("Cache-Control", "no-cache, no-store, must-revalidate");
+        headers.add("Pragma", "no-cache");
+        headers.add("Expires", "0");
+        return headers;
+    }
+}

src/main/java/com/neeis/neeis/domain/counsel/CounselCategory.java

@@ -0,0 +1,56 @@
+package com.neeis.neeis.domain.counsel.dto.pdf;
+
+import com.neeis.neeis.domain.counsel.Counsel;
+import lombok.Builder;
+import lombok.Getter;
+
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
+
+/**
+ * 상담 PDF 생성용 DTO
+ */
+@Getter
+@Builder
+public class CounselPdfDto {
+    private final String studentName;
+    private final String teacherName;
+    private final String category;
+    private final String counselDate;
+    private final String counselTime;
+    private final String content;
+    private final String nextPlan;
+    private final String generatedDate;
+
+
+    /**
+     * Counsel 엔티티를 PDF DTO로 변환
+     */
+    public static CounselPdfDto fromEntity(Counsel counsel) {
+
+        return CounselPdfDto.builder()
+                .studentName(counsel.getStudent().getName())
+                .teacherName(counsel.getTeacher().getName())
+                .category(getCategoryKoreanName(counsel.getCategory().name()))
+                .counselDate(counsel.getDateTime().format(DateTimeFormatter.ofPattern("yyyy년 MM월 dd일")))
+                .content(counsel.getContent())
+                .nextPlan(counsel.getNextPlan())
+                .generatedDate(counsel.getCreatedAt().format(DateTimeFormatter.ofPattern("yyyy년 MM월 dd일 HH시 mm분")))
+                .build();
+    }
+
+    /**
+     * 상담 카테고리 영문을 한글로 변환
+     */
+    private static String getCategoryKoreanName(String categoryName) {
+        return switch (categoryName) {
+            case "UNIVERSITY" -> "대학상담";
+            case "CAREER" -> "진로상담";
+            case "ACADEMIC" -> "학업상담";
+            case "PERSONAL" -> "개인상담";
+            case "FAMILY" -> "가정상담";
+            case "OTHER" -> "기타";
+            default -> categoryName;
+        };
+    }
+}