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

This commit is contained in:
2026-11-21 21:11:55 +02:00
parent 12dd6df28a
commit 4fac443dda
13 changed files with 175 additions and 14 deletions
@@ -305,6 +305,7 @@ class SupplyPlanningController extends Controller
'id' => $line->id, 'label' => $orders[$line->purchase_order_id]->number.' · '.$line->description.' · '.$line->quantity.' '.$line->unit, 'id' => $line->id, 'label' => $orders[$line->purchase_order_id]->number.' · '.$line->description.' · '.$line->quantity.' '.$line->unit,
'stock_item_id' => $orders[$line->purchase_order_id]->snapshot['catalogue_sources'][$line->requisition_item_id]['stock_item_id'] ?? null, 'stock_item_id' => $orders[$line->purchase_order_id]->snapshot['catalogue_sources'][$line->requisition_item_id]['stock_item_id'] ?? null,
'quantity_milli' => ReceiptWorkflow::milli($line->quantity), 'quantity_milli' => ReceiptWorkflow::milli($line->quantity),
'unit' => $line->unit,
]); ]);
$requests = collect(); $requests = collect();
if ($canPrepare && $kind === 'reservation') { if ($canPrepare && $kind === 'reservation') {
@@ -340,6 +341,7 @@ class SupplyPlanningController extends Controller
} }
return Inertia::render('supply/coordination', ['kind' => $kind, 'ready' => $ready, return Inertia::render('supply/coordination', ['kind' => $kind, 'ready' => $ready,
'conversionQaEnabled' => app()->environment('testing') && config('inventory_conversion.qa_enabled') === true,
'recordFilters' => ['record_search' => trim($filters['record_search'] ?? ''), 'record_state' => $filters['record_state'] ?? ''], 'recordFilters' => ['record_search' => trim($filters['record_search'] ?? ''), 'record_state' => $filters['record_state'] ?? ''],
'recordPagination' => $page === null ? null : ['current_page' => $page->currentPage(), 'last_page' => $page->lastPage(), 'total' => $page->total(), 'recordPagination' => $page === null ? null : ['current_page' => $page->currentPage(), 'last_page' => $page->lastPage(), 'total' => $page->total(),
'prev_page_url' => $page->previousPageUrl(), 'next_page_url' => $page->nextPageUrl()], 'prev_page_url' => $page->previousPageUrl(), 'next_page_url' => $page->nextPageUrl()],
+1 -1
View File
@@ -75,7 +75,7 @@ final class ReceiptQuantityConversion
if ($basis === null) { if ($basis === null) {
return $physical; return $physical;
} }
abort_unless(config('inventory_conversion.qa_enabled') === true, 503, 'Convers?o ainda n?o instalada.'); abort_unless(config('inventory_conversion.qa_enabled') === true, 503, 'Conversão ainda não instalada.');
app(ReceiptStockMovement::class)->load(); app(ReceiptStockMovement::class)->load();
try { try {
return (int) QuantityConversion::fromBase((string) $physical, $basis['numerator'], $basis['denominator']); return (int) QuantityConversion::fromBase((string) $physical, $basis['numerator'], $basis['denominator']);
+6
View File
@@ -95,6 +95,12 @@ class ReceiptWorkflow
throw ValidationException::withMessages(['items' => 'Reutilize o artigo e armazém já associados à confirmação desta linha.']); throw ValidationException::withMessages(['items' => 'Reutilize o artigo e armazém já associados à confirmação desta linha.']);
} }
$line['stock_item_id'] = $mapping->stock_item_id; $line['stock_item_id'] = $mapping->stock_item_id;
if (isset($mapping->data['conversion'])) {
if (isset($line['conversion']) && $line['conversion'] !== $mapping->data['conversion']) {
throw ValidationException::withMessages(['items' => 'Reutilize a conversão da confirmação de entrega.']);
}
$line['conversion'] = $mapping->data['conversion'];
}
} }
if (! empty($order->snapshot['catalogue_sources']) && empty($line['stock_item_id'])) { if (! empty($order->snapshot['catalogue_sources']) && empty($line['stock_item_id'])) {
$orderLine = $order->items()->whereKey($line['purchase_order_item_id'])->first(); $orderLine = $order->items()->whereKey($line['purchase_order_item_id'])->first();
+23 -3
View File
@@ -19,6 +19,7 @@ use Illuminate\Support\Facades\Schema;
use Illuminate\Support\Facades\Validator; use Illuminate\Support\Facades\Validator;
use Illuminate\Support\Str; use Illuminate\Support\Str;
use Illuminate\Validation\ValidationException; use Illuminate\Validation\ValidationException;
use Tempo\Inventory\QuantityConversion;
class SupplyCoordination class SupplyCoordination
{ {
@@ -107,6 +108,9 @@ class SupplyCoordination
app(OrderCancellationWorkflow::class)->assertOperational($order); app(OrderCancellationWorkflow::class)->assertOperational($order);
$snapshot['order'] = $order->only(['id', 'number']); $snapshot['order'] = $order->only(['id', 'number']);
$snapshot['order_line'] = $line->only(['id', 'quantity', 'unit', 'description']); $snapshot['order_line'] = $line->only(['id', 'quantity', 'unit', 'description']);
if (isset($data['conversion_basis'])) {
$snapshot['quantity_conversion'] = $data['conversion_basis'];
}
} }
$state = $kind === 'alternative' ? 'draft' : 'active'; $state = $kind === 'alternative' ? 'draft' : 'active';
} elseif ($kind === 'alternative') { } elseif ($kind === 'alternative') {
@@ -170,7 +174,8 @@ class SupplyCoordination
'alternative' => ['substitute_id' => 'required|integer|min:1', 'application' => 'required|string|max:200', 'compatibility' => 'required|in:equivalent,conditional,incompatible,pending', 'alternative' => ['substitute_id' => 'required|integer|min:1', 'application' => 'required|string|max:200', 'compatibility' => 'required|in:equivalent,conditional,incompatible,pending',
'conditions' => 'required_if:compatibility,conditional|nullable|string|max:4000', 'evidence' => 'required|string|min:10|max:4000', 'factor_numerator' => 'required|integer|min:1|max:1000000', 'factor_denominator' => 'required|integer|min:1|max:1000000', 'valid_until' => 'required|date_format:Y-m-d'], 'conditions' => 'required_if:compatibility,conditional|nullable|string|max:4000', 'evidence' => 'required|string|min:10|max:4000', 'factor_numerator' => 'required|integer|min:1|max:1000000', 'factor_denominator' => 'required|integer|min:1|max:1000000', 'valid_until' => 'required|date_format:Y-m-d'],
'reservation' => ['requisition_item_id' => 'nullable|integer|min:1', 'quantity_milli' => 'required|integer|min:1|max:1000000000', 'needed_on' => 'required|date_format:Y-m-d', 'additional' => 'required|boolean', 'reference' => 'required|string|max:200'], 'reservation' => ['requisition_item_id' => 'nullable|integer|min:1', 'quantity_milli' => 'required|integer|min:1|max:1000000000', 'needed_on' => 'required|date_format:Y-m-d', 'additional' => 'required|boolean', 'reference' => 'required|string|max:200'],
'delivery' => ['purchase_order_item_id' => 'required|integer|min:1', 'quantity_milli' => 'required|integer|min:1|max:1000000000', 'expected_on' => 'required|date_format:Y-m-d', 'confirmed_on' => 'required|date_format:Y-m-d|before_or_equal:today', 'evidence' => 'required|string|min:5|max:2000'], 'delivery' => ['purchase_order_item_id' => 'required|integer|min:1', 'quantity_milli' => 'required|integer|min:1|max:1000000000', 'expected_on' => 'required|date_format:Y-m-d', 'confirmed_on' => 'required|date_format:Y-m-d|before_or_equal:today', 'evidence' => 'required|string|min:5|max:2000',
'conversion' => 'sometimes|nullable|array:numerator,denominator,source,version'],
default => abort(404), default => abort(404),
}; };
$data = Validator::make($input, $rules)->validate(); $data = Validator::make($input, $rules)->validate();
@@ -208,7 +213,11 @@ class SupplyCoordination
app(OrderCancellationWorkflow::class)->assertOperational($order); app(OrderCancellationWorkflow::class)->assertOperational($order);
$stock = StockItem::query()->whereKey($data['stock_item_id'])->firstOrFail(); $stock = StockItem::query()->whereKey($data['stock_item_id'])->firstOrFail();
$linked = $order->snapshot['catalogue_sources'][$line->requisition_item_id]['stock_item_id'] ?? null; $linked = $order->snapshot['catalogue_sources'][$line->requisition_item_id]['stock_item_id'] ?? null;
$this->require($order->status === 'issued' && $line->unit === $stock->unit && ($linked === null || $linked === $stock->id), 'data.stock_item_id', 'A confirmação deve respeitar o artigo e unidade da ordem emitida.'); $this->require($order->status === 'issued' && ($linked === null || $linked === $stock->id), 'data.stock_item_id', 'A confirmação deve respeitar o artigo da ordem emitida.');
$conversion = app(ReceiptQuantityConversion::class)->freeze($actor, $line, $stock, $data['quantity_milli'], $data['conversion'] ?? null);
if ($conversion !== null) {
$data['conversion_basis'] = array_diff_key($conversion, array_flip(['accepted_document_milli', 'accepted_stock_milli']));
}
$this->require($old === null || $old->data['purchase_order_item_id'] === (int) $data['purchase_order_item_id'], 'data.purchase_order_item_id', 'A revisão mantém a linha da ordem original.'); $this->require($old === null || $old->data['purchase_order_item_id'] === (int) $data['purchase_order_item_id'], 'data.purchase_order_item_id', 'A revisão mantém a linha da ordem original.');
$others = app(SupplyPlanning::class)->latest('delivery')->where('state', 'active')->where('id', '!=', $old->id ?? 0)->get()->filter(fn ($r) => $r->data['purchase_order_item_id'] == $line->id)->sum(fn ($r) => $r->data['quantity_milli']); $others = app(SupplyPlanning::class)->latest('delivery')->where('state', 'active')->where('id', '!=', $old->id ?? 0)->get()->filter(fn ($r) => $r->data['purchase_order_item_id'] == $line->id)->sum(fn ($r) => $r->data['quantity_milli']);
$this->require($others === 0, 'data.purchase_order_item_id', 'Esta linha já tem confirmação activa. Reveja-a para actualizar quantidade ou prazo.'); $this->require($others === 0, 'data.purchase_order_item_id', 'Esta linha já tem confirmação activa. Reveja-a para actualizar quantidade ou prazo.');
@@ -216,6 +225,9 @@ class SupplyCoordination
$this->require($data['quantity_milli'] >= app(ReceiptWorkflow::class)->recordedQuantity($line->id, 'received_milli'), 'data.quantity_milli', 'A quantidade acumulada confirmada não pode ficar abaixo da já recebida.'); $this->require($data['quantity_milli'] >= app(ReceiptWorkflow::class)->recordedQuantity($line->id, 'received_milli'), 'data.quantity_milli', 'A quantidade acumulada confirmada não pode ficar abaixo da já recebida.');
// A line has one canonical destination/article mapping, even across revisions. // A line has one canonical destination/article mapping, even across revisions.
$mapping = app(SupplyPlanning::class)->latest('delivery')->get()->first(fn ($r) => $r->data['purchase_order_item_id'] == $line->id); $mapping = app(SupplyPlanning::class)->latest('delivery')->get()->first(fn ($r) => $r->data['purchase_order_item_id'] == $line->id);
if (isset($mapping?->data['conversion_basis'])) {
$this->require(($data['conversion_basis'] ?? null) === $mapping->data['conversion_basis'], 'data.conversion', 'Conserve a base de conversão já congelada na confirmação desta linha.');
}
$this->require($mapping === null || ($mapping->stock_item_id === $stock->id && $mapping->warehouse_id === (int) $data['warehouse_id']), 'data.warehouse_id', 'Esta linha já tem artigo/local associados. Reutilize a associação existente.'); $this->require($mapping === null || ($mapping->stock_item_id === $stock->id && $mapping->warehouse_id === (int) $data['warehouse_id']), 'data.warehouse_id', 'Esta linha já tem artigo/local associados. Reutilize a associação existente.');
$receivedStocks = GoodsReceiptItem::query()->where('purchase_order_item_id', $line->id)->whereNotNull('stock_item_id')->pluck('stock_item_id')->unique(); $receivedStocks = GoodsReceiptItem::query()->where('purchase_order_item_id', $line->id)->whereNotNull('stock_item_id')->pluck('stock_item_id')->unique();
$this->require($receivedStocks->isEmpty() || ($receivedStocks->count() === 1 && (int) $receivedStocks->first() === $stock->id), 'data.stock_item_id', 'A confirmação deve reutilizar o artigo já recebido nesta linha.'); $this->require($receivedStocks->isEmpty() || ($receivedStocks->count() === 1 && (int) $receivedStocks->first() === $stock->id), 'data.stock_item_id', 'A confirmação deve reutilizar o artigo já recebido nesta linha.');
@@ -244,7 +256,15 @@ class SupplyCoordination
{ {
$received = app(ReceiptWorkflow::class)->recordedQuantity($record->data['purchase_order_item_id'], 'received_milli'); $received = app(ReceiptWorkflow::class)->recordedQuantity($record->data['purchase_order_item_id'], 'received_milli');
return max(0, BigDecimal::of($record->data['quantity_milli'])->minus($received)->toInt()); $remaining = max(0, BigDecimal::of($record->data['quantity_milli'])->minus($received)->toInt());
$basis = $record->data['conversion_basis'] ?? null;
if ($basis === null) {
return $remaining;
}
abort_unless(config('inventory_conversion.qa_enabled') === true, 503, 'Conversão ainda não instalada.');
app(ReceiptStockMovement::class)->load();
return (int) QuantityConversion::toBase((string) $remaining, $basis['numerator'], $basis['denominator']);
} }
/** @param list<array<string,mixed>> $applications /** @param list<array<string,mixed>> $applications
+15 -1
View File
@@ -2787,4 +2787,18 @@ Provas: 78 testes/799 asserções SQLite integrados; 68/437 PostgreSQL, mais cas
Migração000002 apenas nos livros descartáveis; piloto, contas/acessos, aprovações, MFA e SGF preservados. Compatibilidade com esquema anterior verificada. Reversão após uso de contas independentes exige manter a leitura por conta; não regressar a uma consulta global que substitua outra conta. Revisão visual/capacidade e instalação mantêm critérios próprios. Migração000002 apenas nos livros descartáveis; piloto, contas/acessos, aprovações, MFA e SGF preservados. Compatibilidade com esquema anterior verificada. Reversão após uso de contas independentes exige manter a leitura por conta; não regressar a uma consulta global que substitua outra conta. Revisão visual/capacidade e instalação mantêm critérios próprios.
Conversões gerais: aritmética exacta isolada preparada (10 testes/18 asserções, análise estática dirigida aprovada), sem integração, publicação ou escrita. A extensão necessária do contrato do escritor único está apresentada no plano existente, com exemplo documental/físico, compatibilidade, recuperação e testes. Aguardar autorização concreta prevista no AGENTS.md; formalização de Pessoas permanece pendente por decisão expressa. Conversões gerais: a proposta inicialmente pendente foi posteriormente autorizada por «Autorizar a extensão em QA». O estado executado e as provas estão no bloco seguinte; formalização de Pessoas permanece pendente por decisão expressa.
### 21/11/2026 — contrato de unidades e percurso integrado em QA
Fonte única ampliada em `C:/laragon/www/sgf-tempo/packages/inventory-write/src`, com artefacto de desenvolvimento local verificado por manifesto/pin em `packages/inventory-write/development`. A versão publicada 0.1.0, os seus bytes e manifesto foram conferidos e preservados. A matemática foi movida do protótipo para essa fonte; não há segundo escritor, saldo ou implementação aritmética. Nenhuma migração nova para conversões. Configuração `inventory_conversion.qa_enabled=false`; não existe comutador ambiental de activação. O loader exige testing e SQLite em memória ou PostgreSQL descartável com nome verificado. Fora desse contexto recusa o contrato novo.
Factor racional, artigo, unidade documental/base, fonte e versão ficam congelados na confirmação de entrega ou, na sua ausência, na primeira recepção aceite. Parcelas posteriores reutilizam a base. Recepção, ordem e factura conservam quantidades/preços originais; uma única movimentação usa a quantidade física exacta. A projecção de reposição converte só a parcela pendente e o formulário de recepção reutiliza a confirmação sem reintrodução. Lotes/qualidade usam unidades físicas; devoluções conservam a equivalência documental para saldo da ordem e facturação; estorno nega a movimentação efectiva sem alterar originais. Quantidades não representáveis em milésimos, fonte ausente ou alteração de base são recusadas.
Exemplos exclusivamente sintéticos: duas caixas × 100 MZN = 200 MZN facturados e 24 unidades em stock; 1,5 caixas recebidas deixam 6 unidades previstas; devolver 6 unidades corresponde a 0,5 caixa; estornar a recepção inteira retira 24 unidades e repõe 2 caixas pendentes. Não há compensações financeiras ou conversão de preços.
Verificação final: 20 testes/85 asserções SQLite (10 de integração e 10 aritméticos); 10/67 PostgreSQL, mais duas corridas com dois escritores realmente bloqueados na linha da empresa (mesmo corpo: 200/200 e um efeito; corpo divergente: 200/422 e um efeito). Base `compras_receipts_test_7fd1982b0741` removida no finally. Regressões dos percursos anteriores: 118/1346 de recepção/lotes/devoluções/estornos/impressão e 57/1131 de fornecimento/reposição/tarefas; baterias sobrepostas, não somar. PHPStan global zero; TypeScript e check dirigido de 7 ficheiros passaram; suite frontend integral 95/95. Compilação privada final em `storage/framework/testing/unit-conversion-build-final-20261121`, 13,37 s, sem substituir assets do piloto.
Os dois contratos usam deliberadamente a mesma classe canónica. Para evitar substituição de versões no mesmo processo, `tests/Conversion/ReceiptQuantityConversionTest.php` corre num kernel separado; `ReceiptQuantityConversionIsolationTest` integra-o na suite Feature sem carregar o escritor novo no kernel antigo. Regressão dessa fronteira junto da recepção publicada: 32/194 aprovados. Logs em `storage/logs/unit-conversion-release-sqlite.txt`, `unit-conversion-release-postgres.txt`, `unit-conversion-legacy-tests.txt`, `unit-conversion-supply-regression.txt`, `unit-conversion-kernel-isolation.txt`, `unit-conversion-supply-phpstan.txt`, `unit-conversion-supply-types.txt`, `unit-conversion-final-frontend-check.txt`, `unit-conversion-all-frontend.txt` e `unit-conversion-final-build.txt`.
Estado: preparação funcional QA concluída neste recorte; sem publicação/instalação/activação no piloto ou SGF, sem contas/permissões/dados reais ou aceitação comercial. Reversão deve conservar a leitura/repetição de operações convertidas. Revisão visual, capacidade, cobertura integral da proposta e implantação permanecem pendentes. A formatação global inicial continua a falhar em artefactos/documentos/estado operacional; não foi mascarada nem corrigida por formatação em massa. Próxima tarefa: conferir visualmente o percurso integrado numa candidata QA, preservando esta separação de ambientes.
+1 -1
View File
@@ -4,7 +4,7 @@
Preparação de contrato expressamente autorizada em QA. Fonte única em `sgf-tempo/packages/inventory-write/src`; artefacto de desenvolvimento verificado em `packages/inventory-write/development`, sem alterar ou publicar a versão 0.1.0. Adaptação em `ReceiptQuantityConversion`, escritor e recepção; lotes recebem quantidade física, devoluções conservam equivalência documental, saldo da ordem/facturação conservam unidade comercial. Factor, artigo, unidades, fonte e versão congelados na primeira recepção aceite da linha. Não há câmbio de preços nem arredondamento de quantidades. Preparação de contrato expressamente autorizada em QA. Fonte única em `sgf-tempo/packages/inventory-write/src`; artefacto de desenvolvimento verificado em `packages/inventory-write/development`, sem alterar ou publicar a versão 0.1.0. Adaptação em `ReceiptQuantityConversion`, escritor e recepção; lotes recebem quantidade física, devoluções conservam equivalência documental, saldo da ordem/facturação conservam unidade comercial. Factor, artigo, unidades, fonte e versão congelados na primeira recepção aceite da linha. Não há câmbio de preços nem arredondamento de quantidades.
Prova sintética: 2 caixas × 100 MZN = 200 MZN documentais, 24 unidades físicas; parcelas 1,5 + 0,5 caixas, repetição única, devolução de 6 unidades = 0,5 caixa, lotes de 24 unidades em quarentena e recusa de lote documental de 2 caixas. Arquivo antigo e configuração do piloto preservados. Estado: preparação QA, não instalação/activação ou aceitação comercial. Provas finais em `docs/desenvolvimento.md`. Prova sintética: 2 caixas × 100 MZN = 200 MZN documentais, 24 unidades físicas; parcelas 1,5 + 0,5 caixas, repetição única, devolução de 6 unidades = 0,5 caixa, lotes de 24 unidades em quarentena e recusa de lote documental de 2 caixas. Confirmação de entrega reutilizada na recepção e projecção pendente em unidades-base; estorno físico de 24 unidades repõe 2 caixas pendentes. Vinte testes/85 asserções SQLite, dez/67 PostgreSQL e duas corridas com contenção real; regressões antigas, 95 frontend, tipos, PHPStan global e compilação privada aprovados. Arquivo antigo e configuração do piloto preservados. Estado: preparação QA, não instalação/activação ou aceitação comercial. Provas finais em `docs/desenvolvimento.md`.
## Actualização de 21/11/2026 — multimoeda e conferência integrada ## Actualização de 21/11/2026 — multimoeda e conferência integrada
+2 -2
View File
@@ -6,9 +6,9 @@ Pedido executivo: implementar os módulos/funcionalidades em falta e as suas lig
Decisão desta sessão: taxa explícita para MZN, informada por Finanças com data e fonte e congelada no processo, aprovada pelo proprietário. `QuotationExchange` e migração `2026_11_21_000001` implementados; **migração não instalada no piloto**. Moeda original nas propostas/ordens/facturas/pagamentos externos; referência MZN na comparação/alçadas/investimento/orçamento; facturas parciais usam conversão cumulativa e cancelamento reverte o compromisso MZN original. Estrutura nova apenas em QA, sem alteração de acessos, MFA, configurações, dados do piloto ou SGF. Percurso monetário actual de duas casas decimais; não executa câmbio bancário nem diferenças cambiais. Decisão desta sessão: taxa explícita para MZN, informada por Finanças com data e fonte e congelada no processo, aprovada pelo proprietário. `QuotationExchange` e migração `2026_11_21_000001` implementados; **migração não instalada no piloto**. Moeda original nas propostas/ordens/facturas/pagamentos externos; referência MZN na comparação/alçadas/investimento/orçamento; facturas parciais usam conversão cumulativa e cancelamento reverte o compromisso MZN original. Estrutura nova apenas em QA, sem alteração de acessos, MFA, configurações, dados do piloto ou SGF. Percurso monetário actual de duas casas decimais; não executa câmbio bancário nem diferenças cambiais.
Entregues também CSV completo da conferência e descarga de documentos de fornecedores com integridade/revalidação. Provas e limites na actualização de 21/11 de `matriz-sgc-reconciliada.md`. Compilação em `storage/framework/testing/exchange-build-20261121`, sem substituir os assets do piloto. A análise estática dirigida passou; as verificações globais iniciais registaram falhas e precisam de reconciliação, sem as ocultar ou declarar aceitação integral. Entregues também CSV completo da conferência, descarga de documentos de fornecedores com integridade/revalidação e contas bancárias independentes ligadas a pagamentos/tarefas. PHPStan global sem erros, 95 testes frontend aprovados e TypeScript aprovado. Compilações privadas, incluindo `storage/framework/testing/unit-conversion-build-final-20261121`, sem substituir os assets do piloto. A formatação global mantém falhas iniciais em documentos/artefactos/estado operacional; não os reformatar em massa nem declarar o comando global aprovado. Provas e limites na matriz e em `desenvolvimento.md`.
Decisão expressa posterior nesta sessão: «Manter a formalização pendente». Não implementar nem activar a formalização de Pessoas; a selecção e a minuta conservam os seus estados e continuam distintas de contrato formalizado/RH. Continuar frentes independentes. Formalização, execução/encerramento, conversões gerais, cobertura integral das fontes e revisão visual permanecem por concluir. Os registos seguintes são históricos e preservam o respectivo âmbito. Decisões expressas posteriores: «Manter a formalização pendente» e «Autorizar a extensão em QA» do contrato de inventário. Não implementar nem activar formalização de Pessoas; selecção/minuta continuam distintas de contrato formalizado/RH. A extensão de unidades foi preparada e verificada na fonte comum e em Compras: documento/valor original, stock físico convertido, parcelas, lotes, devoluções, estorno e reposição. Configuração desligada; loader aceita apenas testing/base descartável, sem instalação/publicação/activação no piloto ou SGF. O writer antigo não é substituído no mesmo kernel: ensaio de conversões separado em `tests/Conversion`, com wrapper na suite Feature. Produto integral, implantação, capacidade e revisão visual continuam pendentes. Os registos seguintes são históricos e preservam o respectivo âmbito.
**Último estado — sourcing preparado, demonstração parcial:** candidata **040fb0cb67a77d61**, manifesto `040fb0cb67a77d618011bc7ab365c53d3d4b1a787c4c0c0a2d54f315b3658e58`, [entrega/provas/recuperação](consultas-adjudicacao-sgf.md). Em 8039/55439/1:1:1 há fornecedores, três cotações e um avaliador por cotação; o fluxo completo foi confirmado **só nas cópias isoladas**. Proprietário recusou quarta conta e autorizou exactamente prepare ao ID 1, evaluate/propose ao ID 2; não conceder confirm, aprovação ao requerente ou escrita ao Consulta para completar o cenário. Requisição 1/100 MZN/versão 3 e reserva única intactas. Não declarar integração integral ou adjudicação concluída na demonstração. **Último estado — sourcing preparado, demonstração parcial:** candidata **040fb0cb67a77d61**, manifesto `040fb0cb67a77d618011bc7ab365c53d3d4b1a787c4c0c0a2d54f315b3658e58`, [entrega/provas/recuperação](consultas-adjudicacao-sgf.md). Em 8039/55439/1:1:1 há fornecedores, três cotações e um avaliador por cotação; o fluxo completo foi confirmado **só nas cópias isoladas**. Proprietário recusou quarta conta e autorizou exactamente prepare ao ID 1, evaluate/propose ao ID 2; não conceder confirm, aprovação ao requerente ou escrita ao Consulta para completar o cenário. Requisição 1/100 MZN/versão 3 e reserva única intactas. Não declarar integração integral ou adjudicação concluída na demonstração.
+3 -3
View File
@@ -45,7 +45,7 @@ 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. 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 ## Conversões de unidades — proposta autorizada em QA, 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. 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.
@@ -53,6 +53,6 @@ Proposta: conservar quantidades e preços da compra/factura na unidade original
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. 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. Aritmética agora integrada na fonte comum `inventory-write/src/QuantityConversion.php`, distribuída apenas como artefacto de desenvolvimento verificado em Compras; o protótipo anterior em purchasing foi removido para não duplicar a implementação. Percurso compra→recepção→stock→factura, parcelas/reenvio, conflitos de factor/versão, lotes/qualidade, devoluções, estorno e reposição verificados 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. **Estado: autorizado e preparado em desenvolvimento/QA** pela resposta «Autorizar a extensão em QA». A fonte comum e a adaptação foram alteradas; a versão publicada 0.1.0 permanece intacta. A confirmação de entrega congela a base antes da recepção quando existe; sem confirmação anterior, congela-a a primeira recepção aceite da linha. A projecção converte só a quantidade pendente, conservando a quantidade comercial acumulada da confirmação. Ver provas em `desenvolvimento.md`.
+49 -2
View File
@@ -1,5 +1,9 @@
import { Head, Link, router, useForm } from '@inertiajs/react'; import { Head, Link, router, useForm } from '@inertiajs/react';
import { useEffect, useState } from 'react'; import { useEffect, useState } from 'react';
import {
ReceiptConversionFields,
type ReceiptConversion,
} from '@/components/receipt-conversion';
import { import {
FormErrors, FormErrors,
PageTitle, PageTitle,
@@ -39,10 +43,16 @@ type RecordVersion = {
warehouse: { name: string }; warehouse: { name: string };
substitute?: { name: string; code: string; unit: string }; substitute?: { name: string; code: string; unit: string };
order?: { number: string }; order?: { number: string };
order_line?: { unit: string };
quantity_conversion?: ReceiptConversion & {
document_unit: string;
stock_unit: string;
};
}; };
}; };
type Source = { type Source = {
id: number; id: number;
unit?: string;
label: string; label: string;
stock_item_id: number | null; stock_item_id: number | null;
quantity_milli: number; quantity_milli: number;
@@ -50,6 +60,7 @@ type Source = {
needed_on?: string; needed_on?: string;
}; };
type Props = { type Props = {
conversionQaEnabled?: boolean;
recordFilters?: CoordinationFilters; recordFilters?: CoordinationFilters;
lineSearch?: string; lineSearch?: string;
lineFormKey?: string | null; lineFormKey?: string | null;
@@ -109,6 +120,14 @@ const quantity = (milli: number) =>
(milli / 1000).toLocaleString('pt-MZ', { maximumFractionDigits: 3 }); (milli / 1000).toLocaleString('pt-MZ', { maximumFractionDigits: 3 });
function Prepare({ props, old }: { props: Props; old?: RecordVersion }) { function Prepare({ props, old }: { props: Props; old?: RecordVersion }) {
const [conversion, setConversion] = useState<ReceiptConversion>(
old?.snapshot.quantity_conversion ?? {
numerator: '',
denominator: '',
source: '',
version: '',
},
);
const [orderLines, setOrderLines] = useState(props.orderLines); const [orderLines, setOrderLines] = useState(props.orderLines);
const [requestLines, setRequestLines] = useState(props.requestLines); const [requestLines, setRequestLines] = useState(props.requestLines);
const lineFormKey = `${props.kind}:${old?.id ?? 'new'}`; const lineFormKey = `${props.kind}:${old?.id ?? 'new'}`;
@@ -162,6 +181,19 @@ function Prepare({ props, old }: { props: Props; old?: RecordVersion }) {
reason: '', reason: '',
data: defaults, data: defaults,
}); });
const documentUnit =
orderLines.find(
(line) => line.id === Number(form.data.data.purchase_order_item_id),
)?.unit ?? old?.snapshot.order_line?.unit;
const stockUnit = props.items.find(
(item) => item.id === Number(form.data.data.stock_item_id),
)?.unit;
const needsConversion =
props.conversionQaEnabled &&
props.kind === 'delivery' &&
documentUnit &&
stockUnit &&
documentUnit.toLowerCase() !== stockUnit.toLowerCase();
const update = (key: string, value: Fields[string]) => const update = (key: string, value: Fields[string]) =>
form.setData('data', { ...form.data.data, [key]: value }); form.setData('data', { ...form.data.data, [key]: value });
const field = ( const field = (
@@ -249,7 +281,13 @@ function Prepare({ props, old }: { props: Props; old?: RecordVersion }) {
); );
delete data.quantity; delete data.quantity;
} }
return { ...input, data }; return {
...input,
data: {
...data,
...(needsConversion ? { conversion } : {}),
},
};
}); });
form.post(`/compras/fornecimento/${props.kind}`, { form.post(`/compras/fornecimento/${props.kind}`, {
preserveScroll: true, preserveScroll: true,
@@ -403,6 +441,14 @@ function Prepare({ props, old }: { props: Props; old?: RecordVersion }) {
</> </>
) : ( ) : (
<> <>
{needsConversion && (
<ReceiptConversionFields
value={conversion}
onChange={setConversion}
documentUnit={documentUnit}
stockUnit={stockUnit}
/>
)}
{field( {field(
'quantity', 'quantity',
props.kind === 'delivery' props.kind === 'delivery'
@@ -767,7 +813,8 @@ function Facts({
: 'Quantidade: '} : 'Quantidade: '}
<strong> <strong>
{quantity(Number(r.data.quantity_milli))}{' '} {quantity(Number(r.data.quantity_milli))}{' '}
{r.snapshot.item.unit} {r.snapshot.quantity_conversion?.document_unit ??
r.snapshot.item.unit}
</strong> </strong>
{r.data.applications && {r.data.applications &&
` · Pendente: ${quantity(pending ?? Number(r.data.quantity_milli) - applied)}`} ` · Pendente: ${quantity(pending ?? Number(r.data.quantity_milli) - applied)}`}
+1 -1
View File
@@ -38,7 +38,7 @@ try {
$bankMode = in_array('--bank-accounts-only', $argv, true); $bankMode = in_array('--bank-accounts-only', $argv, true);
$conversionMode = in_array('--unit-conversion-only', $argv, true); $conversionMode = in_array('--unit-conversion-only', $argv, true);
if ($conversionMode) { if ($conversionMode) {
$commands = [[PHP_BINARY, 'vendor/bin/pest', '--compact', 'tests/Feature/ReceiptQuantityConversionTest.php']]; $commands = [[PHP_BINARY, 'vendor/bin/pest', '--compact', 'tests/Conversion/ReceiptQuantityConversionTest.php']];
$commands[] = [PHP_BINARY, 'tests/Concurrency/unit-conversion-worker.php', $database, 'race']; $commands[] = [PHP_BINARY, 'tests/Concurrency/unit-conversion-worker.php', $database, 'race'];
} }
if ($bankMode && ! in_array('--concurrency-only', $argv, true)) { if ($bankMode && ! in_array('--concurrency-only', $argv, true)) {
@@ -1,5 +1,7 @@
<?php <?php
// Run in its own kernel: development and published writers deliberately share one canonical class.
use App\Enums\PurchasingRole; use App\Enums\PurchasingRole;
use App\Models\GoodsReceipt; use App\Models\GoodsReceipt;
use App\Models\PurchaseAward; use App\Models\PurchaseAward;
@@ -9,11 +11,13 @@ use App\Models\User;
use App\Services\ConflictGuard; use App\Services\ConflictGuard;
use App\Services\InventoryDispositions; use App\Services\InventoryDispositions;
use App\Services\InventoryLots; use App\Services\InventoryLots;
use App\Services\InventoryReversals;
use App\Services\InvoiceWorkflow; use App\Services\InvoiceWorkflow;
use App\Services\ReceiptStockMovement; use App\Services\ReceiptStockMovement;
use App\Services\ReceiptWorkflow; use App\Services\ReceiptWorkflow;
use App\Services\RequisitionWorkflow; use App\Services\RequisitionWorkflow;
use App\Services\StockWorkflow; use App\Services\StockWorkflow;
use App\Services\SupplyCoordination;
use Illuminate\Support\Facades\DB; use Illuminate\Support\Facades\DB;
use Illuminate\Validation\ValidationException; use Illuminate\Validation\ValidationException;
@@ -181,3 +185,48 @@ test('lot allocation and quality follow converted physical quantities rather tha
expect($context['reconciled'])->toBeTrue()->and($context['lots'][0]['quantity_milli'])->toBe(24000) expect($context['reconciled'])->toBeTrue()->and($context['lots'][0]['quantity_milli'])->toBe(24000)
->and($context['usable_milli'])->toBe(0); ->and($context['usable_milli'])->toBe(0);
}); });
test('confirmed delivery feeds replenishment in base units and supplies the same frozen factor to receipt', function () {
supplyGrant($this->f['receiver'], ['warehouse', 'supply_delivery']);
$this->actingAs($this->f['receiver']);
$coordination = app(SupplyCoordination::class);
$data = ['stock_item_id' => $this->f['stock']->id, 'warehouse_id' => $this->f['warehouse']->id, 'purchase_order_item_id' => $this->f['line']->id,
'quantity_milli' => 2000, 'expected_on' => today()->addDay()->toDateString(), 'confirmed_on' => today()->toDateString(),
'evidence' => 'Confirmação sintética de duas caixas.', 'conversion' => $this->conversion];
$record = $coordination->save($this->f['receiver'], 'delivery', supplyInput($data));
expect($coordination->remainingDelivery($record))->toBe(24000)
->and($coordination->events($this->f['stock']->id, $this->f['warehouse']->id, today()->toDateString())['receipts'][0]['quantity'])->toBe(24000);
$body = $this->body;
unset($body['items'][0]['conversion']);
$body['items'][0]['received_quantity'] = $body['items'][0]['accepted_quantity'] = '1.500';
$this->postJson($this->url, $body)->assertCreated();
expect($coordination->remainingDelivery($record))->toBe(6000)
->and($coordination->events($this->f['stock']->id, $this->f['warehouse']->id, today()->toDateString())['receipts'][0]['quantity'])->toBe(6000)
->and(StockMovement::query()->sole()->quantity_milli)->toBe(18000);
$bad = $data;
$bad['conversion']['numerator'] = '24';
expect(fn () => $coordination->save($this->f['receiver'], 'delivery', supplyInput($bad, 'save', $record)))->toThrow(ValidationException::class);
});
test('receipt reversal negates the physical movement and restores documentary pending quantity without rewriting originals', function () {
$this->postJson($this->url, $this->body)->assertCreated();
$line = GoodsReceipt::query()->sole()->items()->sole();
$original = StockMovement::query()->sole();
supplyGrant($this->f['receiver'], ['warehouse', 'inventory_reversal_prepare']);
supplyGrant($this->f['issuer'], ['inventory_reversal_review']);
$workflow = app(InventoryReversals::class);
$this->actingAs($this->f['receiver']);
$draft = $workflow->save($this->f['receiver'], supplyInput(['reference' => 'QA-BOX-REVERSAL', 'source_kind' => 'receipt', 'receipt_item_id' => $line->id]));
$this->actingAs($this->f['issuer']);
$approved = $workflow->save($this->f['issuer'], supplyInput([], 'approve', $draft));
$this->actingAs($this->f['receiver']);
$payload = supplyInput(['event_on' => today()->toDateString(), 'evidence' => 'Prova sintética de estorno das duas caixas.'], 'execute', $approved);
$executed = $workflow->save($this->f['receiver'], $payload);
expect($workflow->save($this->f['receiver'], $payload)->id)->toBe($executed->id)
->and(StockMovement::query()->count())->toBe(2)
->and(StockMovement::query()->where('stock_operation_id', $executed->data['stock_operation_id'])->sole()->quantity_milli)->toBe(-24000)
->and($original->fresh()->quantity_milli)->toBe(24000)
->and($line->fresh()->accepted_milli)->toBe(2000)
->and(app(ReceiptWorkflow::class)->progress($this->f['order'])['lines'][0]['delivery_pending_milli'])->toBe(2000)
->and(app(StockWorkflow::class)->balance($this->f['stock']->id, $this->f['warehouse']->id)['quantity'])->toBe(0);
});
@@ -0,0 +1,20 @@
<?php
namespace Tests\Feature;
use Symfony\Component\Process\Process;
use Tests\TestCase;
final class ReceiptQuantityConversionIsolationTest extends TestCase
{
public function test_conversion_contract_in_an_isolated_kernel_without_replacing_the_published_writer(): void
{
// The normal Feature suite may already have loaded the published writer. Never replace it in process.
$process = new Process([PHP_BINARY, 'vendor/bin/pest', '--compact', 'tests/Conversion/ReceiptQuantityConversionTest.php'], base_path(), [
'APP_ENV' => 'testing', 'DB_CONNECTION' => 'sqlite', 'DB_DATABASE' => ':memory:', 'DB_URL' => false,
'CACHE_STORE' => 'array', 'SESSION_DRIVER' => 'array', 'MAIL_MAILER' => 'array', 'QUEUE_CONNECTION' => 'sync', 'BROADCAST_CONNECTION' => 'null',
], timeout: 120);
$process->run();
$this->assertTrue($process->isSuccessful(), $process->getOutput().$process->getErrorOutput());
}
}
+3
View File
@@ -18,6 +18,9 @@ pest()->extend(TestCase::class)
->use(RefreshDatabase::class) ->use(RefreshDatabase::class)
->in('Feature'); ->in('Feature');
// A separate invocation is required for the unpublished inventory contract; Feature has a process wrapper.
pest()->extend(TestCase::class)->use(RefreshDatabase::class)->in('Conversion');
/* /*
|-------------------------------------------------------------------------- |--------------------------------------------------------------------------
| Expectations | Expectations