diff --git a/app/Http/Controllers/SupplyPlanningController.php b/app/Http/Controllers/SupplyPlanningController.php index eb98604..20f5d70 100644 --- a/app/Http/Controllers/SupplyPlanningController.php +++ b/app/Http/Controllers/SupplyPlanningController.php @@ -305,6 +305,7 @@ class SupplyPlanningController extends Controller '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, 'quantity_milli' => ReceiptWorkflow::milli($line->quantity), + 'unit' => $line->unit, ]); $requests = collect(); if ($canPrepare && $kind === 'reservation') { @@ -340,6 +341,7 @@ class SupplyPlanningController extends Controller } 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'] ?? ''], '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()], diff --git a/app/Services/ReceiptQuantityConversion.php b/app/Services/ReceiptQuantityConversion.php index 5f345aa..f059712 100644 --- a/app/Services/ReceiptQuantityConversion.php +++ b/app/Services/ReceiptQuantityConversion.php @@ -75,7 +75,7 @@ final class ReceiptQuantityConversion if ($basis === null) { 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(); try { return (int) QuantityConversion::fromBase((string) $physical, $basis['numerator'], $basis['denominator']); diff --git a/app/Services/ReceiptWorkflow.php b/app/Services/ReceiptWorkflow.php index b8b5bc1..03f3e28 100644 --- a/app/Services/ReceiptWorkflow.php +++ b/app/Services/ReceiptWorkflow.php @@ -95,6 +95,12 @@ class ReceiptWorkflow throw ValidationException::withMessages(['items' => 'Reutilize o artigo e armazém já associados à confirmação desta linha.']); } $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'])) { $orderLine = $order->items()->whereKey($line['purchase_order_item_id'])->first(); diff --git a/app/Services/SupplyCoordination.php b/app/Services/SupplyCoordination.php index cff433b..b3a1552 100644 --- a/app/Services/SupplyCoordination.php +++ b/app/Services/SupplyCoordination.php @@ -19,6 +19,7 @@ use Illuminate\Support\Facades\Schema; use Illuminate\Support\Facades\Validator; use Illuminate\Support\Str; use Illuminate\Validation\ValidationException; +use Tempo\Inventory\QuantityConversion; class SupplyCoordination { @@ -107,6 +108,9 @@ class SupplyCoordination app(OrderCancellationWorkflow::class)->assertOperational($order); $snapshot['order'] = $order->only(['id', 'number']); $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'; } 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', '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'], - '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), }; $data = Validator::make($input, $rules)->validate(); @@ -208,7 +213,11 @@ class SupplyCoordination app(OrderCancellationWorkflow::class)->assertOperational($order); $stock = StockItem::query()->whereKey($data['stock_item_id'])->firstOrFail(); $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.'); $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.'); @@ -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.'); // 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); + 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.'); $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.'); @@ -244,7 +256,15 @@ class SupplyCoordination { $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> $applications diff --git a/docs/desenvolvimento.md b/docs/desenvolvimento.md index f0be93a..61fa8d2 100644 --- a/docs/desenvolvimento.md +++ b/docs/desenvolvimento.md @@ -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. -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. diff --git a/docs/matriz-sgc-reconciliada.md b/docs/matriz-sgc-reconciliada.md index bc7fc2d..76cdd07 100644 --- a/docs/matriz-sgc-reconciliada.md +++ b/docs/matriz-sgc-reconciliada.md @@ -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. -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 diff --git a/docs/orientacoes-continuidade.md b/docs/orientacoes-continuidade.md index 3e0a135..820966b 100644 --- a/docs/orientacoes-continuidade.md +++ b/docs/orientacoes-continuidade.md @@ -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. -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. diff --git a/docs/plano-entregas-sgc.md b/docs/plano-entregas-sgc.md index e3d32f1..abc890b 100644 --- a/docs/plano-entregas-sgc.md +++ b/docs/plano-entregas-sgc.md @@ -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. -## 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. @@ -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. -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`. diff --git a/resources/js/pages/supply/coordination.tsx b/resources/js/pages/supply/coordination.tsx index b152308..ab7a6b6 100644 --- a/resources/js/pages/supply/coordination.tsx +++ b/resources/js/pages/supply/coordination.tsx @@ -1,5 +1,9 @@ import { Head, Link, router, useForm } from '@inertiajs/react'; import { useEffect, useState } from 'react'; +import { + ReceiptConversionFields, + type ReceiptConversion, +} from '@/components/receipt-conversion'; import { FormErrors, PageTitle, @@ -39,10 +43,16 @@ type RecordVersion = { warehouse: { name: string }; substitute?: { name: string; code: string; unit: string }; order?: { number: string }; + order_line?: { unit: string }; + quantity_conversion?: ReceiptConversion & { + document_unit: string; + stock_unit: string; + }; }; }; type Source = { id: number; + unit?: string; label: string; stock_item_id: number | null; quantity_milli: number; @@ -50,6 +60,7 @@ type Source = { needed_on?: string; }; type Props = { + conversionQaEnabled?: boolean; recordFilters?: CoordinationFilters; lineSearch?: string; lineFormKey?: string | null; @@ -109,6 +120,14 @@ const quantity = (milli: number) => (milli / 1000).toLocaleString('pt-MZ', { maximumFractionDigits: 3 }); function Prepare({ props, old }: { props: Props; old?: RecordVersion }) { + const [conversion, setConversion] = useState( + old?.snapshot.quantity_conversion ?? { + numerator: '', + denominator: '', + source: '', + version: '', + }, + ); const [orderLines, setOrderLines] = useState(props.orderLines); const [requestLines, setRequestLines] = useState(props.requestLines); const lineFormKey = `${props.kind}:${old?.id ?? 'new'}`; @@ -162,6 +181,19 @@ function Prepare({ props, old }: { props: Props; old?: RecordVersion }) { reason: '', 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]) => form.setData('data', { ...form.data.data, [key]: value }); const field = ( @@ -249,7 +281,13 @@ function Prepare({ props, old }: { props: Props; old?: RecordVersion }) { ); delete data.quantity; } - return { ...input, data }; + return { + ...input, + data: { + ...data, + ...(needsConversion ? { conversion } : {}), + }, + }; }); form.post(`/compras/fornecimento/${props.kind}`, { preserveScroll: true, @@ -403,6 +441,14 @@ function Prepare({ props, old }: { props: Props; old?: RecordVersion }) { ) : ( <> + {needsConversion && ( + + )} {field( 'quantity', props.kind === 'delivery' @@ -767,7 +813,8 @@ function Facts({ : 'Quantidade: '} {quantity(Number(r.data.quantity_milli))}{' '} - {r.snapshot.item.unit} + {r.snapshot.quantity_conversion?.document_unit ?? + r.snapshot.item.unit} {r.data.applications && ` · Pendente: ${quantity(pending ?? Number(r.data.quantity_milli) - applied)}`} diff --git a/scripts/quotation-exchange-pg-check.php b/scripts/quotation-exchange-pg-check.php index bd05f15..a2b609f 100644 --- a/scripts/quotation-exchange-pg-check.php +++ b/scripts/quotation-exchange-pg-check.php @@ -38,7 +38,7 @@ try { $bankMode = in_array('--bank-accounts-only', $argv, true); $conversionMode = in_array('--unit-conversion-only', $argv, true); 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']; } if ($bankMode && ! in_array('--concurrency-only', $argv, true)) { diff --git a/tests/Feature/ReceiptQuantityConversionTest.php b/tests/Conversion/ReceiptQuantityConversionTest.php similarity index 76% rename from tests/Feature/ReceiptQuantityConversionTest.php rename to tests/Conversion/ReceiptQuantityConversionTest.php index bf16de7..c6352d1 100644 --- a/tests/Feature/ReceiptQuantityConversionTest.php +++ b/tests/Conversion/ReceiptQuantityConversionTest.php @@ -1,5 +1,7 @@ toBeTrue()->and($context['lots'][0]['quantity_milli'])->toBe(24000) ->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); +}); diff --git a/tests/Feature/ReceiptQuantityConversionIsolationTest.php b/tests/Feature/ReceiptQuantityConversionIsolationTest.php new file mode 100644 index 0000000..385bfba --- /dev/null +++ b/tests/Feature/ReceiptQuantityConversionIsolationTest.php @@ -0,0 +1,20 @@ + '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()); + } +} diff --git a/tests/Pest.php b/tests/Pest.php index 941e024..c634ac0 100644 --- a/tests/Pest.php +++ b/tests/Pest.php @@ -18,6 +18,9 @@ pest()->extend(TestCase::class) ->use(RefreshDatabase::class) ->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