commit melhorias compras1
tests / ci (push) Waiting to run

This commit is contained in:
2026-11-21 21:04:40 +02:00
parent 976271f948
commit 12dd6df28a
108 changed files with 4391 additions and 408 deletions
+19
View File
@@ -1,5 +1,13 @@
# Entregas por blocos funcionais do SGC
## Continuação de 21/11/2026
**Decisão posterior: extensão de inventário autorizada apenas em desenvolvimento/QA.** A fonte comum `C:/laragon/www/sgf-tempo/packages/inventory-write/src` foi ampliada, sem editar o arquivo publicado 0.1.0. A adaptação e artefacto de desenvolvimento em Compras mantêm a configuração desligada; o carregamento exige `testing` e base descartável identificada. A primeira recepção aceite congela factor/fonte/versão por linha/artigo; parcelas seguintes conservam essa base. A compra e a factura mantêm as quantidades e preços documentais; stock/lotes/devoluções usam a quantidade física e a equivalência documental exacta. A autorização não instala nem activa no piloto/SGF.
Bloco de multimoeda implementado e validado localmente: Finanças regista taxa para MZN com data/fonte, congelada por processo/moeda; proposta/ordem mantêm valores originais, comparação/alçadas/orçamento usam referência em MZN. Facturas parciais, pagamentos externos na mesma moeda e reversão do compromisso estão ligados aos motores existentes. Migração nova apenas em QA, sem instalação no piloto ou activação SGF. Limite actual: valores com duas casas decimais, sem diferenças cambiais ou conversão bancária.
Conferência integrada: CSV completo da projecção já usada na impressão; integridade e revalidação de acesso dos documentos de fornecedores. Critérios e provas em `matriz-sgc-reconciliada.md`, actualização de 21/11. Não repetir instalações, avaliações, aprovações ou decisões do piloto. Prosseguir com as restantes lacunas e a validação global; este bloco não encerra o produto.
03/11/2026 — orientação acordada com o proprietário. Substitui a sequência de pequenos incrementos de consulta. A matriz reconciliada continua a fonte de cobertura e provas; este plano organiza a execução, sem declarar módulos completos por terem menus.
| Módulo | Base existente | Bloco a concluir | Critério de fecho |
@@ -37,3 +45,14 @@ O2 — 03/11/2026: diagnóstico integrado de reposição e integridade documenta
E2 — 03/11/2026: ficha de equipamento reúne também requisições internas ao armazém ainda pendentes, por ID nas linhas preservadas, sem associação por texto. Projecção só das linhas do equipamento, estado/reserva/entrega/saldo nativos, ligações aos processos e paginação independente de15. Acesso ao equipamento não concede acesso ao armazém; empresa/departamento/capacidades mantidos. Sem novos registos, movimentos, migração ou aprovações; MFA desligado. Docs/equipamentos-requisicoes-internas.md; provas equipment-warehouse.json e equipment-warehouse-pg.json. SQLite57testes/737verificações e PostgreSQL4/107 aprovados, sem somar a provas históricas; não declara revisão visual/carga. G3 continua pendente.
## Conversões de unidades — proposta concreta para decisão, 21/11/2026
O contrato instalado do escritor partilhado (`packages/inventory-write/releases/0.1.0/src/ReceiptMovementWriter.php`) exige que a quantidade do movimento seja exactamente a quantidade aceite da recepção. O percurso actual exige unidades coincidentes. Activar conversões apenas no formulário, reescrever a quantidade documental ou criar outro escritor perderia a relação com a compra/factura ou duplicaria a autoridade sobre stock.
Proposta: conservar quantidades e preços da compra/factura na unidade original e converter **apenas a quantidade física** para a unidade-base do artigo, com factor racional explícito por artigo, fonte e versão congelados na operação. Exemplo sintético de aceitação: 2 caixas de 12 unidades, a 100 MZN/caixa, conservam compra/factura de 200 MZN e originam 24 unidades em stock. Uma recepção parcial de 1,5 caixas origina 18 unidades, sem alterar o preço ou o documento. Não associar artigos por nome nem inferir factores.
Preparar uma versão seguinte do contrato na fonte comum aprovada e a adaptação de Compras, com uma única implementação/escrita, compatibilidade e repetição dos movimentos antigos, sem editar o arquivo publicado 0.1.0. O snapshot deve distinguir unidade/quantidade documental, unidade/quantidade de stock e factor/fonte/versão. Lotes, qualidade, devoluções, saídas e reposição devem usar a mesma base, sem arredondamento silencioso. Uma quantidade não representável em milésimos é recusada para correcção explícita. O hash/replay das origens antigas deve conservar-se quando não há conversão.
Aritmética exacta já preparada, isolada e sem escrita, em `packages/purchasing/src/QuantityConversion.php`; não está ligada ao bootstrap, aos escritores ou ao produto. Dez testes/18 asserções e PHPStan dirigido aprovados. A localização final na fonte comum e o contrato operacional dependem da autorização. Testes seguintes: percurso compra→recepção→stock→factura com conversão, parcelas/reenvio sem duplicação, conflitos de versão, qualidade/lotes/retornos e regressão dos efeitos antigos, em QA isolada. Instalação, publicação de pacotes, activação no piloto ou SGF e operações de negócio ficam excluídas. Após operações convertidas, qualquer reversão de código terá de conservar a sua leitura/repetição; não apagar nem reclassificar movimentos para recuar.
**Estado: autorização da alteração concreta do contrato pendente**, conforme §6 de `AGENTS.md`. Nenhuma alteração ao escritor ou versão publicada foi executada.