Relatório Profissional de Mercado em DOCX

# Guia de Uso

## Visão Geral

Relatório Profissional de Mercado em DOCX é um plugin poderoso que automatiza a criação de relatórios de pesquisa de mercado em Word, polidos e profissionais. Ele gera um documento completo com uma página de capa profissional, um sumário gerado automaticamente, seções bem estruturadas, tabelas formatadas, uma conclusão e números de página — tudo pronto para apresentação ou edição posterior.

## Principais Recursos

- **Página de Capa**: Gera automaticamente uma página de capa com o título do relatório, subtítulo, data e autor.
- **Sumário (TOC)**: Insere um TOC de atualização automática que reflete todos os títulos.
- **Seções Estilizadas**: Aplica estilos de título consistentes (Heading 1, Heading 2, etc.) para uma aparência profissional.
- **Tabelas**: Cria tabelas limpas e estilizadas para apresentação de dados.
- **Conclusão**: Adiciona uma seção de conclusão com texto de resumo.
- **Números de Página**: Inclui números de página no rodapé.

## Como Usar

1. **Instale o Plugin**
   - Certifique-se de ter acesso à skill `docx-official` (incluída com o plugin).
   - Carregue o plugin em seu ambiente (por exemplo, por meio de um gerenciador de pacotes ou importação direta).

2. **Geração Básica de Relatório**
   Chame a função principal com os parâmetros obrigatórios:
   - `title` (string): Título do relatório (por exemplo, "Global EV Market Analysis 2025")
   - `author` (string): Nome do autor
   - `date` (string): String de data (por exemplo, "January 2025")
   - `sections` (array): Lista de objetos de seção, cada um com:
       - `heading`: Título da seção
       - `content`: Texto do parágrafo (suporta formatação semelhante a markdown, como **bold**)
       - `tables` (opcional): Array de tabelas; cada tabela é um objeto com `rows` (array de objetos de linha com array `cells`).
   - `conclusion` (string): Texto para a seção de conclusão.

   Exemplo:
   ```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. **Personalização**
   Você também pode modificar a saída passando parâmetros opcionais:
   - `filename` (string): Nome de arquivo de saída personalizado.
   - `coverPageImage` (string): Caminho para uma imagem da página de capa.
   - `tocSettings` (object): Controle a profundidade do TOC, formatação, etc.

4. **Salvar o Relatório**
   A saída é um arquivo DOCX. Salve-o usando I/O de arquivos padrão:
   ```javascript
   const fs = require('fs');
   fs.writeFileSync('market_report.docx', report);
   ```

## Melhores Práticas

- Mantenha as seções concisas. Cada seção corresponde a um título principal.
- Use o array `tables` dentro das seções para apresentar dados comparativos.
- Teste seu relatório gerando uma amostra com dados de placeholder antes de finalizar.
- Para relatórios grandes, considere dividir os dados em várias seções.

## Solução de Problemas

- **TOC não atualiza?** No Word, clique com o botão direito no TOC e selecione "Update Field".
- **Títulos estilizados não aparecem?** Certifique-se de estar usando os níveis de título corretos (Heading 1 para títulos de seção).
- **Tabelas desalinhadas?** Verifique se cada linha tem o mesmo número de células.

## Conclusão

Relatório Profissional de Mercado em DOCX simplifica a criação de documentos profissionais de pesquisa de mercado, economizando tempo e garantindo consistência. Com sua API simples, você pode gerar relatórios polidos programaticamente, prontos para revisão por stakeholders ou publicação.