Implementa conferencia de facturas e consumo por empresa

This commit is contained in:
2026-10-28 14:26:18 +02:00
parent f86ecef44d
commit 332cb9f1b7
28 changed files with 1356 additions and 8 deletions
+60
View File
@@ -1,5 +1,65 @@
# Desenvolvimento do SGC
## Facturas, conferência e consumo orçamental
Implementado `/facturas`: Administração consulta; Finanças regista e outra pessoa
de Finanças valida. Número normalizado único por empresa/fornecedor. Conferência
exacta de quantidade, unidade, preço, IVA e totais com a ordem congelada e a
recepção aceite ainda não facturada. Serviços também exigem aceitação.
Diferenças impedem registo/validação, sem correcção automática do documento.
Facturação parcial com arredondamento acumulado por linha para preservar os
centavos e IVA da ordem. Validação revalida quantidades e conflitos dentro da
transacção com bloqueio da empresa; repetição não duplica lançamentos. Sem
compromisso aprovado do exercício actual, a factura permanece pendente. Na
validação, a parcela facturada converte compromisso em consumo. O disponível
desconta reservas, compromisso remanescente e consumo, sem duplicar despesa
ou libertar saldo ao facturar. Falha de auditoria reverte toda a operação.
Cada documento, orçamento e configuração pertence à empresa correspondente.
A base com/sem IVA é a escolhida pela empresa; não existem dotações globais.
Autores de facturas integram os intervenientes auditados do processo. Facturas,
linhas e consumos não admitem reescrita/eliminação pelos modelos.
`/consulta/facturas` apresenta somente exemplos fictícios, sem consultar ou
gravar dados de negócio; os valores não são configurações predefinidas.
### Verificação e aplicação
**22 testes de facturas aprovados, 82 asserções**: independência, isolamento,
valores, duplicação, concorrência lógica de pendentes, auditoria/rollback,
compromisso obrigatório, serviços, consumo e arredondamento parcial de IVA.
Suite completa actual: **298 aprovados, 3 ignorados e 2.449 asserções**.
PHPStan, Pint, TypeScript, compilação e verificação frontend aprovados.
Três cenários concorrentes PostgreSQL aprovados: excesso de facturação, mesma
validação e facturas complementares. Duas ligações em processos PHP independentes,
observadas simultaneamente à espera de bloqueios, por cenário. Saldos, consumo
e número de facturas validadas confirmados. Base temporária eliminada.
São testes de serviço, não HTTP ou carga.
[Evidência](facturas-concorrencia-postgresql.json).
Migração 000010 aplicada no **lote 11** após backup custom PostgreSQL de
**216.008 bytes** e restauro verificado de **39 tabelas** numa base temporária,
depois eliminada. Dump e manifesto partilharam um snapshot consistente.
Registos de negócio, restrições anteriores e `.env` preservados. Novas tabelas
de facturas, linhas e consumos vazias; sem seeds, contas novas ou alteração de
credenciais. Backup e manifesto privados, fora do Git.
[Evidência sem dados privados](facturas-migracao-000010.json).
### Limitações e próximo passo
Pagamentos, dados bancários com dupla validação, reforços, notas de crédito,
anexos de factura, adiantamentos, compras sem ordem e operações cambiais não
estão implementados. Facturas entre exercícios ou sem compromisso ficam
bloqueadas. Conferência alterada por outra factura bloqueia a validação; ainda
não existe correcção/substituição do registo pendente.
Nova tentativa de acesso ao navegador: `The browser access host is unavailable`.
**Revisão visual pública, autenticada e de impressão continua pendente.**
Não constitui validação operacional integral do orçamento nem autorização de
compras/pagamentos reais. Próximo passo: dados bancários com dupla validação,
antes de pagamentos; reforços e regras de investimento configuráveis por empresa.
Equipamento continua bloqueado para adjudicação/emissão sem regra própria.
## Aplicação e validação PostgreSQL do orçamento
- Migração 000009 aplicada à base actual no **lote 10**, sem migrações pendentes.