SGF/docs/BILLING_WORKSHOP_MENU_DELIVERY.md

# Menus de facturação e oficinas

29/10/2026. Implementação local da navegação solicitada, reutilizando os percursos existentes. Não declara implementadas todas as funções descritas nos documentos Word, não altera acessos e não resolve a recuperação da conta pública.

## Fontes e âmbito autorizado

- Pedido expresso «implementar o menu de facturacao», com `C:/Mac/Home/Documents/TEMPO/Portal Tempo/Servicos Tempo/ERP TEMPO/Menu Facturação.docx`. SHA-256 do original lido: `f2d59d8e31892602764598f310518a265d54ed796db96b015b858d43e669c784`.
- Documento `Menu para software de gestão de oficinas.docx`, no mesmo directório. O responsável confirmou «sim» à pergunta de implementar também o menu de oficinas depois de facturação.
- Os documentos foram lidos como referências funcionais. A sua proposta de operações, perfis e regras fiscais não foi tratada como autorização para emitir documentos reais, atribuir concessões, executar pagamentos, publicar ou implementar todos os motores de domínio.
- Preservados os percursos e alterações anteriores de serviços, oficinas, custos, recebimentos, orçamento e obrigações. Nenhum motor financeiro foi copiado ou reimplementado.

## O que fica utilizável

Abrir **http://127.0.0.1:8002/avaliar**, escolher **Preparar e gerir** e abrir **Facturação** ou **Oficinas**. A entrada já existente não exige palavra-passe. Os perfis técnicos mostram apenas os destinos permitidos pelas concessões actuais.

| Menu | Comportamento entregue | Limite identificado |
| --- | --- | --- |
| Todos os documentos | Consulta conjunta das facturas de teste e rascunhos autorizados; pesquisa por referência, cliente e NUIT quando preservado; filtros de tipo, moeda, série, estado documental, autor quando registado e intervalo de emissão; limpeza de filtros. | Não é um novo repositório documental. Não agrega moedas nem infere saldo/atraso. Os tipos futuros não aparecem como documentos fictícios. |
| Facturas | Lista das facturas de teste; abrir fotografia imutável, ver pedidos de correcção existentes e descarregar o PDF de teste já preservado. | Sem emissão real, envio ou edição da fotografia. |
| Facturas-recibo | Entrada com explicação de capacidade ainda não disponível. | Não une factura e recebimento automaticamente. |
| Recibos | Entrada que distingue documento fiscal ainda ausente do percurso de recebimentos/afectações já existente; ligação apenas quando autorizada. | Recebimento confirmado não é apresentado como recibo fiscal emitido. |
| Notas de crédito | Entrada com limite explícito e ligação aos pedidos de correcção existentes, quando autorizada. | Um pedido de correcção não altera dívida, stock ou dinheiro nem constitui nota de crédito. |
| Orçamentos de facturação | Entrada comercial identificada como ainda não disponível. | Não equivale a controlo orçamental de Compras nem a orçamento industrial. |
| Rascunhos | Editor e histórico existentes, pesquisa por referência/designação/cliente e ligações aos restantes submenus. A acção Novo documento abre a preparação existente por prestação de origem, sem emitir. | Não foi substituído pelo formulário integral das secções 6.1–6.12 do Word. |
| Configuração documental | Preparação documental, apresentação do rascunho e séries/emissão de teste mantidas em grupo próprio. | Preserva os caminhos existentes em vez de os remover para acomodar os sete submenus. |

### Oficinas

| Entrada | Comportamento entregue | Capacidade por desenvolver |
| --- | --- | --- |
| Painel da oficina | Lista pesquisável de ordens autorizadas e estado efectivamente registado; abertura da ordem seleccionada. | Indicadores de entradas/entregas, agenda e alertas sem fonte não são apresentados como zero. |
| Clientes | Ligação ao cadastro existente, só com `clients.view`. | Conta corrente e histórico integral de manutenção não são acrescentados. |
| Equipamentos | Identificação, descrição, série e ligações às ordens visíveis, sem duplicar a identidade do equipamento. | Cadastro independente, tipos, características técnicas e documentos de recepção/entrega ainda não estão entregues. |
| Agendamentos | Informação explícita de indisponibilidade. | Calendário, disponibilidade e lembretes. |
| Orçamentos de oficina | Informação explícita de indisponibilidade e ligação às autorizações de trabalho existentes. | Documento comercial e aprovação do cliente por versão. |
| Ordens de serviço | Reutiliza abertura, atribuição, tarefas, autorização, tempos, materiais, verificação e histórico já existentes; conserva a ordem escolhida na ligação da lista. | Não substitui os estados de apontamentos pelas fases operacionais futuras propostas no Word. |
| Peças e stock | Distingue apontamentos materiais de stock e encaminha para a consulta existente. | Reservas, mínimos, inventário e movimentos de stock da oficina. |
| Compras e fornecedores | Declara a composição ainda não integrada; liga aos percursos já disponíveis no contexto, apenas se autorizados. | Não duplica Compras nem cria integração remota. |
| Facturação e caixa | Liga a facturas, rascunhos, oficina → rascunho e recebimentos de teste conforme direitos. Oculta esta entrada ao perfil técnico sem direitos financeiros. | Caixa, despesas e fecho não são simulados. |
| Equipa | Consulta de ordens/responsáveis e ligação ao registo existente de horas. | Cadastro de pessoal, horários e disponibilidade. |
| Relatórios | Consulta actual de ordens, com pesquisa e filtro de estado. | Exportações, margens e relatório diário fechado/corte ainda não implementados. |
| Configurações | Ligações autorizadas à empresa, acessos, serviços, apresentação documental e perfis fiscais existentes. | Não transforma Administrador/Gestor/Recepcionista do documento em concessões universais. |

As entradas comerciais Oficina → rascunho e Correcção/cancelamento comercial permanecem acessíveis. A correcção comercial existente não é apresentada como cancelamento da ordem operacional.

## Preservação e permissões

As consultas usam os endpoints existentes `/api/service-invoices`, `/api/service-invoices/{id}`, `/api/a/billing_drafts` e `/api/workshop`. Não houve novas rotas de negócio, schema ou concessões. Isolamento, atribuição de ordens ao técnico e autorização de acções continuam no servidor.

O menu filtra consulta por empresa/contexto e unidade. As novas áreas são remontadas quando as concessões mudam para não conservar consultas de permissões anteriores. Respostas de um contexto abandonado são descartadas. Erros de fonte são apresentados como consulta indisponível; não são convertidos em zero documentos ou ordens.

Os totais das facturas são copiados de `snapshot.calculation.total_document_proposed`. Não se executam cálculos fiscais nem arredondamentos. A base aritmética do rascunho conserva a precisão e não é rotulada como total fiscal. Sem fonte de saldo/vencimento, a lista apresenta a ausência e remete ao percurso financeiro; não calcula atrasos nem presume pagamento. Os filtros de vencimento/estado financeiro e os dados de autor inexistentes nas fontes actuais ficam por completar, sem datas/identidades inventadas.

## Código alterado

- `resources/js/billing-menu.js`: mapa de sete entradas, autorização e modelos de consulta/filtros sem efeitos financeiros.
- `resources/js/BillingMenuWorkspace.jsx`: lista, pesquisa, filtros, fotografia documental/PDF e informação dos tipos em falta.
- `resources/js/workshop-menu.js`: mapa de doze entradas, autorização, filtros e reutilização da identidade de equipamento.
- `resources/js/WorkshopMenuWorkspace.jsx`: painel, consulta de equipamentos/ordens e ligações autorizadas.
- `resources/js/WorkspaceNavigation.jsx`: organização dos dois grupos e preservação da configuração documental.
- `resources/js/app.jsx`: montagem e selecção dos percursos/registos existentes.
- `resources/js/ServicesWorkspace.jsx`: acesso à preparação existente a partir de Novo documento, pesquisa dos rascunhos e navegação contextual.
- `resources/js/WorkshopWorkspace.jsx`: navegação contextual e abertura da ordem seleccionada, sem alteração das operações.
- `resources/css/app.css`: disposição responsiva dos submenus/filtros e scroll próprio das tabelas.
- `scripts/billing-menu-check.mjs`, `docs/proofs/billing-menu.json`: verificação dos dois menus e leitura da demonstração existente.

## Provas e limites

Compilação Vite aprovada. Passaram os checks de navegação/início existentes e o check orçamental de representação monetária e unidade. O novo check cobre sete entradas de facturação, doze de oficinas, ausência de permissão, unidade diferente, ocultação financeira ao técnico, pesquisa por cliente/NUIT/equipamento, combinação de filtros, valores exactos, datas/saldos desconhecidos e falha parcial de fonte.

Na demonstração sintética persistente em 8002, o teste HTTP autenticou pela entrada de avaliação já existente e consultou **uma factura, dois rascunhos e uma ordem**. Os valores documentais mantiveram-se iguais às fotografias. Sem criação de documentos, ordens, pagamentos ou efeitos orçamentais; apenas sessão/contexto e auditoria de entrada/saída. Não se executou a bateria destrutiva sobre a base da demonstração.

São provas técnicas de renderização estática, HTTP e compilação. **Não foi realizada revisão visual/interactiva no navegador**, nem se presume aceitação. Os scripts inicialmente interrompidos durante a leitura HTTP foram repetidos com fecho explícito das ligações e limite de espera; a execução final passou. Nenhum bloqueio de ferramenta foi contornado.

Permanecem por implementar as restantes funções descritas nos Word: formulário integral/simplificado de factura, novas condições/prestações, documentos fiscais adicionais, envio, exportação, anexos e confirmações/recuperação específicas desses novos percursos; cadastro/fases/documentos operacionais completos da oficina, stock, caixa e relatórios fechados. Esta entrega implementa o menu e a ligação ao que existe, não todos esses módulos por arrasto.

Nenhuma dependência, conta, permissão, credencial, base real ou implantação pública foi alterada por esta entrega. Não foi executada publicação, push ou checkpoint de encerramento. A recuperação de acesso a `sgf.tempo.co.mz` mantém-se uma tarefa distinta, sem a declarar resolvida pelos menus locais.