Implementa registo e conferencia de pagamentos externos
This commit is contained in:
@@ -1,5 +1,77 @@
|
||||
# Desenvolvimento do SGC
|
||||
|
||||
## Registo e conferência de pagamentos externos
|
||||
|
||||
Implementado `/pagamentos`, por empresa. Finanças regista pagamentos já
|
||||
efectuados fora do SGC, com factura validada, montante explícito, data efectiva,
|
||||
referência externa e evidência. Outra pessoa de Finanças confirma ou rejeita a
|
||||
conferência. O sistema **não executa transferências, remessas ou ordens bancárias**.
|
||||
|
||||
- Apenas os registos confirmados abatem a dívida da factura. Liquidação parcial
|
||||
ou total é calculada a partir desse histórico; não reescreve a factura validada.
|
||||
Pendentes/rejeitados não abatem o saldo. A confirmação não lança novamente
|
||||
consumo ou compromisso orçamental: o orçamento foi consumido na factura.
|
||||
- Montante deve ser positivo e caber no saldo confirmado ainda pendente. Duas
|
||||
confirmações concorrentes não podem exceder a factura. Referência normalizada
|
||||
única por empresa; repetição idêntica pelo autor devolve o registo existente,
|
||||
enquanto dados diferentes para a mesma referência são recusados.
|
||||
- Registo e confirmação revalidam factura, fornecedor, conflitos, moeda e
|
||||
versão bancária mais recente com duas validações elegíveis. Versão alterada,
|
||||
fornecedor suspenso, perda de perfil ou conflito posterior bloqueiam confirmação.
|
||||
Registos históricos já confirmados não são reescritos por mudanças posteriores.
|
||||
- Uma operação externa corresponde a uma factura nesta etapa. Datas entre
|
||||
exercícios, câmbio, adiantamentos, estornos, reembolsos, anulação de confirmados
|
||||
e repartição da mesma operação por várias facturas não estão implementados.
|
||||
Uma referência de evidência não é upload de comprovativo nem verificação bancária.
|
||||
- Referência externa, evidência, fundamento e snapshot bancário são cifrados.
|
||||
Snapshot preserva versão, conta e validadores do momento do registo; não é
|
||||
exposto na listagem. Administração consulta metadados; Finanças consulta
|
||||
referências/evidência com auditoria. Outros perfis não acedem ao módulo.
|
||||
Auditoria contém IDs, montantes e estados, sem referências externas nem números
|
||||
bancários. Histórico Inertia cifrado, resposta sem cache e dados sensíveis
|
||||
excluídos de input antigo de sessão. Preservar a chave de aplicação no restauro.
|
||||
- Modelos impedem edição do registo e eliminação. Decisão final é imutável;
|
||||
falha na auditoria reverte registo ou confirmação. Protecção contra SQL
|
||||
administrativo directo continua dependente das permissões da base de dados.
|
||||
- `/consulta/pagamentos` contém apenas exemplos fictícios. Valores operacionais
|
||||
vêm das facturas da própria empresa e do montante introduzido; não há valores
|
||||
financeiros predefinidos para clientes. Moeda suportada nesta etapa: MZN,
|
||||
coincidente com a conta; sem autorização implícita para conversões.
|
||||
|
||||
### Verificação e migração
|
||||
|
||||
Suite completa actual: **347 aprovados, 3 ignorados, 2.630 asserções**.
|
||||
PHPStan, Pint, TypeScript, compilação e formatação/lint frontend aprovados.
|
||||
O serviço recarrega o perfil do operador depois do bloqueio da empresa e
|
||||
bloqueia os registos dos validadores bancários durante a conferência.
|
||||
|
||||
33 testes específicos aprovados, 107 asserções: liquidação parcial/total, limites, idempotência,
|
||||
versões bancárias, perfis, conflitos, moedas, isolamento, cifragem, privacidade,
|
||||
input não guardado, ausência de consumo duplicado, auditoria e rollback.
|
||||
Três cenários concorrentes PostgreSQL aprovados com duas ligações independentes
|
||||
observadas simultaneamente à espera de bloqueios: excesso, mesma confirmação
|
||||
e pagamentos complementares. Saldos e manutenção do consumo orçamental conferidos;
|
||||
base temporária eliminada. São testes de serviço, não de carga ou HTTP.
|
||||
[Evidência](pagamentos-concorrencia-postgresql.json).
|
||||
|
||||
Migração 000012 aplicada no **lote 13**, após backup custom PostgreSQL 17 de
|
||||
**239.843 bytes** e restauro verificado das **44 tabelas** anteriores numa base
|
||||
temporária, depois eliminada. Snapshot consistente para dump e manifesto.
|
||||
Registos de negócio, restrições e `.env` preservados. Tabela de pagamentos
|
||||
externos vazia; sem seeds, contas novas, alterações de credenciais ou pagamentos
|
||||
fictícios na base real. Backup e manifesto privados, fora do Git.
|
||||
[Evidência sem dados privados](pagamentos-migracao-000012.json).
|
||||
|
||||
### Pendências e próximo incremento
|
||||
|
||||
O navegador continua indisponível (`The browser access host is unavailable`).
|
||||
**Revisão visual pública, autenticada e de impressão permanece pendente.**
|
||||
Este incremento não constitui integração bancária, confirmação bancária automática
|
||||
ou validação operacional integral do orçamento. Documentos continuam de desenvolvimento.
|
||||
Próximo incremento: reforços orçamentais auditados, propostos e aprovados por
|
||||
pessoas distintas, com valores definidos por cada empresa. Regras de investimento
|
||||
também continuam por definir por cliente; equipamento permanece bloqueado.
|
||||
|
||||
## Dados bancários de fornecedores com dupla validação
|
||||
|
||||
Implementado no mesmo projecto, com dados isolados por empresa/fornecedor.
|
||||
|
||||
Reference in New Issue
Block a user