4.7.0

2026-08-13 06:15:43 +08:00 · 2026-06-26 19:20:24 +08:00
parent 2e248de433
commit 058673559c
375 changed files with 34935 additions and 1361 deletions
--- a/tests/GoodsOnsaleItemsPlatformStoreTest.php
+++ b/tests/GoodsOnsaleItemsPlatformStoreTest.php
@@ -0,0 +1,73 @@
+<?php
+
+/**
+ * store-ops-buy-now-cloud-stock：在售列表云仓字段（platform_store）
+ * 对应 GET /goods/items/onsale → Items@getOnsaleItemsList 使用的列表装配。
+ */
+
+use GoodsBundle\Services\ItemsService;
+
+class GoodsOnsaleItemsPlatformStoreTest extends TestCase
+{
+    /**
+     * TC-LIST-01 / S1：平台列表与经销商列表路径下，每条 SKU 含 platform_store 且为非负整数。
+     *
+     * #given 模拟平台直连行、经销商 logistics_store 行、经销商总部发货行
+     * #when appendPlatformStoreForOnsaleSkuList
+     * #then platform_store 存在且 >= 0，并与预期平台库存一致
+     */
+    public function testTcList01PlatformAndDistributorPathsExposeNonNegativePlatformStore(): void
+    {
+        $service = new ItemsService();
+        $list = [
+            // 平台 getSkuItemsList：items.store 即平台库存
+            ['item_id' => 101, 'store' => 15],
+            // 经销商：门店发货时 logistics_store 承载原平台 store（见 DistributorItemsService::replaceItemInfo）
+            ['item_id' => 102, 'store' => 2, 'logistics_store' => 9, 'distributor_store' => 2, 'is_total_store' => false],
+            // 经销商：总部发货，store 未被替换为门店库存
+            ['item_id' => 103, 'store' => 20, 'is_total_store' => true, 'distributor_store' => 0],
+        ];
+
+        $out = $service->appendPlatformStoreForOnsaleSkuList($list);
+
+        $this->assertArrayHasKey('platform_store', $out[0]);
+        $this->assertSame(15, $out[0]['platform_store']);
+        $this->assertSame(9, $out[1]['platform_store']);
+        $this->assertSame(20, $out[2]['platform_store']);
+        foreach ($out as $row) {
+            $this->assertGreaterThanOrEqual(0, $row['platform_store']);
+        }
+    }
+
+    /**
+     * TC-LIST-02 / S2：经销商路径无平台库存快照时 platform_store 为 0（不把门店 store 误作云仓）。
+     *
+     * #given 含 distributor_store、非总部发货、无 logistics_store
+     * #when appendPlatformStoreForOnsaleSkuList
+     * #then platform_store === 0
+     */
+    public function testTcList02DistributorWithoutPlatformSourceUsesZeroPlatformStore(): void
+    {
+        $service = new ItemsService();
+        $list = [
+            ['item_id' => 201, 'store' => 5, 'distributor_store' => 5, 'is_total_store' => false],
+        ];
+
+        $out = $service->appendPlatformStoreForOnsaleSkuList($list);
+
+        $this->assertSame(0, $out[0]['platform_store']);
+    }
+
+    /**
+     * 店铺未开启云仓可购买时：不注入 platform_store 字段。
+     */
+    public function testWhenInjectDisabledOmitsPlatformStoreKey(): void
+    {
+        $service = new ItemsService();
+        $list = [['item_id' => 301, 'store' => 10]];
+
+        $out = $service->appendPlatformStoreForOnsaleSkuList($list, false);
+
+        $this->assertArrayNotHasKey('platform_store', $out[0]);
+    }
+}