전문 DOCX 시장 보고서

# 사용 가이드

## 개요

전문 DOCX 시장 보고서는 세련된 Word 시장 조사 보고서 생성을 자동화하는 강력한 plugin입니다. 전문적인 표지, 자동 생성 목차, 잘 구조화된 섹션, 서식이 적용된 표, 결론, 페이지 번호가 포함된 완성된 문서를 생성하여 프레젠테이션이나 추가 편집에 바로 사용할 수 있습니다.

## 주요 기능

- **표지**: 보고서 제목, 부제목, 날짜, 작성자가 포함된 표지를 자동으로 생성합니다.
- **목차 (TOC)**: 모든 제목을 반영하는 자동 업데이트 TOC를 삽입합니다.
- **스타일이 적용된 섹션**: 전문적인 외관을 위해 일관된 제목 스타일(Heading 1, Heading 2 등)을 적용합니다.
- **표**: 데이터 프레젠테이션을 위한 깔끔하고 스타일이 적용된 표를 생성합니다.
- **결론**: 요약 텍스트가 포함된 결론 섹션을 추가합니다.
- **페이지 번호**: footer에 페이지 번호를 포함합니다.

## 사용 방법

1. **Plugin 설치**
   - `docx-official` skill에 접근할 수 있는지 확인하세요(plugin에 포함됨).
   - 환경에서 plugin을 로드하세요(예: package manager 또는 direct import 사용).

2. **기본 보고서 생성**
   필요한 매개변수로 main function을 호출하세요:
   - `title` (string): 보고서 제목(예: "Global EV Market Analysis 2025")
   - `author` (string): 작성자 이름
   - `date` (string): 날짜 문자열(예: "January 2025")
   - `sections` (array): 섹션 객체 목록이며, 각 객체는 다음을 포함합니다:
       - `heading`: 섹션 제목
       - `content`: 단락 텍스트(**bold** 같은 markdown-like formatting 지원)
       - `tables` (optional): 표 배열이며, 각 표는 `rows`(각각 `cells` 배열을 가진 row 객체 배열)를 포함하는 객체입니다.
   - `conclusion` (string): 결론 섹션의 텍스트.

   예시:
   ```javascript
   const report = await createMarketReport({
     title: "Q4 Market Trends",
     author: "Jane Doe",
     date: "October 2024",
     sections: [{
       heading: "Market Overview",
       content: "The market grew by **12%** this quarter.",
       tables: [
         {
           rows: [
             { cells: ["Region", "Revenue", "Growth"] },
             { cells: ["North America", "$5B", "10%"] },
             { cells: ["Europe", "$3B", "8%"] }
           ]
         }
       ]
     }],
     conclusion: "Overall, the market shows strong momentum."
   });
   // report is a buffer or file path to the generated .docx
   ```

3. **사용자 지정**
   optional 매개변수를 전달하여 출력도 수정할 수 있습니다:
   - `filename` (string): 사용자 지정 출력 파일 이름.
   - `coverPageImage` (string): 표지에 사용할 이미지 경로.
   - `tocSettings` (object): TOC 깊이, 서식 등을 제어합니다.

4. **보고서 저장**
   출력은 DOCX 파일입니다. 표준 file I/O를 사용해 저장하세요:
   ```javascript
   const fs = require('fs');
   fs.writeFileSync('market_report.docx', report);
   ```

## 모범 사례

- 섹션은 간결하게 유지하세요. 각 섹션은 주요 제목에 해당합니다.
- 비교 데이터를 제시하려면 섹션 내에서 `tables` 배열을 사용하세요.
- 최종 확정 전에 placeholder data로 샘플을 생성해 보고서를 테스트하세요.
- 큰 보고서의 경우 데이터를 여러 섹션으로 나누는 것을 고려하세요.

## 문제 해결

- **TOC가 업데이트되지 않나요?** Word에서 TOC를 마우스 오른쪽 버튼으로 클릭하고 "Update Field"를 선택하세요.
- **스타일이 적용된 제목이 표시되지 않나요?** 올바른 제목 수준을 사용하고 있는지 확인하세요(섹션 제목에는 Heading 1).
- **표 정렬이 맞지 않나요?** 각 row의 cells 개수가 동일한지 확인하세요.

## 결론

전문 DOCX 시장 보고서는 전문적인 시장 조사 문서 생성을 간소화하여 시간을 절약하고 일관성을 보장합니다. 간단한 API로 이해관계자 검토나 발행에 바로 사용할 수 있는 세련된 보고서를 프로그래밍 방식으로 생성할 수 있습니다.