Implementa reforcos orcamentais com aprovacao independente

This commit is contained in:
2026-10-28 15:03:49 +02:00
parent c41628d738
commit 153ba2c1af
24 changed files with 1023 additions and 25 deletions
+63
View File
@@ -1,5 +1,68 @@
# Desenvolvimento do SGC
## Reforços orçamentais por empresa
Implementadas propostas de reforço em `/orcamentos`, por dotação existente de
empresa/centro de custo/exercício. Administração ou Finanças propõe referência
interna, montante positivo e fundamento; outra pessoa destes perfis aprova ou
rejeita, fundamentando. Perfis do operador e do proponente são recarregados em
transacção. O autor não aprova o próprio reforço.
A dotação inicial aprovada não é alterada. Dotação acumulada = valor inicial
mais reforços aprovados. Disponível = acumulada menos reservas, compromissos
remanescentes e consumos. Pendentes e rejeitados não aumentam o saldo; a
aprovação permite novas reservas apenas dentro do disponível actualizado.
Reforçar não altera consumo ou compromissos anteriores, base de IVA, moeda,
centro, exercício ou regras de aprovação de compras. Montantes são definidos
pela própria empresa, sem valores financeiros predefinidos para clientes.
Referência normalizada única por empresa, permitindo referências iguais noutras
empresas. Repetição idêntica da proposta ou da aprovação não duplica a verba.
Decisões finais e dados do reforço não admitem reescrita ou eliminação pelos
modelos. Falha na auditoria reverte integralmente proposta ou decisão.
Só dotações aprovadas do exercício actual recebem reforços. Há o mesmo limite
técnico de representação monetária das requisições, não um limite empresarial
ou autorização comercial. Aprovações históricas não são revogadas automaticamente
por mudanças posteriores de perfil; correcções exigem fluxo próprio, ainda ausente.
### Verificação e aplicação
**370 testes aprovados, 3 ignorados, 2.704 asserções** na suite completa.
Inclui **23 testes de reforços, 74 asserções**: perfis, independência, exactidão,
idempotência, bases preservadas, isolamento, valores por empresa, ano encerrado,
auditoria e rollback, inputs manipulados e disponibilidade para reservas.
PHPStan, Pint, TypeScript e compilação aprovados.
Três cenários concorrentes PostgreSQL aprovados: mesma aprovação repetida,
reforços distintos aprovados em simultâneo e aprovação concorrente com reserva.
Duas ligações independentes em processos PHP observadas simultaneamente à
espera de bloqueios por cenário. Conferidos dotação acumulada, saldo reservado,
ausência de excesso e preservação do valor inicial. Base temporária eliminada.
São transacções de serviço, não teste HTTP ou de carga.
[Evidência](reforcos-concorrencia-postgresql.json).
Migração 000013 aplicada no **lote 14**, após backup custom PostgreSQL 17 de
**245.514 bytes** e restauro verificado das **45 tabelas** anteriores numa base
temporária, depois eliminada. Dump e manifesto partilharam snapshot consistente.
Registos de negócio, restrições e `.env` preservados. Tabela de reforços vazia:
sem seeds, verbas fictícias, contas novas ou alterações de credenciais na base
real. Backup/manifesto privados, fora do Git.
[Evidência sem dados privados](reforcos-migracao-000013.json).
`/consulta/reforcos` contém somente exemplos fictícios; não consulta dotações ou
utilizadores e não grava dados. O navegador voltou a reportar
`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.
### Próximo passo e limitações
Próximo incremento: regras de investimento configuráveis por empresa e aprovadas
independentemente. Não inventar montantes comuns aos clientes, semântica de
limites ou dispensa de aprovações. Enquanto não houver regra própria aprovada,
equipamentos continuam bloqueados para adjudicação/emissão. Reduções, transferências
de dotações, estornos de reforços e passagem de saldos entre exercícios não
foram implementados; exigem fluxos e decisões próprios.
## Registo e conferência de pagamentos externos
Implementado `/pagamentos`, por empresa. Finanças regista pagamentos já