Implementa conferencia de facturas e consumo por empresa
This commit is contained in:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user