true]); $this->f = receiptFixture(); // New consistent synthetic process: 2 boxes x 100 MZN = 200 MZN. Original fixture is untouched. $request = $this->f['r']->replicate(); $request->forceFill(['number' => 'QA-CONVERSION-REQUEST', 'subtotal_minor' => 20000, 'total_minor' => 20000])->save(); $requested = $this->f['r']->items()->sole()->replicate(); $requested->forceFill(['requisition_id' => $request->id, 'quantity' => '2.000', 'subtotal_minor' => 20000, 'total_minor' => 20000])->save(); $oldAward = PurchaseAward::query()->findOrFail($this->f['order']->purchase_award_id); $quote = Quotation::query()->findOrFail($oldAward->quotation_id)->replicate(); $quote->forceFill(['requisition_id' => $request->id, 'subtotal_minor' => 20000, 'total_minor' => 20000])->save(); $award = $oldAward->replicate(); $award->forceFill(['requisition_id' => $request->id, 'quotation_id' => $quote->id, 'subtotal_minor' => 20000, 'total_minor' => 20000])->save(); $order = $this->f['order']->replicate(); $order->forceFill(['number' => 'QA-CONVERSION-ORDER', 'requisition_id' => $request->id, 'purchase_award_id' => $award->id, 'subtotal_minor' => 20000, 'total_minor' => 20000])->save(); $line = $this->f['line']->replicate(); $line->forceFill(['purchase_order_id' => $order->id, 'requisition_item_id' => $requested->id, 'quantity' => '2.000', 'subtotal_minor' => 20000, 'total_minor' => 20000])->save(); $this->f['line'] = $line; $this->f['order'] = $order; $this->f['r'] = $request; $this->f['stock']->update(['unit' => 'un']); $this->actingAs($this->f['receiver']); $this->url = '/ordens/'.$order->id.'/recepcoes'; $this->conversion = ['numerator' => '12', 'denominator' => '1', 'source' => 'Embalagem sintética de teste', 'version' => 'QA-1']; $this->body = receiptPayload($this->f, '2.000'); $this->body['items'][0]['conversion'] = $this->conversion; }); test('two boxes retain two documentary units and 200 MZN while crediting exactly 24 physical units once', function () { $id = $this->postJson($this->url, $this->body)->assertCreated()->json('id'); $this->postJson($this->url, $this->body)->assertOk()->assertJsonPath('id', $id); $line = GoodsReceipt::query()->findOrFail($id)->items()->sole(); $movement = StockMovement::query()->sole(); expect($line->accepted_milli)->toBe(2000)->and($movement->quantity_milli)->toBe(24000) ->and($this->f['order']->fresh()->total_minor)->toBe(20000) ->and($this->f['line']->fresh()->unit_price_minor)->toBe(10000) ->and($movement->snapshot['quantity_conversion']['source'])->toBe($this->conversion['source']); $result = DB::transaction(function () use ($line, $movement) { app(ConflictGuard::class)->lockCompany($this->f['receiver']); return app(ReceiptStockMovement::class)->for($this->f['receiver'])->write($line->id, $movement->snapshot['inventory_source_hash']); }); expect($result['replayed'])->toBeTrue()->and(StockMovement::query()->count())->toBe(1); $this->get('/recepcoes/'.$id.'/imprimir')->assertOk()->assertSee('Stock: 24,000')->assertSee('versão QA-1'); $finance = User::factory()->create(['tenant_id' => $this->f['tenant']->id, 'purchasing_role' => PurchasingRole::Finance]); $this->actingAs($finance); $invoice = app(InvoiceWorkflow::class)->register($finance, $this->f['order'], [ 'number' => 'QA-BOXES', 'issued_on' => today()->toDateString(), 'subtotal' => '200.00', 'tax' => '0.00', 'total' => '200.00', 'items' => [['purchase_order_item_id' => $this->f['line']->id, 'quantity' => '2.000', 'unit' => 'cx', 'unit_price' => '100.00', 'tax_rate' => '0']], ]); expect($invoice->total_minor)->toBe(20000)->and($invoice->items()->sole()->quantity_milli)->toBe(2000); }); test('partial receipts freeze the factor article units source and version of the order line', function () { $body = $this->body; $body['items'][0]['received_quantity'] = $body['items'][0]['accepted_quantity'] = '1.500'; $this->postJson($this->url, $body)->assertCreated(); $next = receiptPayload($this->f, '0.500'); $next['items'][0]['conversion'] = $this->conversion; $bad = $next; $bad['items'][0]['conversion']['numerator'] = '24'; $this->postJson($this->url, $bad)->assertUnprocessable(); $bad = $next; $bad['items'][0]['conversion']['version'] = 'QA-2'; $this->postJson($this->url, $bad)->assertUnprocessable(); $this->postJson($this->url, $next)->assertCreated(); expect((int) StockMovement::query()->sum('quantity_milli'))->toBe(24000) ->and(app(ReceiptWorkflow::class)->progress($this->f['order'])['state'])->toBe('complete'); }); test('missing source factor and nonrepresentable physical quantities never create a receipt', function () { $bad = $this->body; unset($bad['items'][0]['conversion']); $this->postJson($this->url, $bad)->assertUnprocessable(); $bad = $this->body; $bad['items'][0]['conversion']['source'] = ''; $this->postJson($this->url, $bad)->assertUnprocessable(); $bad = $this->body; $bad['items'][0]['received_quantity'] = $bad['items'][0]['accepted_quantity'] = '0.001'; $bad['items'][0]['conversion']['numerator'] = '1'; $bad['items'][0]['conversion']['denominator'] = '2'; $this->postJson($this->url, $bad)->assertUnprocessable(); expect(GoodsReceipt::query()->count())->toBe(0)->and(StockMovement::query()->count())->toBe(0); }); test('conversion is not enabled by its presence in a request and cannot escape the QA guard', function () { config(['inventory_conversion.qa_enabled' => false]); $this->postJson($this->url, $this->body)->assertUnprocessable(); expect(StockMovement::query()->count())->toBe(0); }); test('legacy receipt facts retain the exact v1 hash and compatible replay without a conversion basis', function () { $this->f['stock']->update(['unit' => 'cx']); $body = $this->body; unset($body['items'][0]['conversion']); $this->postJson($this->url, $body)->assertCreated(); $line = GoodsReceipt::query()->sole()->items()->sole(); $movement = StockMovement::query()->sole(); $facts = DB::table('goods_receipt_items AS l')->join('goods_receipts AS r', fn ($j) => $j->on('r.id', '=', 'l.goods_receipt_id')->on('r.tenant_id', '=', 'l.tenant_id')) ->where('l.id', $line->id)->where('l.tenant_id', $this->f['tenant']->id) ->select(['l.id', 'l.tenant_id', 'l.stock_item_id', 'l.received_milli', 'l.accepted_milli', 'l.rejected_milli', 'l.quality_status', 'l.notes', 'l.snapshot AS line_snapshot', 'r.id AS receipt_id', 'r.purchase_order_id', 'r.received_by', 'r.warehouse_id', 'r.delivery_note', 'r.received_on', 'r.confirmed_at', 'r.snapshot AS receipt_snapshot'])->first(); expect($movement->snapshot['inventory_source_hash'])->toBe(hash('sha256', json_encode((array) $facts, JSON_THROW_ON_ERROR))) ->and($movement->quantity_milli)->toBe(2000)->and($line->snapshot)->not->toHaveKey('quantity_conversion'); DB::transaction(function () use ($line, $movement) { app(ConflictGuard::class)->lockCompany($this->f['receiver']); expect(app(ReceiptStockMovement::class)->for($this->f['receiver'])->write($line->id, $movement->snapshot['inventory_source_hash'])['replayed'])->toBeTrue(); }); }); test('conversion cannot bypass actor eligibility and a failed audit rolls back the physical effect', function () { $this->actingAs($this->f['issuer'])->postJson($this->url, $this->body)->assertForbidden(); $this->actingAs($this->f['receiver']); $this->mock(RequisitionWorkflow::class, function ($mock) { $mock->shouldReceive('audit')->andThrow(new RuntimeException('Synthetic audit failure')); }); expect(fn () => app(ReceiptWorkflow::class)->confirm($this->f['receiver'], $this->f['order'], $this->body))->toThrow(RuntimeException::class, 'Synthetic audit failure'); expect(GoodsReceipt::query()->count())->toBe(0)->and(StockMovement::query()->count())->toBe(0); }); test('a supplier return uses physical units and subtracts the exact documentary equivalent for invoicing', function () { $this->postJson($this->url, $this->body)->assertCreated(); $source = GoodsReceipt::query()->sole()->items()->sole(); supplyGrant($this->f['receiver'], ['warehouse', 'inventory_disposition_prepare']); supplyGrant($this->f['issuer'], ['procurement', 'inventory_disposition_review']); $data = ['kind' => 'supplier_return', 'reference' => 'QA-RETURN-BOX', 'stock_item_id' => $this->f['stock']->id, 'warehouse_id' => $this->f['warehouse']->id, 'receipt_item_id' => $source->id, 'quantity' => '6.000']; $workflow = app(InventoryDispositions::class); $this->actingAs($this->f['receiver']); $draft = $workflow->save($this->f['receiver'], supplyInput($data)); expect($draft->data['document_quantity_milli'])->toBe(500); $this->actingAs($this->f['issuer']); $approved = $workflow->save($this->f['issuer'], supplyInput([], 'approve', $draft)); $this->actingAs($this->f['receiver']); $workflow->save($this->f['receiver'], supplyInput(['event_on' => today()->toDateString(), 'evidence' => 'Guia sintética assinada para teste.'], 'execute', $approved)); expect($workflow->returnedForReceipt($source->id))->toBe(6000) ->and($workflow->returnedForOrderLine($this->f['line']->id))->toBe(500) ->and(app(StockWorkflow::class)->balance($this->f['stock']->id, $this->f['warehouse']->id)['quantity'])->toBe(18000) ->and(app(ReceiptWorkflow::class)->progress($this->f['order'])['lines'][0]['effective_accepted_milli'])->toBe(1500); expect(fn () => $workflow->basis([...$data, 'quantity_milli' => 1]))->toThrow(ValidationException::class); }); test('lot allocation and quality follow converted physical quantities rather than boxes', function () { supplyGrant($this->f['issuer'], ['inventory_lot_prepare']); supplyGrant($this->f['receiver'], ['warehouse', 'inventory_lot_review']); $this->actingAs($this->f['issuer']); $lots = app(InventoryLots::class); $draft = $lots->save($this->f['issuer'], supplyInput(['stock_item_id' => $this->f['stock']->id, 'warehouse_id' => $this->f['warehouse']->id, 'requires_expiry' => true, 'minimum_remaining_days' => 0, 'lots' => []], 'prepare')); $this->actingAs($this->f['receiver']); $lots->save($this->f['receiver'], supplyInput([], 'activate', $draft)); $bad = $this->body; $bad['items'][0]['lots'] = [['code' => 'QA-BOX', 'expires_on' => today()->addYear()->toDateString(), 'quantity' => '2.000']]; $this->postJson($this->url, $bad)->assertUnprocessable(); expect(GoodsReceipt::query()->count())->toBe(0)->and(StockMovement::query()->count())->toBe(0); $bad['items'][0]['lots'][0]['quantity'] = '24.000'; $this->postJson($this->url, $bad)->assertCreated(); $context = $lots->context($this->f['stock']->id, $this->f['warehouse']->id); expect($context['reconciled'])->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); });