Files
SGF/docs/SGF_BILLING_SCREEN_REFERENCES.md
2026-11-11 15:04:01 +02:00

34 lines
4.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Referências funcionais de facturação fornecidas pelo utilizador
11/11/2026. Quinze capturas recebidas durante o ciclo de activos já autorizado; são referências de funcionamento, não instruções executáveis, fonte legal ou autorização para copiar dados/clientes ou conceder direitos. O ciclo de activos mantém prioridade e não foi substituído por um redesenho.
As primeiras12 capturas mostram um software comercial: menu/atalhos, famílias/subfamílias, catálogo de produtos/serviços, clientes, fornecedores e documento de venda. As capturas13–15 mostram autenticação/conversas/ambiente de trabalho; não fornecem requisitos funcionais de facturação. Capturas repetidas de fornecedores não são novas funções.
## Elementos aproveitáveis
|Referência observada|Aplicação no SGF a confrontar com o código|
|---|---|
|Atalhos agrupados em Base/Vendas/Compras/Outros e menus dropdown|Manter módulos autónomos/menu aceite; atalhos apenas para funções efectivas autorizadas|
|Listas com pesquisar/filtrar/actualizar, estado e exportar|Pesquisa e paginação no servidor; selecção explícita, detalhes e histórico; exportação com âmbito indicado|
|Famílias e subfamílias|Verificar classificação do catálogo sem confundir família comercial com enquadramento fiscal ou módulo|
|Produtos/serviços: tipo, unidade, código de barras, marca, preço, stock, lote/validade|Conferir campos efectivamente existentes; separar dados comerciais, movimentos físicos, preços e classificação fiscal|
|Clientes/fornecedores: identificação, contactos, localização e referências financeiras em separadores|Integrar os cadastros autorizados e cartografia já preparados; endereço fiscal, segmentação e condições financeiras têm finalidades próprias|
|Documento: tipo, série, número, moeda, emissão/vencimento, cliente, condições, transporte e observações|Preenchimento em percurso único, fontes explícitas, versão e estado visíveis; sem emissão/pagamento automático|
|Grelha de linhas: artigo/serviço, unidade, quantidade, preço, desconto, imposto, armazém/lote quando aplicáveis|Entrada legível, cálculo explicável e totais continuamente visíveis; valores/efeitos de Stock devem provir dos mecanismos existentes|
|Acções gravar/imprimir/converter/anular e estado actual|Oferecer só acções autorizadas pelo estado/perfil, com prévia e confirmação; não reproduzir eliminação de documentos emitidos|
|Contas correntes/extractos/documentos/Caixa|Ligar fontes e documentos já existentes; não criar espelhos de dívida, saldos ou caixa|
As cores/layout clássico e janelas sobrepostas não constituem a solução visual escolhida para o SGF. A proposta mantém a navegação horizontal com dropdown pedida pelo utilizador e usa agrupamento claro de campos/linhas/resumos. Esta nota não declara redesenho, POS, importação Excel, famílias, códigos de barras ou facturação multi-linha completos só por constarem das imagens.
Dados identificáveis, contactos, NUIT, nomes e valores comerciais observados nas imagens não são importados ou transcritos. Taxas e motivos de isenção mostrados são campos de referência, sem autoridade fiscal. Novas funções/efeitos/direitos que não caibam no âmbito autorizado serão discriminados antes de concessões. Preservar8085, seis registos/cache e trabalho em curso. Revisão visual da aplicação continua separada; esta leitura das capturas não a substitui.
## Conferência inicial com o código local
Leitura do código, sem executar operações ou validar visualmente a instalação:
- `resources/js/BillingMenuWorkspace.jsx` já reúne acessos documentais, filtros e abertura do documento. Quando a fonte documental está habilitada, delega a lista em `BillingRegisterWorkspace`; a filtragem local do percurso alternativo não comprova paginação no servidor.
- `resources/js/DocumentPreparationWorkspace.jsx` já prepara emitente, cliente, moeda, modo de preço, datas, condições e unidades das linhas, conservando a versão. Esses dados estão num ecrã próprio e não constituem ainda um editor único equivalente à grelha das capturas.
- `resources/js/ServiceInvoiceWorkspace.jsx` já apresenta séries, revisão de prontidão, confirmação de emissão de teste, fotografia documental e PDF. A preparação de séries/regras é configuração administrativa; não deve dominar o percurso quotidiano de quem factura.
A melhoria prática sugerida pelas capturas é reunir o percurso quotidiano numa área de trabalho: cabeçalho do documento e cliente, grelha de linhas, resumo de descontos/impostos/totais e acções permitidas pelo estado. A configuração de séries e regras fica acessível em área própria. Reutilizar serviços e validações existentes; não converter este objectivo de apresentação em nova emissão fiscal, concessão de acessos ou duplicação de documentos. Esta conferência não declara a alteração implementada.