Skip to content

A free open source IT asset/license management system

6.7 KB
Raw Blame
<?php

namespace Tests\Feature\Accessories\Api;

use App\Enums\ActionType;
use App\Models\Accessory;
use App\Models\Actionlog;
use App\Models\Order;
use App\Models\Supplier;
use App\Models\User;
use Tests\TestCase;

/**
 * Order-side behavior of the adjust-quantity endpoint. Covers when an
 * Order + OrderItem is written (positive delta only), the dedup rule
 * on (order_number, supplier_id, company_id, purchase_date), and the
 * split of anonymous receipts. Sibling to AdjustAccessoryQuantityApiTest,
 * which covers the action_log + qty side of the same endpoint.
 */
class AdjustAccessoryOrderRecordingTest extends TestCase
{
    public function test_supplier_purchase_date_unit_cost_and_currency_land_on_order_and_order_item()
    {
        $accessory = Accessory::factory()->create(['qty' => 2]);
        $supplier = Supplier::factory()->create();

        $this->actingAsForApi(User::factory()->editAccessories()->create())
            ->postJson(route('api.accessories.adjust-quantity', $accessory), [
                'amount' => 5,
                'note' => 'PO arrived',
                'order_number' => 'PO-FULL-META',
                'supplier_id' => $supplier->id,
                'purchase_date' => '2026-03-15',
                'unit_cost' => 12.3456,
                'currency' => 'EUR',
            ])
            ->assertOk();

        $log = Actionlog::where('item_type', Accessory::class)
            ->where('item_id', $accessory->id)
            ->where('action_type', ActionType::QuantityAdjust->value)
            ->latest('id')
            ->firstOrFail();

        $order = $log->orderItem->order;
        $this->assertSame('PO-FULL-META', $order->order_number);
        $this->assertSame($supplier->id, (int) $order->supplier_id);
        $this->assertSame('2026-03-15', $order->purchase_date->toDateString());
        $this->assertSame('EUR', $order->currency);

        $line = $order->orderItems()->firstOrFail();
        $this->assertSame(Accessory::class, $line->item_type);
        $this->assertSame($accessory->id, (int) $line->item_id);
        $this->assertSame(5, (int) $line->qty);
        $this->assertEquals(12.3456, (float) $line->price);
    }

    public function test_audit_only_zero_delta_with_no_order_metadata_skips_order_creation()
    {
        // Zero delta and no supplier / order number / date / cost /
        // currency = pure inventory audit. No Order row should be
        // created for these, since there was no transaction.
        $accessory = Accessory::factory()->create(['qty' => 5]);
        $ordersBefore = Order::count();

        $this->actingAsForApi(User::factory()->editAccessories()->create())
            ->postJson(route('api.accessories.adjust-quantity', $accessory), [
                'amount' => 0,
                'note' => 'shelf count matches',
            ])
            ->assertOk();

        $this->assertSame($ordersBefore, Order::count());

        $log = Actionlog::where('item_type', Accessory::class)
            ->where('item_id', $accessory->id)
            ->where('action_type', ActionType::QuantityAdjust->value)
            ->latest('id')
            ->firstOrFail();

        $this->assertNull($log->order_item_id);
    }

    public function test_multiple_adjusts_with_same_order_number_dedupe_to_one_order()
    {
        // Repeated qty adjusts referencing the same order_number should
        // reuse the existing Order row (dedupe on order_number +
        // supplier + company + purchase_date), while each adjust still
        // produces its own OrderItem line (one line per event).
        $accessory = Accessory::factory()->create(['qty' => 0]);
        $supplier = Supplier::factory()->create();
        $actor = User::factory()->editAccessories()->create();

        foreach ([3, 4] as $delta) {
            $this->actingAsForApi($actor)
                ->postJson(route('api.accessories.adjust-quantity', $accessory), [
                    'amount' => $delta,
                    'note' => 'same receipt, split line',
                    'order_number' => 'ORD-DEDUPE',
                    'supplier_id' => $supplier->id,
                    'purchase_date' => '2026-04-01',
                ])
                ->assertOk();
        }

        $orders = Order::where('order_number', 'ORD-DEDUPE')->get();
        $this->assertCount(1, $orders, 'Same order_number + supplier + date should reuse the existing Order row.');

        $items = $orders->first()->orderItems;
        $this->assertCount(2, $items, 'Each adjust event should have its own OrderItem line.');
        $this->assertEqualsCanonicalizing([3, 4], $items->pluck('qty')->map(fn ($q) => (int) $q)->all());
    }

    public function test_same_order_number_on_different_purchase_dates_creates_distinct_orders()
    {
        // Snipe-IT has no partial-receipt concept. Every Order is a
        // completed receipt-in-hand, so the same order_number appearing
        // with two different purchase_dates represents two distinct
        // events and each gets its own Order row.
        $accessory = Accessory::factory()->create(['qty' => 0]);
        $supplier = Supplier::factory()->create();
        $actor = User::factory()->editAccessories()->create();

        foreach (['2026-04-01', '2026-04-15'] as $date) {
            $this->actingAsForApi($actor)
                ->postJson(route('api.accessories.adjust-quantity', $accessory), [
                    'amount' => 5,
                    'note' => 'later receipt on same order number',
                    'order_number' => 'ORD-SPLIT-DATE',
                    'supplier_id' => $supplier->id,
                    'purchase_date' => $date,
                ])
                ->assertOk();
        }

        $this->assertSame(
            2,
            Order::where('order_number', 'ORD-SPLIT-DATE')->count(),
            'Different purchase_dates under the same order_number should be distinct Orders.',
        );
    }

    public function test_blank_order_number_creates_a_distinct_order_per_event()
    {
        // A blank order_number is a distinct transaction each time, not
        // a bucket to pool anonymous receipts into. Each adjust with
        // no order_number gets its own Order row.
        $accessory = Accessory::factory()->create(['qty' => 0]);
        $supplier = Supplier::factory()->create();
        $actor = User::factory()->editAccessories()->create();
        $ordersBefore = Order::count();

        foreach ([2, 3] as $delta) {
            $this->actingAsForApi($actor)
                ->postJson(route('api.accessories.adjust-quantity', $accessory), [
                    'amount' => $delta,
                    'note' => 'anonymous receipt',
                    'supplier_id' => $supplier->id,
                ])
                ->assertOk();
        }

        $this->assertSame($ordersBefore + 2, Order::count());
    }
}