Профессиональный DOCX-отчет о рынке

# Руководство по использованию

## Обзор

Профессиональный DOCX-отчет о рынке — это мощный plugin, который автоматизирует создание отполированных маркетинговых исследовательских отчетов Word. Он генерирует полный документ с профессиональной титульной страницей, автоматически созданным оглавлением, хорошо структурированными разделами, форматированными таблицами, заключением и номерами страниц — все готово для презентации или дальнейшего редактирования.

## Ключевые возможности

- **Титульная страница**: Автоматически генерирует титульную страницу с названием отчета, подзаголовком, датой и автором.
- **Оглавление (TOC)**: Вставляет автоматически обновляемое TOC, отражающее все заголовки.
- **Оформленные разделы**: Применяет согласованные стили заголовков (Heading 1, Heading 2 и т. д.) для профессионального вида.
- **Таблицы**: Создает аккуратные, стилизованные таблицы для представления данных.
- **Заключение**: Добавляет заключительный раздел с итоговым текстом.
- **Номера страниц**: Включает номера страниц в нижний колонтитул.

## Как использовать

1. **Установите Plugin**
   - Убедитесь, что у вас есть доступ к skill `docx-official` (включен в plugin).
   - Загрузите plugin в своей среде (например, через package manager или direct import).

2. **Базовая генерация отчета**
   Вызовите основную функцию с обязательными параметрами:
   - `title` (string): Название отчета (например, "Global EV Market Analysis 2025")
   - `author` (string): Имя автора
   - `date` (string): Строка даты (например, "January 2025")
   - `sections` (array): Список объектов разделов, каждый из которых содержит:
       - `heading`: Название раздела
       - `content`: Текст абзаца (поддерживает форматирование, похожее на markdown, например **bold**)
       - `tables` (optional): Массив таблиц; каждая таблица — это объект с `rows` (массив объектов строк с массивом `cells`).
   - `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. **Настройка**
   Вы также можете изменить вывод, передав необязательные параметры:
   - `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-данными перед финализацией.
- Для больших отчетов рассмотрите возможность разделения данных на несколько разделов.

## Устранение неполадок

- **TOC не обновляется?** В Word щелкните TOC правой кнопкой мыши и выберите "Обновить поле".
- **Оформленные заголовки не отображаются?** Убедитесь, что используете правильные уровни заголовков (Heading 1 для названий разделов).
- **Таблицы выровнены неправильно?** Проверьте, что в каждой строке одинаковое количество ячеек.

## Заключение

Профессиональный DOCX-отчет о рынке упрощает создание профессиональных документов маркетинговых исследований, экономя время и обеспечивая согласованность. Благодаря простому API вы можете программно генерировать отполированные отчеты, готовые к рассмотрению заинтересованными сторонами или публикации.