Guia detalhado de formulários — módulo Relatórios¶
Visão geral¶
O módulo Relatórios tem uma tela habilitada no registro final da auditoria: Geral — Extratores. A navegação foi realizada em modo seguro e nenhum formulário foi salvo. O JSON final não registra formulário estruturado, mas registra um filtro de lista do tipo select e duas ocorrências do botão Baixar CSV.
O seletor foi deliberadamente mantido sem preenchimento na auditoria final. Portanto, este guia descreve somente os rótulos e estados registrados no JSON; não afirma que qualquer opção tenha sido selecionada. A fonte existente identifica a área como Relatórios — extratores, recomenda observar as permissões atribuídas ao usuário e orienta o respeito aos filtros da filial ativa. Essas orientações são Documentado, não reproduzido: não há no JSON uma mensagem ou erro que comprove esses cenários.
Inventário¶
As métricas abaixo foram recalculadas exclusivamente a partir do JSON final. Um formulário é contado somente quando o campo form não é nulo. Um controle é contado uma vez por entrada nos arrays de controles de lista e de formulário.
| Item | Contagem exata | Critério aplicado |
|---|---|---|
| Registros de auditoria | 1 | Há um registro em records. |
| Telas habilitadas | 1 | O registro de Geral / Extratores tem disabled: false. |
| Telas desabilitadas | 0 | Nenhum registro tem disabled: true. |
| Formulários estruturados | 0 | O campo form é null. |
| Controles de lista | 1 | Há uma entrada em list.controls. |
| Controles de formulário | 0 | Não existe formulário estruturado. |
| Controles totais | 1 | Soma de controles de lista e de formulário: 1 + 0. |
| Ocorrências de botões | 2 | list.buttons contém duas ocorrências de Baixar CSV. |
| Abas | 0 | list.tabs é vazio. |
| Cabeçalhos registrados | 3 | Relatórios, Contas a receber e Contratos aparecem em list.headings. |
| Opções catalogadas no seletor | 5 | Todos, OPEN, PARTIAL, PAID e CANCELLED. Elas não foram declaradas como selecionadas. |
| Mensagens de validação | 0 | Não há mensagens de validação no registro final. |
Mensagens auxiliares Nenhum resultado |
0 | Não há mensagem auxiliar desse tipo no registro final. |
| Erros HTTP reais diferentes de 409 | 0 | Não há erro HTTP real desse tipo registrado. |
| GET 404 real | 0 | Não há GET 404 real registrado. |
| Erros observados elegíveis | 0 | Soma dos grupos de erro solicitados: validação, Nenhum resultado, HTTP diferente de 409 e GET 404. |
| Erros documentados nas fontes | 0 | A fonte existente não documenta uma mensagem ou falha reproduzível para esta tela. |
Tela habilitada: Geral — Extratores¶
Seção: Relatórios. Grupo: Geral. Rótulo: Extratores. Estado: habilitada (disabled: false).
Formulário e campos¶
Não há formulário estruturado nesta tela (form: null). O único controle é um filtro da lista, não um campo de cadastro, edição ou gravação. A tabela mantém a estrutura de campos solicitada para documentar o controle disponível.
| Campo | Tipo | Obrigatório | Como preencher | Exemplo fictício | Observação |
|---|---|---|---|---|---|
| Status (opcional) | select / seleção única |
Não (required: false) |
No uso operacional, abra o seletor e escolha uma opção compatível com a consulta desejada. Para uma consulta sem restrição, use Todos somente se essa for a opção pretendida. |
PAID |
name e placeholder estão vazios; o controle está habilitado (disabled: false) e não tem valor preexistente (has_preexisting_value: false). As opções catalogadas são Todos, OPEN, PARTIAL, PAID e CANCELLED. O exemplo é fictício e não representa seleção feita na auditoria. |
O rótulo bruto registrado para o controle foi Status (opcional)TodosOPENPARTIALPAIDCANCELLED. A lista estruturada de opções permite separar os cinco rótulos sem inferir que algum deles tenha sido escolhido.
Passos¶
- Acesse o ambiente com uma conta autorizada e confirme a área Relatórios. Respeite as permissões atribuídas ao usuário e os filtros da filial ativa, conforme orientação da fonte existente (Documentado, não reproduzido).
- Abra a tela Geral — Extratores e localize o filtro Status (opcional).
- Para uma consulta filtrada, escolha uma única opção entre
OPEN,PARTIAL,PAIDeCANCELLED. Para uma consulta sem restrição, escolhaTodosse essa for a intenção. Essas são instruções de uso; nenhuma dessas opções foi declarada como selecionada na auditoria final. - Revise o filtro antes da exportação. Não há formulário de cadastro a preencher e não há campo obrigatório registrado nesta tela.
- Acione uma ocorrência de Baixar CSV. Como o JSON apresenta duas ocorrências com o mesmo rótulo e não informa diferença de destino, escopo ou resultado, registre a posição acionada se a reprodução exigir rastreabilidade.
- Confirme o resultado no navegador e trate o arquivo obtido segundo as regras internas. A auditoria não comprova nome, conteúdo, escopo ou sucesso de um CSV.
- Mantenha a reprodução em leitura e não tente criar, editar ou excluir registros. Nenhuma persistência foi comprovada pelo JSON final.
Regras e validações¶
| Regra ou aspecto | Registro final | Orientação operacional |
|---|---|---|
| Obrigatoriedade | O filtro declara required: false. |
O controle não foi marcado como obrigatório. Isso não permite inferir regras de negócio não registradas para a exportação. |
| Estado inicial | has_preexisting_value: false. |
Não havia valor preexistente capturado. Não tratar isso como prova de um filtro padrão persistente. |
| Opções | Todos, OPEN, PARTIAL, PAID e CANCELLED. |
Os rótulos podem ser descritos, mas a auditoria final não afirma que qualquer opção tenha sido selecionada. A semântica detalhada de cada status não está documentada no JSON. |
| Disponibilidade | Tela e controle com disabled: false. |
O controle estava habilitado para interação no momento registrado. |
| Tipo de controle | select; não é campo textual. |
Não documentar autocomplete, sugestões ou busca incremental. |
| Navegação | tabs: []; headings: Relatórios, Contas a receber, Contratos. |
Os três títulos são headings registrados, não abas confirmadas. Não inferir telas ou filtros adicionais a partir deles. |
| Ações | Duas ocorrências de Baixar CSV. | O JSON não diferencia as ocorrências. Não afirmar resultado de qualquer uma sem evidência própria. |
| Mensagens | Nenhuma mensagem de validação, mensagem auxiliar Nenhum resultado ou erro elegível foi registrada. |
A ausência de mensagem não comprova que todos os cenários operacionais foram testados. |
| Orientação da fonte | Permissões do usuário e filtro da filial ativa são mencionados na fonte. | Classificação: Documentado, não reproduzido. O JSON não mostra a validação, o erro ou o retorno desses pré-requisitos. |
Erros comuns¶
O JSON final não contém mensagens de validação, mensagem auxiliar Nenhum resultado, erro HTTP real diferente de 409, GET 404 real ou erro de runtime elegível. A fonte existente também não contém erro documentado para esta tela. Por isso, não há erro observado nem erro documentado a detalhar nesta seção.
| Erro ou sintoma | Causa | Como resolver | Evidência |
|---|---|---|---|
Capturas dos formulários simulados¶
Os valores visíveis são exemplos fictícios. Seleções e valores preexistentes foram mascarados. A auditoria bloqueou POST, PUT, PATCH e DELETE; nenhum registro foi salvo.