Relatórios, impressão e observabilidade

Relatórios, impressão e observabilidade transformam dados operacionais em visão de trabalho, auditoria e tomada de decisão.

Tipos de relatório

Tipo	Característica
Report Builder	Sem código, baseado em DocType
Query Report	SQL direto
Script Report	Python + configuração JS
Dashboard / Chart	Visualização analítica

Quando usar cada tipo

Report Builder

Consultas rápidas e simples.

Query Report

Consultas SQL controladas com foco em performance.

Script Report

Filtros dinâmicos e lógica mais sofisticada.

Dashboard / Chart

Indicadores e acompanhamento visual.

Query Report

SELECT
    name,
    creation,
    status
FROM
    `tabTask`
WHERE
    docstatus < 2
ORDER BY
    creation DESC

Script Report

JS para filtros:

neo.query_reports["Membership Expiry"] = {
    filters: [
        {
            fieldname: "from_date",
            label: "De",
            fieldtype: "Date"
        },
        {
            fieldname: "to_date",
            label: "Até",
            fieldtype: "Date"
        }
    ]
};

Front-end dos relatórios

No Desk, o front-end do relatório importa muito:

• filtros claros;

• colunas legíveis;

• links navegáveis;

• ordenação útil;

• feedback quando não há dados.

Impressão

Print Formats servem para:

• contratos;

• comprovantes;

• etiquetas;

• resumos formais;

• documentos operacionais.

Observabilidade

No contexto NEO, observabilidade inclui:

• logs de aplicação;

• histórico documental;

• status de jobs;

• fila de erro;

• indicadores operacionais;

• feedback no front-end.

Ligando observabilidade à experiência

Sempre que possível, a UI deve permitir ao usuário saber:

• se a ação concluiu;

• se está processando;

• se falhou;

• onde consultar detalhes.