Documenta validacao bancaria e proxima etapa de pagamentos
This commit is contained in:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user