> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.
# O que é o Reporter?
> Transforme dados financeiros em relatórios operacionais e de negócio repetíveis com templates e renderização automatizada.
O **Reporter** é o mecanismo licenciado de geração de relatórios da Lerian. Ele
transforma dados dos seus sistemas financeiros em relatórios repetíveis com
base em templates de texto puro `.tpl`. Você define a estrutura do documento
uma vez e gera saídas atualizadas sempre que precisar.
O Reporter renderiza arquivos HTML, CSV, XML, PDF e TXT. Ele está disponível
para clientes licenciados, e a Lerian mantém seu código-fonte em um repositório
privado.
## O que você alcança com o Reporter
O Reporter oferece às equipes de produto, operações e engenharia uma forma
compartilhada de produzir documentos consistentes a partir de dados que mudam.
Você pode usá-lo para:
* Substituir a montagem manual de relatórios recorrentes por um processo repetível
* Manter a estrutura do documento separada dos dados usados para preenchê-lo
* Reutilizar um template em diferentes períodos e conjuntos de dados
* Produzir vários formatos de saída em um único fluxo de relatórios
* Armazenar templates e arquivos gerados para recuperação posterior
## Problemas que o Reporter resolve
A geração de relatórios costuma combinar extração de dados, formatação do
documento e entrega em um único processo manual e frágil. Essa abordagem fica
difícil de revisar e manter conforme o número de relatórios cresce.
O Reporter separa essas responsabilidades. As fontes de dados fornecem os
valores, os templates descrevem a saída e o fluxo de renderização produz o
arquivo final. Essa separação permite atualizar um layout sem refazer a
integração de dados ou conectar novos dados sem redesenhar cada relatório.
## Como o Reporter funciona
Em alto nível, cada relatório segue o mesmo fluxo:
1. Você cria ou seleciona um template `.tpl`.
2. Você solicita um relatório com os parâmetros e filtros relevantes.
3. O Reporter busca dados nas fontes PostgreSQL ou MongoDB configuradas.
4. O mecanismo de templates aplica a lógica do documento e renderiza a saída.
5. O Reporter armazena o arquivo gerado e o disponibiliza ao sistema
solicitante.
## Capacidades principais
* **Relatórios orientados por templates:** Defina layouts e lógica de documentos
em arquivos `.tpl` reutilizáveis.
* **Múltiplas fontes de dados:** Leia dados para relatórios no PostgreSQL e no
MongoDB.
* **Lógica documental flexível:** Inclua seções condicionais, conteúdo repetido,
cálculos e agregações nos templates.
* **Múltiplos formatos de saída:** Gere arquivos HTML, CSV, XML, PDF ou TXT.
* **Processamento assíncrono:** Execute a geração fora do ciclo da solicitação
quando uma carga exigir processamento em segundo plano.
* **Artefatos persistentes:** Mantenha templates e relatórios gerados em
armazenamento de objetos compatível com S3.
* **Operação via API:** Crie templates, solicite relatórios e recupere resultados
pela API do Reporter.
## Arquitetura e modelo de implantação
O Reporter mantém o acesso a dados, o processamento de templates, o
armazenamento e a entrega via API como responsabilidades separadas:
* A camada de dados se conecta às fontes PostgreSQL e MongoDB configuradas.
* A camada de templates resolve os dados e renderiza o formato solicitado.
* A camada de armazenamento usa um serviço compatível com S3 para templates e
saídas.
* A camada de API expõe recursos de relatórios a aplicações e operadores.
Você implanta o Reporter junto aos bancos de dados e ao armazenamento de objetos
que ele precisa acessar. A topologia exata depende do seu ambiente e modelo
operacional.
O Reporter pode se integrar ao [Access Manager](/pt/platform/access-manager/access-manager)
para controlar o acesso aos recursos de relatórios. A ativação dessa integração
e as políticas disponíveis dependem da sua implantação e oferta licenciada.
## Próximos passos
Conclua o caminho mais curto do acesso até um relatório gerado.
Entenda como o Reporter lê dados de uma implantação do Midaz.
Siga orientações práticas para templates, fontes de dados e relatórios.
Consulte as tags, os filtros e as expressões disponíveis nos templates.