[SRLT-155] PDF AI 리포트 생성 및 완료 메일 PDF 첨부 발송

deploy/Dockerfile

@@ -6,6 +6,7 @@ RUN ./gradlew build -x test
 
 # 실행 단계
 FROM eclipse-temurin:21-jre-alpine AS runtime
+RUN apk add --no-cache font-noto font-noto-cjk ttf-dejavu
 WORKDIR /app
 COPY --from=builder /app/build/libs/*.jar app.jar
 EXPOSE 8080

gradle/spring.gradle

@@ -22,4 +22,8 @@ dependencies {
     // Emailclient
     implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
     implementation 'org.springframework.boot:spring-boot-starter-mail'
+
+    // HTML to PDF
+    implementation 'com.openhtmltopdf:openhtmltopdf-pdfbox:1.0.10'
+    implementation 'com.openhtmltopdf:openhtmltopdf-svg-support:1.0.10'
 }

src/main/java/starlight/adapter/member/persistence/MemberJpa.java

@@ -13,7 +13,6 @@
 import starlight.application.backoffice.member.required.dto.BackofficeUserSignupLookupResult;
 import starlight.application.backoffice.order.required.BackofficeOrderMemberLookupPort;
 import starlight.application.backoffice.order.required.dto.BackofficeOrderMemberLookupResult;
-import starlight.application.businessplan.required.MemberLookupPort;
 import starlight.application.member.required.MemberCommandPort;
 import starlight.application.member.required.MemberQueryPort;
 import starlight.domain.member.entity.Member;
@@ -28,7 +27,9 @@
 
 @Repository
 @RequiredArgsConstructor
-public class MemberJpa implements MemberQueryPort, MemberCommandPort, MemberLookupPort,
+public class MemberJpa implements MemberQueryPort, MemberCommandPort,
+        starlight.application.businessplan.required.MemberLookupPort,
+        starlight.application.aireport.required.MemberLookupPort,
         BackofficeOrderMemberLookupPort, BackofficeBusinessPlanMemberLookupPort,
         BackofficeUserMemberLookupPort {
 

src/main/java/starlight/adapter/shared/infrastructure/mail/SmtpMailClient.java

@@ -2,6 +2,7 @@
 
 import jakarta.mail.MessagingException;
 import jakarta.mail.internet.MimeMessage;
+import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.core.io.ByteArrayResource;
@@ -10,7 +11,7 @@
 import org.springframework.stereotype.Component;
 import org.thymeleaf.context.Context;
 import org.thymeleaf.spring6.SpringTemplateEngine;
-import starlight.application.aireport.AiReportReadyMailInput;
+import starlight.application.aireport.event.AiReportReadyMailInput;
 import starlight.application.aireport.required.AiReportMailPort;
 import starlight.application.backoffice.mail.provided.dto.input.BackofficeMailSendInput;
 import starlight.application.backoffice.mail.required.BackofficeMailPort;
@@ -19,11 +20,14 @@
 import starlight.domain.backoffice.exception.BackofficeErrorType;
 import starlight.domain.backoffice.exception.BackofficeException;
 import starlight.domain.backoffice.mail.BackofficeMailContentType;
+import starlight.domain.aireport.exception.AiReportErrorType;
+import starlight.domain.aireport.exception.AiReportException;
 import starlight.domain.expertApplication.exception.ExpertApplicationErrorType;
 import starlight.domain.expertApplication.exception.ExpertApplicationException;
 
 @Slf4j
 @Component
+@RequiredArgsConstructor
 public class SmtpMailClient implements BackofficeMailPort,
         FeedbackRequestMailPort,
         AiReportMailPort {
@@ -34,11 +38,6 @@ public class SmtpMailClient implements BackofficeMailPort,
     @Value("${spring.mail.username}")
     private String senderEmail;
 
-    public SmtpMailClient(JavaMailSender javaMailSender, SpringTemplateEngine templateEngine) {
-        this.javaMailSender = javaMailSender;
-        this.templateEngine = templateEngine;
-    }
-
     @Override
     public void send(BackofficeMailSendInput input, BackofficeMailContentType contentType) {
         try {
@@ -112,11 +111,13 @@ public void sendPdfAiReportReadyMail(AiReportReadyMailInput input) {
             helper.addAttachment(input.filename(), new ByteArrayResource(input.pdfBytes()));
 
             javaMailSender.send(message);
-            log.info("[MAIL] AI 리포트 완료 메일 발송 to={}", input.toEmail());
+            log.info("[MAIL] AI 리포트 완료 메일 발송 to={} attachmentBytes={}", input.toEmail(), input.pdfBytes().length);
         } catch (MessagingException e) {
             log.error("[MAIL] AI 리포트 완료 메일 발송 실패 to={}", input.toEmail(), e);
+            throw new AiReportException(AiReportErrorType.EMAIL_SEND_ERROR);
         } catch (Exception e) {
             log.error("[MAIL] AI 리포트 완료 메일 처리 실패 to={}", input.toEmail(), e);
+            throw new AiReportException(AiReportErrorType.EMAIL_SEND_ERROR);
         }
     }
 }

src/main/java/starlight/adapter/shared/infrastructure/pdf/PdfRenderer.java

@@ -0,0 +1,155 @@
+package starlight.adapter.shared.infrastructure.pdf;
+
+import com.openhtmltopdf.outputdevice.helper.BaseRendererBuilder;
+import com.openhtmltopdf.pdfboxout.PdfRendererBuilder;
+import com.openhtmltopdf.svgsupport.BatikSVGDrawer;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.apache.pdfbox.pdmodel.PDDocument;
+import org.apache.pdfbox.pdmodel.font.PDFont;
+import org.apache.pdfbox.pdmodel.font.PDType0Font;
+import org.springframework.core.io.ClassPathResource;
+import org.springframework.stereotype.Component;
+import org.thymeleaf.context.Context;
+import org.thymeleaf.spring6.SpringTemplateEngine;
+import starlight.adapter.shared.infrastructure.pdf.mapper.AiReportPdfViewMapper;
+import starlight.adapter.shared.infrastructure.pdf.view.AiReportPdfView;
+import starlight.application.aireport.provided.dto.AiReportResult;
+import starlight.application.aireport.required.AiReportPdfRenderPort;
+
+import java.io.ByteArrayOutputStream;
+import java.io.File;
+import java.io.InputStream;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.List;
+
+@Slf4j
+@Component
+@RequiredArgsConstructor
+public class PdfRenderer implements AiReportPdfRenderPort {
+
+    private static final String FONT_FAMILY = "PdfReportFont";
+    private static final List<String> CLASSPATH_FONTS = List.of(
+            "fonts/NotoSansKR-Regular.ttf"
+    );
+    private static final List<Path> SYSTEM_FONTS = List.of(
+            Path.of("C:\\Windows\\Fonts\\malgun.ttf"),
+            Path.of("/usr/share/fonts/truetype/nanum/NanumGothic.ttf"),
+            Path.of("/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc"),
+            Path.of("/usr/share/fonts/google-noto-cjk/NotoSansCJK-Regular.ttc")
+    );
+
+    private final SpringTemplateEngine templateEngine;
+    private final AiReportPdfViewMapper aiReportPdfViewMapper;
+
+    @Override
+    public byte[] render(AiReportResult report) {
+        try {
+            AiReportPdfView view = aiReportPdfViewMapper.toView(report);
+            Context context = new Context();
+            context.setVariable("totalScore", view.totalScore());
+            context.setVariable("sections", view.sections());
+            context.setVariable("strengths", view.strengths());
+            context.setVariable("weaknesses", view.weaknesses());
+            context.setVariable("radarChartSvg", view.radarChartSvg());
+
+            String html = templateEngine.process("pdf-ai-report", context);
+            ByteArrayOutputStream out = new ByteArrayOutputStream();
+            PdfRendererBuilder builder = new PdfRendererBuilder();
+            builder.useFastMode();
+            builder.useSVGDrawer(new BatikSVGDrawer());
+            configureFont(builder);
+            builder.withHtmlContent(html, null);
+            builder.toStream(out);
+            builder.run();
+            return out.toByteArray();
+        } catch (Exception e) {
+            log.error("[AI_REPORT_PDF] html to pdf render failed", e);
+            throw new IllegalStateException("AI 리포트 PDF 생성에 실패했습니다.", e);
+        }
+    }
+
+    private void configureFont(PdfRendererBuilder builder) {
+        for (String classpathFont : CLASSPATH_FONTS) {
+            if (registerClasspathFont(builder, classpathFont)) {
+                return;
+            }
+        }
+        for (Path systemFont : SYSTEM_FONTS) {
+            if (registerFileFont(builder, systemFont)) {
+                log.info("[AI_REPORT_PDF] using system font: {}", systemFont);
+                return;
+            }
+        }
+        throw new IllegalStateException(
+                "한글 PDF 폰트를 찾을 수 없습니다. classpath(" + CLASSPATH_FONTS + ") 또는 OS 폰트를 확인하세요."
+        );
+    }
+
+    private boolean registerClasspathFont(PdfRendererBuilder builder, String classpathLocation) {
+        try {
+            ClassPathResource resource = new ClassPathResource(classpathLocation);
+            if (!resource.exists()) {
+                return false;
+            }
+            File fontFile = copyFontToTemp(resource);
+            if (!isPdfBoxLoadableTrueType(fontFile.toPath())) {
+                log.warn("[AI_REPORT_PDF] skipping unsupported classpath font: {}", classpathLocation);
+                return false;
+            }
+            builder.useFont(fontFile, FONT_FAMILY, 400, BaseRendererBuilder.FontStyle.NORMAL, true);
+            return true;
+        } catch (Exception e) {
+            log.warn("[AI_REPORT_PDF] failed to load classpath font: {}", classpathLocation, e);
+            return false;
+        }
+    }
+
+    private boolean registerFileFont(PdfRendererBuilder builder, Path fontPath) {
+        if (!Files.isRegularFile(fontPath) || !isPdfBoxLoadableTrueType(fontPath)) {
+            return false;
+        }
+        try {
+            builder.useFont(fontPath.toFile(), FONT_FAMILY, 400, BaseRendererBuilder.FontStyle.NORMAL, true);
+            return true;
+        } catch (Exception e) {
+            log.warn("[AI_REPORT_PDF] failed to load system font: {}", fontPath, e);
+            return false;
+        }
+    }
+
+    private boolean isPdfBoxLoadableTrueType(Path fontPath) {
+        try {
+            if (!Files.isRegularFile(fontPath)) {
+                return false;
+            }
+            byte[] header = Files.readAllBytes(fontPath);
+            if (header.length < 4) {
+                return false;
+            }
+            if (header[0] == 'O' && header[1] == 'T' && header[2] == 'T' && header[3] == 'O') {
+                return false;
+            }
+            try (PDDocument document = new PDDocument()) {
+                PDFont font = PDType0Font.load(document, fontPath.toFile());
+                return font != null;
+            }
+        } catch (Exception e) {
+            log.debug("[AI_REPORT_PDF] font not loadable: {}", fontPath, e);
+            return false;
+        }
+    }
+
+    private File copyFontToTemp(ClassPathResource resource) throws Exception {
+        String suffix = resource.getFilename() != null && resource.getFilename().endsWith(".ttf")
+                ? ".ttf"
+                : ".font";
+        File temp = Files.createTempFile("pdf-report-font-", suffix).toFile();
+        temp.deleteOnExit();
+        try (InputStream in = resource.getInputStream()) {
+            Files.copy(in, temp.toPath(), java.nio.file.StandardCopyOption.REPLACE_EXISTING);
+        }
+        return temp;
+    }
+}