Documenta validacao bancaria e proxima etapa de pagamentos

This commit is contained in:
2026-10-28 14:37:38 +02:00
parent 70163c0184
commit f0f7b8ce9d
4 changed files with 100 additions and 3 deletions
+71
View File
@@ -1,5 +1,76 @@
# Desenvolvimento do SGC
## Dados bancários de fornecedores com dupla validação
Implementado no mesmo projecto, com dados isolados por empresa/fornecedor.
Procurement propõe uma versão completa; **duas pessoas distintas de Finanças**,
ambas diferentes do autor, conferem e aprovam. Uma aprovação mantém o estado
pendente; repetir a mesma decisão não conta outra vez. Rejeição impede novas
aprovações nessa versão. Correcções exigem nova versão, sem reescrever o passado.
A versão mais recente substitui a anterior para disponibilidade futura, mesmo
quando pendente ou rejeitada. Propostas com referência anterior desactualizada
e decisões sobre versões substituídas são recusadas. Reavaliação do estado
considera fornecedor activo/revisão válida/impedimentos, perfil actual dos
validadores e conflitos de interesses. Mudança de perfil do autor não permite
auto-aprovação. Futuro pagamento deve revalidar tudo na própria transacção,
sem confiar no estado mostrado anteriormente no ecrã.
Identificador da conta, titular, referência de evidência e fundamentos são
cifrados com a chave Laravel existente. Modelos ocultam esses campos na
serialização geral. Procurement e Finanças acedem aos dados actuais com
auditoria de leitura; Administração recebe apenas estado e metadados. Outros
perfis não acedem. A auditoria contém referências/versões, não números ou
titulares de conta. Resposta privada sem armazenamento em cache e histórico
Inertia cifrado. Campos sensíveis não são guardados em input antigo da sessão;
o campo `reason` é também excluído globalmente para impedir cópias de fundamentos
bancários em validações falhadas. Preservar a chave de aplicação nas operações
de recuperação: um backup de dados cifrados não substitui a guarda dessa chave.
Ficha: `/fornecedores/{supplier}/dados-bancarios`, ligada à ficha existente.
Exemplo público: `/consulta/dados-bancarios`, sem contas ou consultas de negócio.
Banco, titular, conta, país e moeda são fornecidos pela própria empresa.
Não existem contas, bancos ou valores financeiros predefinidos por cliente.
### Verificação, concorrência e migração
Suite completa: **314 testes aprovados, 3 ignorados e 2.523 asserções**.
Inclui **16 testes bancários e 74 asserções**: independência, duas pessoas,
versões, rejeição, conflitos posteriores, mudanças de perfil, isolamento,
cifragem, resposta restrita, cache, auditoria, rollback e input sensível não
guardado na sessão. PHPStan, Pint, TypeScript, compilação e frontend aprovados.
Três cenários concorrentes PostgreSQL aprovados: duas aprovações distintas,
mesma aprovação repetida e versões concorrentes. Duas ligações independentes
em processos PHP, observadas simultaneamente à espera de bloqueios por cenário.
Conferidos estados, versões e contagens de decisões; base temporária eliminada.
São testes de serviço, não de carga ou HTTP.
[Evidência](bancos-concorrencia-postgresql.json).
Migração 000011 aplicada no **lote 12** após backup custom PostgreSQL 17 de
**230.372 bytes** e restauro verificado das **42 tabelas** anteriores numa base
temporária, depois eliminada. Dump e manifesto partilharam snapshot consistente.
Dados de negócio, restrições e `.env` preservados; novas tabelas vazias. Sem
contas bancárias fictícias na base real, seeds, recriação de utilizadores ou
alteração de credenciais. Backup e manifesto privados, fora do Git.
[Evidência sem dados privados](bancos-migracao-000011.json).
### Limitações e roteiro
O identificador é texto normalizado com validação genérica de formato; não há
consulta bancária, verificação de titularidade, validação nacional de IBAN/NIB
ou confirmação automática da evidência. A declaração de conferência é humana.
Uma conta actual por fornecedor; múltiplas contas simultâneas, cancelamento
e levantamento de rejeição não foram implementados. Não existem pagamentos,
transferências, ficheiros de remessa, integração bancária ou envio externo.
Nova tentativa de navegador devolveu `The browser access host is unavailable`.
**Revisão visual pública, autenticada e de impressão continua pendente.**
Validação operacional integral do orçamento também permanece pendente.
Próxima etapa: registo e conferência de pagamentos externos sobre facturas
validadas, com revalidação da versão bancária no momento da operação; não
confundir esse futuro registo com execução de transferências bancárias.
## Facturas, conferência e consumo orçamental
Implementado `/facturas`: Administração consulta; Finanças regista e outra pessoa