Upload 10 files

.gitattributes

@@ -46,3 +46,4 @@ dist/
 .tox/
 .ipynb_checkpoints
 .vscode/
+NanumGothic.ttf filter=lfs diff=lfs merge=lfs -text

NanumGothic.ttf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:48a28e97b34fc8e5b157657633670cd1b7de126cfc414da65ce9c3d5bc8be733
+size 4691820

README.md

@@ -4,7 +4,7 @@ emoji: 🔥
 colorFrom: blue
 colorTo: purple
 sdk: streamlit
-sdk_version: 1.45.1
+sdk_version: 1.43.2
 app_file: app.py
 pinned: false
 license: cc

app.py

@@ -1,183 +1,25 @@
-import os
-import time
-import streamlit as st
-from PIL import Image  # Pillow is imported but not used, let's keep it for potential future image features
-import google.generativeai as genai
-from streamlit_extras.colored_header import colored_header
-import markdown
-import PyPDF2  # PDF 처리 라이브러리
-
-# Google Gemini API 키 설정
-genai.configure(api_key=os.environ["GEMINI_API_KEY"])
-
-# 모델 설정
-generation_config = {
-    "temperature": 0.7, # 보고서/계획서 톤에 맞춰 temperature 낮춤
-    "top_p": 0.95,
-    "top_k": 40,
-    "max_output_tokens": 10000,
-    "response_mime_type": "text/plain",
-}
-
-model = genai.GenerativeModel(
-    model_name="gemini-2.0-flash-exp", # 필요에 따라 모델 변경
-    generation_config=generation_config,
+from controller import click_generate_btn
+from view import (
+    display_header,
+    display_file_uploaders,
+    display_instructions_input,
+    display_generate_button,
+    display_faq,
 )
 
-# PDF 텍스트 추출 함수 (기존 함수 재활용)
-def extract_text_from_pdf(uploaded_pdf_file):
-    """PDF 파일에서 텍스트를 추출합니다."""
-    text = ""
-    if uploaded_pdf_file is not None: # 파일이 업로드되었는지 확인
-        try:
-            pdf_reader = PyPDF2.PdfReader(uploaded_pdf_file)
-            for page_num in range(len(pdf_reader.pages)):
-                page = pdf_reader.pages[page_num]
-                text += page.extract_text()
-        except Exception as e:
-            st.error(f"PDF 파일 처리 오류: {e}")
-            return None
-    return text
-
-def generate_report_or_plan(pdf_template_text, reference_pdf_text, user_instructions):
-    """
-    PDF 템플릿, 참고 PDF, 사용자 지시사항을 기반으로 보고서 또는 계획서를 생성합니다.
-    """
-    full_text = ""
-    try:
-        prompt_text = f"""
-        # 계획서 또는 보고서 작성
-
-        ## PDF 서식 파일 내용:
-        ```
-        {pdf_template_text}
-        ```
-
-        """
-        if reference_pdf_text: # 참고 파일 내용이 있을 경우에만 추가
-            prompt_text += f"""
-        ## 참고 파일 PDF 내용:
-        ```
-        {reference_pdf_text}
-        ```
-            """
-
-        prompt_text += f"""
-        ## 사용자 지시사항:
-        {user_instructions}
-
-        ---
-
-        **지시사항에 따라 PDF 템플릿{", 참고 PDF" if reference_pdf_text else ""}를 분석하고, 내용을 채워 계획서 또는 보고서를 작성하세요.**
-        **한국어로 작성하며, 명확하고 논리적인 구조로 작성해주세요.**
-        **템플릿 양식에 맞춰 내용을 작성하고, 필요하다면 추가적인 정보나 내용을 생성해도 좋습니다.**
-        **만약 템플릿 내용이 부족하거나 지시사항을 수행하기 어렵다면, 솔직하게 답변해주세요.**
-        **학교 사업 계획서, 교육 활동 계획서, 프로젝트 학습 계획서 등 교육 관련 계획서 및 보고서 작성에 특화되어 있습니다.**
-        """
-
-        response = model.generate_content([prompt_text])
-        for chunk in response.text:
-            full_text += chunk
-            time.sleep(0.01)
-            st.session_state.generated_result += chunk
-            output_area.markdown(st.session_state.generated_result, unsafe_allow_html=True)
-    except Exception as e:
-        st.error(f"보고서/계획서 생성 중 오류 발생: {str(e)}")
-    return full_text
 
-# Streamlit 인터페이스 설정
-colored_header(
-    label="계획서 보고서 작성 AI",
-    description="PDF 서식 및 참고 파일을 업로드하고 지시사항을 입력하면 계획서 또는 보고서를 작성해줍니다.",
-    color_name="blue-70",
+# --- UI 랜더링 ---
+display_header()
+uploaded_template_file, uploaded_reference_file = display_file_uploaders()
+user_instructions = display_instructions_input()
+generate_button_clicked = display_generate_button()
+display_faq()
+
+click_generate_btn(
+    (
+        uploaded_template_file,
+        uploaded_reference_file,
+        user_instructions,
+        generate_button_clicked,
+    )
 )
-
-# 파일 업로드 버튼 (PDF 파일만 허용)
-uploaded_pdf_template_file = st.file_uploader("PDF 서식 파일 업로드", type=["pdf"])
-uploaded_reference_pdf_file = st.file_uploader("참고 파일 PDF 업로드 (선택 사항)", type=["pdf"]) # 참고 파일 업로드 추가
-
-# 지시사항 입력 텍스트 영역 추가 (placeholder, height 조정)
-user_instructions = st.text_area(
-    "작성 지시사항 입력",
-    placeholder="""예시:
-- 이 PDF 템플릿을 사용하여 2025학년도 1-1-1 프로젝트 학습 계획 초안을 작성해주세요. 핵심 목표는 학생 중심 교육 강화입니다. 성취 기준은...
-- [참고 파일 PDF] 제출된 교육 활동 계획서 PDF를 참고하여, 계획의 타당성을 분석하고, 개선점을 3가지 제안해주세요.
-- 이 프로젝트 학습 계획서 템플릿을 사용하여, '기후 변화와 우리'라는 주제로 5학년 학생 대상의 프로젝트 학습 계획서를 작성해주세요. 탐구 단계를 구체적으로 작성해주세요.
-""",
-    height=200 # 높이 조정
-)
-
-generate_button = st.button("보고서/계획서 생성")
-
-output_area = st.empty()
-
-if generate_button and uploaded_pdf_template_file and user_instructions:
-    try:
-        pdf_template_text = extract_text_from_pdf(uploaded_pdf_template_file)
-        reference_pdf_text = extract_text_from_pdf(uploaded_reference_pdf_file) # 참고 파일 텍스트 추출
-
-        if pdf_template_text:
-            st.session_state.generated_result = ""
-            with st.spinner("보고서/계획서 생성 중..."): # 로딩 스피너 추가
-                result = generate_report_or_plan(pdf_template_text, reference_pdf_text, user_instructions) # 참고 파일 텍스트 추가
-
-            html_text = markdown.markdown(result, extensions=['tables'])
-            output_area.markdown(html_text, unsafe_allow_html=True)
-
-        else:
-            st.warning("PDF 서식 파일에서 텍스트를 추출하는데 실패했습니다. 파일 형식을 확인해주세요.")
-
-    except Exception as e:
-        st.error(f"보고서/계획서 생성 중 오류 발생: {str(e)}")
-
-elif generate_button and not uploaded_pdf_template_file:
-    st.warning("PDF 서식 파일을 업로드하세요.")
-elif generate_button and not user_instructions:
-    st.warning("작성 지시사항을 입력하세요.")
-
-
-# FAQ (계획서 보고서 작성에 맞게 수정)
-with st.expander("❓ 계획서 보고서 작성 AI FAQ"):
-    st.write("""
-        **Q1. 계획서 보고서 작성 AI는 어떤 기능을 제공하나요?**
-
-        A. 이 앱은 학교에서 필요한 다양한 **계획서 및 보고서** 작성을 돕기 위해 개발된 AI 도구입니다. PDF 서식 파일, **참고 파일 PDF (선택 사항)**, 그리고 작성 지시사항을 입력하면, AI가 서식에 맞춰 계획서 또는 보고서 초안을 생성합니다.  사업 계획서, 교육 활동 계획서, 프로젝트 학습 계획서, 각종 보고서 등 다양한 문서 작성을 지원합니다.  생성된 초안은 필요에 따라 수정 및 보완하여 완성할 수 있습니다.
-
-        **Q2. 어떤 종류의 계획서 및 보고서 작성을 지원하나요?**
-
-        A.  주로 학교 현장에서 사용되는 계획서 및 보고서 작성을 지원합니다. 예시는 다음과 같습니다:
-        * **사업 계획서:** 학교 발전 계획, 특정 사업 운영 계획 등
-        * **교육 활동 계획서:**  수업 계획, 방과후학교 운영 계획, 창의적 체험활동 계획 등
-        * **프로젝트 학습 계획서:**  학생 주도 프로젝트 학습 운영 계획
-        * **각종 보고서:**  활동 결과 보고서, 사업 결과 보고서, 평가 보고서 등
-        * (향후 지원 확대 예정)
-
-        **Q3. PDF 서식 파일은 어떻게 활용하나요?**
-
-        A.  **PDF 서식 파일은 계획서 또는 보고서의 템플릿 역할**을 합니다.  기존에 사용하던 서식 파일(.pdf)을 업로드하면, AI가 해당 서식에 맞춰 내용을 채워줍니다.  별도의 서식 파일 없이 백지 상태에서 내용을 생성하고 싶다면, 비어있는 PDF 파일을 업로드하거나, 지시사항에 '자유 형식으로 작성해줘' 와 같이 요청할 수 있습니다.
-
-        **Q3-1. 참고 파일 PDF는 어떻게 활용하나요?**
-
-        A. **참고 파일 PDF는 AI가 보고서/계획서를 작성할 때 참고할 추가 정보**를 제공합니다.  예를 들어, '참고 파일 PDF를 바탕으로 ~를 분석해주세요' 와 같은 지시사항과 함께 참고 PDF를 업로드하면, AI가 해당 PDF 내용을 분석하여 보고서/계획서 작성에 활용합니다.  **참고 파일 PDF는 선택 사항**이며, 필수가 아닙니다.
-
-        **Q4.  작성 지시사항은 어떻게 입력해야 하나요?**
-
-        A.  **구체적이고 명확하게 지시사항을 입력**할수록 AI가 더 정확하게 이해하고 원하는 결과물을 생성할 수 있습니다.  다음과 같은 내용을 포함하여 지시사항을 작성해보세요:
-        * **작성할 문서의 종류:** (예: 2025학년도 각종 사업 계획서, OOO 프로젝트 보고서,  OOO 교육 활동 계획서 초안)
-        * **주요 내용 및 핵심 목표:** (예:  학생 중심 교육 강화,  창의적 체험활동 활성화,  OOO 사업 성과 분석)
-        * **참고 자료:** (**참고 파일 PDF** 외에 추가적으로 참고할 내용이 있다면 간략하게 언급, **참고 파일 PDF 활용 지시 포함**)
-        * **특정 양식 요청:** (예:  표 형식으로 작성,  핵심 내용만 요약,  자유 형식으로 작성)
-        * **분량:** (예:  A4 2장 내외로 요약)
-
-        **Q5. 계획서/보고서 생성 후 수정은 어떻게 하나요?**
-
-        A. 계획서/보고서 생성 후, 하단 출력 내용을 확인��고, 필요한 경우 **텍스트를 선택하여 복사**한 후, 워드프로세서(MS Word, 한글 등)에 붙여넣어 수정할 수 있습니다.  향후 챗봇 기능을 추가하여 앱 내에서 직접 수정하고 추가적인 요청을 할 수 있도록 개선할 예정입니다.
-
-        **Q6.  PDF 파일 텍스트 추출 오류가 발생할 경우 어떻게 해야 하나요?**
-
-        A.  PDF 파일이 이미지 형태로 스캔된 경우, 텍스트 추출이 제대로 이루어지지 않을 수 있습니다.  가능하다면 **텍스트 기반 PDF 파일**을 사용하거나, OCR (광학 문자 인식) 기능을 활용하여 텍스트를 추출한 후 다시 시도해보세요.  향후 OCR 기능 내장 또는 PDF 텍스트 추출 성능 향상을 위해 지속적으로 개선할 예정입니다.
-
-        **Q7.  지원하는 출력 형식은 무엇인가요?**
-
-        A.  현재는 **Markdown 형식**으로 결과를 출력합니다.  향후 **Word 문서(.docx) 다운로드** 기능을 추가하여 사용 편의성을 높일 계획입니다.  PDF 다운로드 기능은 추후 검토하겠습니다.
-    """)

controller.py

@@ -0,0 +1,96 @@
+import markdown
+import time  # For small delay in streaming view
+import view
+import model
+
+
+def click_generate_btn(props):
+    (
+        uploaded_template_file,
+        uploaded_reference_file,
+        user_instructions,
+        generate_button_clicked,
+    ) = props
+    if generate_button_clicked:
+        # 새 결과 생성 시 이전 세션 값 초기화
+        view.st.session_state.pop("last_result_md", None)
+        view.st.session_state.pop("last_docx_data", None)
+
+        # 1. 입력 유효성 검사
+        if not uploaded_template_file:
+            view.display_warning("PDF 서식 파일을 업로드하세요.")
+        elif not user_instructions:
+            view.display_warning("작성 지시사항을 입력하세요.")
+        else:
+            # 2. PDF 텍스트 추출
+            template_text = model.extract_text_from_pdf(uploaded_template_file)
+            reference_text = model.extract_text_from_pdf(
+                uploaded_reference_file
+            )  # Returns None if no file
+
+            if not template_text:
+                view.display_warning(
+                    "PDF 서식 파일에서 텍스트를 추출하지 못했습니다. 파일 내용을 확인해주세요."
+                )
+            else:
+                # 3. 결과 영역 준비
+                results_container, results_placeholder = view.display_results_area()
+
+                # 4. 콘텐츠 생성 (스트리밍) 및 표시
+                full_response_md = ""
+                error_occurred = False
+                try:
+                    with view.display_spinner("보고서/계획서 생성 중..."):
+                        for chunk in model.generate_content_from_gemini(
+                            template_text, reference_text, user_instructions
+                        ):
+                            full_response_md += chunk
+                            view.update_results_stream(
+                                results_placeholder, full_response_md
+                            )
+                            time.sleep(0.01)
+
+                        if "오류 발생:" in full_response_md:
+                            error_occurred = True
+
+                    # ✅ 결과 저장
+                    view.st.session_state["last_result_md"] = full_response_md
+
+                except Exception as e:
+                    error_occurred = True
+                    view.display_error(f"콘텐츠 생성 중 심각한 오류 발생: {e}")
+                    full_response_md = f"오류: {e}"
+
+                # 5. 최종 결과 처리 및 DOCX 생성/다운로드 버튼 표시
+                if not error_occurred and full_response_md:
+                    final_html = markdown.markdown(
+                        full_response_md, extensions=["tables", "fenced_code"]
+                    )
+                    view.display_final_result(results_placeholder, final_html)
+
+                    title, docx_data = model.markdown_to_docx(full_response_md)
+                    if docx_data:
+                        # 결과는 유지하면서 다운로드 버튼 표시
+                        view.st.session_state["last_docx_data"] = docx_data
+                        view.display_download_button(title, docx_data)
+                    else:
+                        view.display_warning("결과를 DOCX로 변환하는 데 실패했습니다.")
+
+                # 결과 복원
+                # if (
+                #     "last_result_md" in view.st.session_state
+                #     and not generate_button_clicked
+                # ):
+                #     prev_html = markdown.markdown(
+                #         view.st.session_state["last_result_md"],
+                #         extensions=["tables", "fenced_code"],
+                #     )
+                #     results_container, result_placeholder = view.display_results_area()
+                #     view.display_final_result(result_placeholder, prev_html)
+
+                #     if "last_docx_data" in view.st.session_state:
+                #         view.display_download_button(
+                #             results_container,
+                #             view.st.session_state["last_docx_data"],
+                #             key="download_button_restored",
+                #         )

devcontainer.json

@@ -0,0 +1,33 @@
+{
+  "name": "Python 3",
+  // Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+  "image": "mcr.microsoft.com/devcontainers/python:1-3.11-bullseye",
+  "customizations": {
+    "codespaces": {
+      "openFiles": [
+        "README.md",
+        "app.py"
+      ]
+    },
+    "vscode": {
+      "settings": {},
+      "extensions": [
+        "ms-python.python",
+        "ms-python.vscode-pylance"
+      ]
+    }
+  },
+  "updateContentCommand": "[ -f packages.txt ] && sudo apt update && sudo apt upgrade -y && sudo xargs apt install -y <packages.txt; [ -f requirements.txt ] && pip3 install --user -r requirements.txt; pip3 install --user streamlit; echo '✅ Packages installed and Requirements met'",
+  "postAttachCommand": {
+    "server": "streamlit run app.py --server.enableCORS false --server.enableXsrfProtection false"
+  },
+  "portsAttributes": {
+    "8501": {
+      "label": "Application",
+      "onAutoForward": "openPreview"
+    }
+  },
+  "forwardPorts": [
+    8501
+  ]
+}

gitignore.txt

@@ -0,0 +1,5 @@
+.env
+__pycache__
+.vscode
+*.pdf
+*.zip

model.py

@@ -0,0 +1,280 @@
+import os
+import google.generativeai as genai
+import PyPDF2
+import io
+import platform
+import re
+from typing import Tuple
+
+from docx import Document
+from docx.shared import Pt
+
+from utils import get_api_key
+
+# --- Initialization ---
+API_KEY = get_api_key()
+
+if not API_KEY:
+    raise ValueError("GEMINI_API_KEY가 .env 파일에 설정되지 않았습니다.")
+
+genai.configure(api_key=API_KEY)
+
+# --- Configuration ---
+GENERATION_CONFIG = {
+    "temperature": 0.7,
+    "top_p": 0.95,
+    "top_k": 40,
+    "max_output_tokens": 10000,
+    "response_mime_type": "text/plain",
+}
+
+# --- Model Instantiation ---
+# Using a recommended model, adjust if needed
+llm_model = genai.GenerativeModel(
+    model_name="gemini-1.5-flash",  # or "gemini-pro" if preferred
+    generation_config=GENERATION_CONFIG,
+)
+
+
+# --- Font Path Setup ---
+# 운영체제별 한글 폰트 설정
+def get_system_font():
+    system = platform.system()
+    if system == "Darwin":  # macOS
+        return "AppleGothic"
+    elif system == "Linux":
+        return "NanumGothic"
+    elif system == "Windows":
+        return "Malgun Gothic"
+    else:
+        return "Arial"  # 기본 폰트
+
+
+SYSTEM_FONT = get_system_font()
+
+# model.py 파일이 위치한 디렉토리를 기준으로 fonts 폴더 경로 설정
+BASE_DIR = os.path.dirname(os.path.abspath(__file__))
+FONT_ROOT = os.path.join(BASE_DIR, "fonts")
+
+
+# --- Core Logic Functions ---
+def extract_text_from_pdf(uploaded_pdf_file):
+    """PDF 파일 객체에서 텍스트를 추출합니다."""
+    text = ""
+    if uploaded_pdf_file is None:
+        return None
+    try:
+        # Reset buffer position for reading
+        uploaded_pdf_file.seek(0)
+        pdf_reader = PyPDF2.PdfReader(uploaded_pdf_file)
+        for page in pdf_reader.pages:
+            try:
+                page_text = page.extract_text()
+                if page_text:
+                    text += page_text
+            except Exception:
+                # Log or handle page-specific extraction errors if needed
+                continue  # Continue to next page even if one fails
+        return text if text else None  # Return None if no text extracted
+    except Exception as e:
+        print(f"PDF 텍스트 추출 오류: {e}")  # Log error
+        return None  # Return None on error
+
+
+def generate_content_from_gemini(template_text, reference_text, instructions):
+    """Gemini 모델을 사용하여 콘텐츠 생성을 스트리밍 방식으로 처리합니다."""
+    prompt_text = f"""
+# 계획서 또는 보고서 작성
+
+## PDF 서식 파일 내용:
+{template_text}
+
+"""
+    if reference_text:
+        prompt_text += f"""
+## 참고 파일 PDF 내용:
+{reference_text}
+
+"""
+
+    prompt_text += f"""
+## 사용자 지시사항:
+{instructions}
+
+---
+
+**지시사항에 따라 PDF 템플릿{", 참고 PDF" if reference_text else ""}를 분석하고, 내용을 채워 계획서 또는 보고서를 작성하세요.**
+**한국어로 작성하며, 명확하고 논리적인 구조로 작성해주세요.**
+**템플릿 양식에 맞춰 내용을 작성하고, 필요하다면 추가적인 정보나 내용을 생성해도 좋습니다.**
+**만약 템플릿 내용이 부족하거나 지시사항을 수행하기 어렵다면, 솔직하게 답변해주세요.**
+**학교 사업 계획서, 교육 활동 계획서, 프로젝트 학습 계획서 등 교육 관련 계획서 및 보고서 작성에 특화되어 있습니다.**
+**표(테이블)가 필요한 경우 마크다운 테이블 형식으로 생성해주세요.**
+"""
+    try:
+        # stream=True로 설정하여 응답을 청크 단위로 받음
+        response_stream = llm_model.generate_content([prompt_text], stream=True)
+        for chunk in response_stream:
+            # Check if the chunk has text content and it's not empty
+            if hasattr(chunk, "text") and chunk.text:
+                yield chunk.text  # 각 텍스트 청크를 반환 (yield)
+    except Exception as e:
+        print(f"Gemini API 호출 오류: {e}")  # Log error
+        yield f"\n\n오류 발생: 콘텐츠 생성 중 문제가 발생했습니다. ({e})"  # Yield error message
+
+
+def markdown_to_docx(markdown_text: str) -> Tuple[str, io.BytesIO]:
+    """마크다운 텍스트를 docx 문서로 변환하여 BytesIO로 반환합니다."""
+    doc = Document()
+
+    # 기본 스타일 설정
+    style = doc.styles["Normal"]
+    font = style.font
+    font.name = "Malgun Gothic"  # 시스템에 맞게 조정 가능
+    font.size = Pt(11)
+
+    lines = markdown_text.strip().splitlines()
+    table_mode = False
+    table_rows = []
+    tables = []
+    title = ""
+
+    def parse_inline_styles(paragraph, text):
+        """텍스트 내 인라인 스타일 처리: **bold**, *italic*, ***both***"""
+        pattern = r"(\*\*\*.*?\*\*\*|\*\*.*?\*\*|\*.*?\*)"
+        parts = re.split(pattern, text)
+        for part in parts:
+            run = paragraph.add_run(re.sub(r"[*]", "", part))  # 기본 텍스트
+            if part.startswith("***") and part.endswith("***"):
+                run.bold = True
+                run.italic = True
+            elif part.startswith("**") and part.endswith("**"):
+                run.bold = True
+            elif part.startswith("*") and part.endswith("*"):
+                run.italic = True
+
+    i = 0
+    while i < len(lines):
+        line = lines[i].strip()
+        if not line:
+            i += 1
+            continue
+
+        # 제목
+        if line.startswith("#"):
+            level = min(line.count("#"), 4)
+            text = line.lstrip("#").strip()
+            doc.add_heading(text, level=level)
+            table_mode = False
+
+        # 리스트
+        elif line.startswith(("- ", "* ")):
+            doc.add_paragraph(line[2:].strip(), style="List Bullet")
+            table_mode = False
+
+        elif re.match(r"^\d+\.\s", line):
+            doc.add_paragraph(re.sub(r"^\d+\.\s", "", line), style="List Number")
+            table_mode = False
+
+        # 테이블 감지
+        elif "|" in line:
+            row = [cell.strip() for cell in line.split("|") if cell.strip()]
+            table_rows.append(row)
+
+            # 다음 줄이 헤더 구분줄(---)인지 확인
+            if i + 1 < len(lines):
+                next_line = lines[i + 1].strip()
+                if re.match(r"^\s*\|?\s*:?-+:?\s*(\|\s*:?-+:?\s*)+\|?\s*$", next_line):
+                    i += 1  # 구분선은 건너뛰기
+                    table_rows.append("__HEADER__")  # 마커로 표시
+
+        else:
+            # 이전 테이블 처리
+            if table_rows:
+                header_style = []
+                if "__HEADER__" in table_rows:
+                    header_index = table_rows.index("__HEADER__")
+                    headers = table_rows[header_index - 1]
+                    data_rows = table_rows[header_index + 1 :]
+                    all_rows = [headers] + data_rows
+                    header_style = [True] + [False] * len(data_rows)
+                else:
+                    all_rows = table_rows
+                    header_style = [False] * len(all_rows)
+
+                num_rows = len(all_rows)
+                num_cols = max(len(row) for row in all_rows)
+                table = doc.add_table(rows=num_rows, cols=num_cols)
+                table.style = "Table Grid"
+
+                for r, row in enumerate(all_rows):
+                    for c, cell in enumerate(row):
+                        cell_text = cell
+                        cell_obj = table.cell(r, c)
+                        cell_obj.text = cell_text
+                        for run in cell_obj.paragraphs[0].runs:
+                            run.font.name = "Malgun Gothic"
+                            if header_style[r]:
+                                run.bold = True
+                table_rows = []
+
+            # 일반 문단
+            p = doc.add_paragraph()
+            parse_inline_styles(p, line)
+
+        if not title:
+            title = get_title(line)
+        i += 1
+
+    # 혹시 마지막 줄이 테이블이면 처리
+    if table_rows:
+        all_rows = table_rows
+        num_rows = len(all_rows)
+        num_cols = max(len(row) for row in all_rows)
+        table = doc.add_table(rows=num_rows, cols=num_cols)
+        table.style = "Table Grid"
+        for r, row in enumerate(all_rows):
+            for c, cell in enumerate(row):
+                cell_obj = table.cell(r, c)
+                cell_obj.text = cell
+                for run in cell_obj.paragraphs[0].runs:
+                    run.font.name = "Malgun Gothic"
+
+    # 결과 저장
+    buffer = io.BytesIO()
+    doc.save(buffer)
+    buffer.seek(0)
+    return (title, buffer)
+
+
+def get_title(line):
+    match = re.match(r"^#+\s*(.*)", line)  # Heading tag
+    if match:
+        return match.group(1).strip()
+
+    match = re.match(r"^-+\s*(.*)", line)  # Unordered list tag
+    if match:
+        return match.group(1).strip()
+
+    match = re.match(r"^\d+\.\s*(.*)", line)  # Ordered list tag
+    if match:
+        return match.group(1).strip()
+
+    match = re.match(r"^>\s*(.*)", line)  # Blockquote tag
+    if match:
+        return match.group(1).strip()
+
+    match = re.match(r"^`{3}.*", line)  # Code block start
+    if match:
+        return ""  # Code block 시작 줄은 텍스트로 간주하지 않음
+
+    match = re.match(r"^\|.*\|$", line)  # Table row
+    if match:
+        # 테이블 행 내부의 텍스트를 추출 (간단하게 처리)
+        cells = [cell.strip() for cell in line.strip("|").split("|")]
+        return " ".join(cells)
+
+    match = re.match(r"^[*_]{1,3}(.*?)[*_]{1,3}$", line)  # Bold, italic
+    if match:
+        return match.group(1).strip()
+
+    return line.strip()

requirements.txt

@@ -1,6 +1,6 @@
 streamlit
-Pillow
 google-generativeai
 streamlit-extras
 markdown
-PyPDF2
+PyPDF2
+python-docx

utils.py

@@ -0,0 +1,6 @@
+import os
+
+
+def get_api_key():
+    """환경 변수에서 API 키를 가져옵니다."""
+    return os.environ.get("GEMINI_API_KEY")

view.py

@@ -0,0 +1,127 @@
+import streamlit as st
+from streamlit_extras.colored_header import colored_header
+
+
+def display_header():
+    """페이지 상단의 헤더를 표시합니다."""
+    colored_header(
+        label="계획서 보고서 작성 AI",  # Title updated slightly
+        description="PDF 서식 및 참고 파일을 업로드하고 지시사항을 입력하면 계획서 또는 보고서를 작성해줍니다.",
+        color_name="blue-70",
+    )
+
+
+def display_file_uploaders():
+    """PDF 파일 업로더 위젯들을 표시하고 업로드된 파일 객체들을 반환합니다."""
+    uploaded_template = st.file_uploader(
+        "PDF 서식 파일 업로드", type=["pdf"], key="template_uploader"
+    )
+    uploaded_reference = st.file_uploader(
+        "참고 파일 PDF 업로드 (선택 사항)", type=["pdf"], key="reference_uploader"
+    )
+    return uploaded_template, uploaded_reference
+
+
+def display_instructions_input():
+    """사용자 지시사항 입력 영역 위젯을 표시하고 입력된 텍스트를 반환합니다."""
+    instructions = st.text_area(
+        "작성 지시사항 입력",
+        placeholder="""예시:
+- 이 PDF 템플릿을 사용하여 2025학년도 1-1-1 프로젝트 학습 계획 초안을 작성해주세요. 핵심 목표는 학생 중심 교육 강화입니다. 성취 기준은...
+- [참고 파일 PDF] 제출된 교육 활동 계획서 PDF를 참고하여, 계획의 타당성을 분석하고, 개선점을 3가지 제안해주세요.
+- 이 프로젝트 학습 계획서 템플릿을 사용하여, '기후 변화와 우리'라는 주제로 5학년 학생 대상의 프로젝트 학습 계획서를 작성해주세요. 탐구 단계를 구체적으로 작성해주세요.
+""",
+        height=200,
+        key="instructions_input",
+    )
+    return instructions
+
+
+def display_generate_button():
+    """'보고서/계획서 생성' 버튼 위젯을 표시하고 클릭 여부를 반환합니다."""
+    return st.button("보고서/계획서 생성", key="generate_button")
+
+
+def display_results_area():
+    """결과 표시를 위한 컨테이너와 빈 영역(placeholder)을 생성하고 반환합니다."""
+    container = st.container()
+    with container:
+        results_placeholder = st.empty()
+    return container, results_placeholder  # Return both container and placeholder
+
+
+def update_results_stream(placeholder, current_text):
+    """스트리밍 중인 텍스트를 결과 영역에 업데이트합니다."""
+    placeholder.markdown(
+        current_text + "▌", unsafe_allow_html=True
+    )  # Add cursor effect
+
+
+def display_final_result(placeholder, html_content):
+    """최종 결과를 HTML 형식으로 결과 영역에 표시합니다."""
+    placeholder.markdown(html_content, unsafe_allow_html=True)
+
+
+def display_download_button(title, docx_data):
+    """DOCX 다운로드 버튼을 표시합니다. 기존 컨테이너의 내용을 유지합니다."""
+    # 새 컨테이너를 생성하여 다운로드 버튼만 표시
+    download_container = st.container()
+    with download_container:
+        st.download_button(
+            label="📄 DOCX로 다운로드",
+            data=docx_data,
+            file_name=f"{title}.docx",
+            # mime="application/docx",
+            mime="application/vnd.openxmlformats-officedocument.wordprocessingml.document",  # 정확한 MIME 타입
+            key="download_button",
+        )
+
+
+def display_error(message):
+    """에러 메시지를 표시합니다."""
+    st.error(message)
+
+
+def display_warning(message):
+    """경고 메시지를 표시합니다."""
+    st.warning(message)
+
+
+def display_spinner(message="처리 중..."):
+    """스피너(로딩 표시) 컨텍스트를 반환합니다."""
+    return st.spinner(message)
+
+
+def display_faq():
+    with st.expander("❓ 계획서 보고서 작성 AI FAQ"):
+        st.write(
+            """
+            **Q1. 계획서 보고서 작성 AI는 어떤 기능을 제공하나요?**
+            A. 이 앱은 학교에서 필요한 다양한 **계획서 및 보고서** 작성을 돕기 위해 개발된 AI 도구입니다. PDF 서식 파일, **참고 파일 PDF (선택 사항)**, 그리고 작성 지시사항을 입력하면, AI가 서식에 맞춰 계획서 또는 보고서 초안을 생성합니다.  사업 계획서, 교육 활동 계획서, 프로젝트 학습 계획서, 각종 보고서 등 다양한 문서 작성을 지원합니다.  생성된 초안은 필요에 따라 수정 및 보완하여 완성할 수 있습니다.
+            **Q2. 어떤 종류의 계획서 및 보고서 작성을 지원하나요?**
+            A.  주로 학교 현장에서 사용되는 계획서 및 보고서 작성을 지원합니다. 예시는 다음과 같습니다:
+            * **사업 계획서:** 학교 발전 계획, 특정 사업 운영 계획 등
+            * **교육 활동 계획서:**  수업 계획, 방과후학교 운영 계획, 창의적 체험활동 계획 등
+            * **프로젝트 학�� 계획서:**  학생 주도 프로젝트 학습 운영 계획
+            * **각종 보고서:**  활동 결과 보고서, 사업 결과 보고서, 평가 보고서 등
+            * (향후 지원 확대 예정)
+            **Q3. PDF 서식 파일은 어떻게 활용하나요?**
+            A.  **PDF 서식 파일은 계획서 또는 보고서의 템플릿 역할**을 합니다.  기존에 사용하던 서식 파일(.pdf)을 업로드하면, AI가 해당 서식에 맞춰 내용을 채워줍니다.  별도의 서식 파일 없이 백지 상태에서 내용을 생성하고 싶다면, 비어있는 PDF 파일을 업로드하거나, 지시사항에 '자유 형식으로 작성해줘' 와 같이 요청할 수 있습니다.
+            **Q3-1. 참고 파일 PDF는 어떻게 활용하나요?**
+            A. **참고 파일 PDF는 AI가 보고서/계획서를 작성할 때 참고할 추가 정보**를 제공합니다.  예를 들어, '참고 파일 PDF를 바탕으로 ~를 분석해주세요' 와 같은 지시사항과 함께 참고 PDF를 업로드하면, AI가 해당 PDF 내용을 분석하여 보고서/계획서 작성에 활용합니다.  **참고 파일 PDF는 선택 사항**이며, 필수가 아닙니다.
+            **Q4.  작성 지시사항은 어떻게 입력해야 하나요?**
+            A.  **구체적이고 명확하게 지시사항을 입력**할수록 AI가 더 정확하게 이해하고 원하는 결과물을 생성할 수 있습니다.  다음과 같은 내용을 포함하여 지시사항을 작성해보세요:
+            * **작성할 문서의 종류:** (예: 2025학년도 각종 사업 계획서, OOO 프로젝트 보고서,  OOO 교육 활동 계획서 초안)
+            * **주요 내용 및 핵심 목표:** (예:  학생 중심 교육 강화,  창의적 체험활동 활성화,  OOO 사업 성과 분석)
+            * **참고 자료:** (**참고 파일 PDF** 외에 추가적으로 참고할 내용이 있다면 간략하게 언급, **참고 파일 PDF 활용 지시 포함**)
+            * **특정 양식 요청:** (예:  표 형식으로 작성,  핵심 내용만 요약,  자유 형식으로 작성)
+            * **분량:** (예:  A4 2장 내외로 요약)
+            **Q5. 계획서/보고서 생성 후 수정은 어떻게 하나요?**
+            A. 계획서/보고서 생성 후, 하단 출력 내용을 확인하고, 필요한 경우 **텍스트를 선택하여 복사**한 후, 워드프로세서(MS Word, 한글 등)에 붙여넣어 수정할 수 있습니다.  향후 챗봇 기능을 추가하여 앱 내에서 직접 수정하고 추가적인 요청을 할 수 있도록 개선할 예정입니다.
+            **Q6.  PDF 파일 텍스트 추출 오류가 발생할 경우 어떻게 해야 하나요?**
+            A.  PDF 파일이 이미지 형태로 스캔된 경우, 텍스트 추출이 제대로 이루어지지 않을 수 있습니다.  가능하다면 **텍스트 기반 PDF 파일**을 사용하거나, OCR (광학 문자 인식) 기능을 활용하여 텍스트를 추출한 후 다시 시도해보세요.  향후 OCR 기능 내장 또는 PDF 텍스트 추출 성능 향상을 위해 지속적으로 개선할 예정입니다.
+            **Q7.  지원하는 출력 형식은 무엇인가요?**
+            A.  현재는 **Markdown 형식**으로 결과를 출력합니다.  
+            * **DOCX 다운로드**버튼으로 Word 문서(.docx)로 다운받을 수 있습니다.
+        """
+        )