Kit de Ferramentas de Documentos LibreOffice

# Kit de Ferramentas de Documentos LibreOffice

Criar, editar e automatizar documentos do Writer, Calc e Impress através de um fluxo de trabalho unificado do LibreOffice.

## Pré-requisitos

- **LibreOffice** instalado (versão 7.x ou posterior recomendada)
- O LibreOffice deve estar em execução no **modo de escuta** para acesso à API UNO:
  ```bash
  soffice --headless --accept="socket,host=localhost,port=2002;urp;" --norestore
  ```
- **Python 3** com módulo `uno` (incluído com o LibreOffice na maioria dos sistemas)
- Plataformas suportadas: Linux, macOS, Windows (LibreOffice + UNO disponível em todas as três)

### Verificação rápida do ambiente

```bash
# Verificar se o LibreOffice está instalado
soffice --version

# Iniciar o listener headless (em segundo plano)
soffice --headless --accept="socket,host=localhost,port=2002;urp;" --norestore &

# Verificar conexão UNO
python3 -c "import uno; print('UNO available')"
```

Se `import uno` falhar, certifique-se de que seu caminho Python inclui os site-packages do LibreOffice (por exemplo, `/usr/lib/libreoffice/program/`).

## O Que Este Plugin Faz

Três habilidades para os três aplicativos principais do LibreOffice:

| Habilidade | Formato | Capacidades |
|------------|---------|-------------|
| **Writer** | .odt | Inserção de texto, tabelas, imagens, metadados, estilização de parágrafos |
| **Calc** | .ods | Operações de células, fórmulas, formatação, gráficos, intervalos nomeados, validação de dados |
| **Impress** | .odp | Slides, posicionamento de conteúdo, tabelas, gráficos, mídia, notas, mestras de slide |

## Exemplo Completo: Pipeline de Relatório Semanal

Uma equipe automatiza seu fluxo de trabalho de relatório de sexta-feira — reúne dados em uma planilha, gera um resumo escrito e produz uma apresentação.

### Passo 1: Calc — Agregar Métricas Semanais

```
Criar uma nova planilha Calc "weekly-metrics.ods".
Folha 1 "Revenue": colunas Date, Product, Units, Revenue com dados de exemplo para Seg-Qui.
Folha 2 "Summary": usar fórmulas SUMIF para totalizar receita por produto.
Adicionar um gráfico de barras na Folha 2 visualizando receita por produto.
Formatar linhas de encabezado como negrito com fundo azul.
```

### Passo 2: Writer — Gerar Relatório Escrito

```
Criar um documento Writer "weekly-report.odt".
Título: "Weekly Report — March 10, 2026"
Seção 1: Executive Summary (2 parágrafos resumindo métricas da planilha).
Seção 2: Key Highlights (lista com marcadores dos 3 principais accomplishments).
Seção 3: Next Week Priorities (lista numerada).
Inserir uma tabela com os totais resumidos da planilha.
Definir fonte para Liberation Serif 12pt, títulos 16pt negrito.
```

### Passo 3: Impress — Criar Deck de Apresentação

```
Criar uma apresentação Impress "weekly-deck.odp".
Slide 1: Title slide — "Weekly Review Q1 W10" com subtítulo de data.
Slide 2: Metrics Overview — inserir uma tabela com receita por produto.
Slide 3: Highlights — pontos com marcadores das principais conquistas.
Slide 4: Next Steps — prioridades numeradas.
Slide 5: Thank You slide.
Adicionar notas do apresentador nos slides 2-4 com pontos de discussão.
```

**Resultado:** Três documentos coordenados (planilha, relatório, deck) gerados a partir de um único fluxo de trabalho — sem formatação manual, sem copiar e colar entre aplicativos.

## Tratamento de Erros e Recuperação de Falhas

### LibreOffice não está em execução

Se a conexão do socket UNO falhar:
```
Error: could not connect to socket on localhost:2002
```
**Solução:** Iniciar o listener headless:
```bash
soffice --headless --accept="socket,host=localhost,port=2002;urp;" --norestore &
```

### Módulo UNO não encontrado

```
ModuleNotFoundError: No module named 'uno'
```
**Solução:** Adicionar o Python do LibreOffice ao seu caminho:
```bash
# Linux
export PYTHONPATH=/usr/lib/libreoffice/program:$PYTHONPATH

# macOS
export PYTHONPATH="/Applications/LibreOffice.app/Contents/Frameworks/:$PYTHONPATH"
```

### Modelo ou arquivo não encontrado

Se um arquivo de modelo for referenciado mas estiver ausente, a habilidade criará um novo documento em branco. Certifique-se de que os caminhos dos modelos sejam absolutos ou relativos ao diretório de trabalho.

### Erros de permissão ao salvar

Se o diretório de saída não for gravável, a operação de salvar falhará. Verifique as permissões de gravação antes de executar a geração de documentos:
```bash
test -w ./output/ || mkdir -p ./output/
```

### Acesso concorrente

O UNO do LibreOffice não suporta bem conexões concorrentes. Se múltiplos scripts tentarem usar o mesmo listener simultaneamente, as operações podem falhar ou produzir saída corrompida. Use uma conexão por vez, ou inicie instâncias headless separadas em portas diferentes.