# PROSA — documentos

No lugar de Word, Google Docs e Notion. Modelo `documento`, página A4.

## Estrutura de um documento que se lê até o fim

1. `capa` — chapéu, título, apoio, autor e data
2. `sumario` — só se passar de 4 seções
3. `secao` a cada bloco de raciocínio, com `paragrafo` de 3 a 5 linhas
4. `destaque` para o que não pode passar batido
5. `tabela` quando comparar, `lista` quando enumerar, `citacao` quando emprestar autoridade
6. fecho com o próximo passo concreto

## Exemplo

```json
{
  "ferramenta": "prosa",
  "titulo": "Proposta — modernização do parque de servidores",
  "doc": {
    "tema": "papel",
    "capa": {
      "chapeu": "Proposta técnica",
      "titulo": "Modernização do parque de servidores",
      "apoio": "Diagnóstico, plano em três ondas e estimativa de custo.",
      "autor": "Time de Infraestrutura",
      "data": "Agosto de 2026"
    },
    "blocos": [
      { "tipo": "sumario", "texto": "Sumário" },

      { "tipo": "secao", "texto": "Onde estamos" },
      { "tipo": "paragrafo", "texto": "O parque atual tem **34 máquinas**, das quais 11 passaram do fim de suporte do fabricante. O custo de manutenção subiu 40% em dois anos enquanto a capacidade útil ficou parada." },
      { "tipo": "destaque", "titulo": "Risco imediato",
        "texto": "Três servidores de banco não recebem correção de segurança desde março." },

      { "tipo": "secao", "texto": "O que propomos" },
      { "tipo": "numerada", "itens": [
        "Onda 1 — trocar os 11 equipamentos fora de suporte",
        "Onda 2 — consolidar cargas em 6 máquinas novas",
        "Onda 3 — mover o que for elástico para nuvem"
      ]},
      { "tipo": "tabela", "linhas": [
        ["Onda", "Prazo", "Investimento"],
        ["1", "60 dias", "R$ 420 mil"],
        ["2", "120 dias", "R$ 310 mil"],
        ["3", "180 dias", "custo variável"]
      ]},

      { "tipo": "secao", "texto": "Próximo passo" },
      { "tipo": "paragrafo", "texto": "Aprovar a Onda 1 até o fim do mês para caber na janela de manutenção de outubro." }
    ]
  }
}
```

## Blocos

| tipo | campos | vira |
|---|---|---|
| `titulo` | `texto` | H1 |
| `chapeu` | `texto` | sobretítulo colorido |
| `apoio` | `texto` | linha de apoio, cinza |
| `secao` | `texto` | H2 |
| `subsecao` | `texto` | H3 |
| `paragrafo` | `texto` | parágrafo |
| `lista` / `numerada` | `itens[]` | lista |
| `citacao` | `texto`, `autor` | citação com barra |
| `codigo` | `texto` | bloco monoespaçado |
| `tabela` | `linhas[][]` | primeira linha é cabeçalho |
| `imagem` | `src`, `legenda` | figura |
| `destaque` | `titulo`, `texto` | caixa de atenção |
| `sumario` | `texto` | índice das seções, automático |
| `divisor` | — | linha |
| `quebra` | — | quebra de página no PDF |

No texto: `**negrito**`, `*itálico*`, `` `código` ``, `[link](url)`.

## Temas

`papel` para leitura longa (serifado, bege) · `claro` para corporativo ·
`meia-noite` para leitura em tela.

## Export

`GET /api/arquivos/<id>/export` devolve **Markdown**. Para PDF, abra `/v/<id>` e `P`.