adspecs 0.1.12

package/references/front-demo/src/store/modules/forecast-order/__tests__/forecastOrderDetailStore.spec.ts

@@ -0,0 +1,379 @@
+/**
+ * T029: forecastOrderDetailStore 单元测试
+ * TDD RED phase — 测试先写，预期失败（功能尚需扩展）
+ *
+ * 覆盖场景:
+ * 1. 详情加载: fetchDetail(id) → detail 有数据
+ * 2. 抽屉显隐: openDrawer(id) → drawerVisible=true; closeDrawer() → drawerVisible=false
+ * 3. 评审模式切换: switchToReview() → drawerMode='review'
+ * 4. visibleButtons 计算: 3 角色×9 状态矩阵
+ * 5. 撤回操作: withdraw() → API 调用成功 → Toast 提示
+ * 6. 作废操作: doDiscard() → API 调用成功 → 抽屉关闭
+ * 7. 评审接收: doReviewAccept({...}) → API 调用成功 → drawerMode 切回 detail
+ * 8. 评审驳回: doReviewReject({reason}) → 驳回原因不为空才执行
+ */
+import { describe, it, expect, beforeEach, vi } from 'vitest'
+import { createPinia, setActivePinia } from 'pinia'
+
+// Mock vue-i18n (must be before any store import)
+vi.mock('vue-i18n', () => ({
+  useI18n: () => ({
+    t: (key: string) => key,
+  }),
+}))
+
+// Mock API 模块
+vi.mock('@/api/forecast/forecast-order', () => ({
+  getById: vi.fn(),
+  withdrawForecastOrder: vi.fn(),
+  discardForecastOrder: vi.fn(),
+  reviewAccept: vi.fn(),
+  reviewReject: vi.fn(),
+  resubmit: vi.fn(),
+  findChangeOrdersByForecastId: vi.fn(),
+  saveChangeDraft: vi.fn(),
+  submitChange: vi.fn(),
+  approveChange: vi.fn(),
+  rejectChange: vi.fn(),
+  withdrawChangeOrder: vi.fn(),
+}))
+
+// Mock utils
+vi.mock('@/utils', () => ({
+  reqIsSucceed: vi.fn((res: unknown) => (res as { code: number }).code === 800),
+}))
+
+vi.mock('@/utils/errorHandler', () => ({
+  handleApiError: vi.fn(),
+}))
+
+// Mock element-plus
+vi.mock('element-plus', async () => {
+  const actual = await vi.importActual('element-plus')
+  return {
+    ...(actual as object),
+    ElMessage: { success: vi.fn(), error: vi.fn() },
+    ElMessageBox: { confirm: vi.fn(), alert: vi.fn() },
+  }
+})
+
+import {
+  getById,
+  withdrawForecastOrder,
+  discardForecastOrder,
+  reviewAccept,
+  reviewReject,
+} from '@/api/forecast/forecast-order'
+import { useForecastOrderDetailStore } from '@/store/modules/forecast-order/forecastOrderDetailStore'
+
+const mockDetail = {
+  forecastOrderId: 1,
+  forecastOrderNo: 'FO-20260629-0001',
+  forecastOrderType: 'NORMAL',
+  foStatus: 'DRAFT' as const,
+  submitter: 1001,
+  tradeType: 'DOMESTIC' as const,
+  submitTime: '2026-06-29 10:00:00',
+  forecastReplyTime: null,
+  reasonDesc: '测试预测单',
+  customerCode: 'CUS001',
+  customerName: '测试客户',
+  groupCustomerCode: null,
+  groupCustomerName: null,
+  productCode: 'PROD001',
+  productName: '测试产品',
+  productCategory: '成品',
+  materialLevel: 'FINISHED' as const,
+  standardization: 'STANDARD' as const,
+  minOrderQty: 100,
+  forecastQty: 1000,
+  unit: '公斤',
+  shippingPoint: 'SHANGHAI' as const,
+  expectedDeliveryDate: '2026-07-15',
+  customsManualNo: null,
+  rawMaterialOrigin: null,
+  lowCarbonRatio: null,
+  processingFlag: 0,
+  designatedFactory: null,
+  planSuggestedQty: null,
+  planReplyDate: null,
+  planReplyComment: null,
+  rejectReason: null,
+  forceConvertDeadline: null,
+  actualScheduleQty: null,
+  convertedQty: 0,
+  releasedQty: 0,
+  relatedSoNos: null,
+  creationDate: '2026-06-29 10:00:00',
+  createdBy: 1001,
+  lastUpdateDate: '2026-06-29 10:00:00',
+  lastUpdatedBy: 1001,
+  deleteFlag: 0,
+  versionNum: 1,
+}
+
+describe('forecastOrderDetailStore - T029', () => {
+  let store: ReturnType<typeof useForecastOrderDetailStore>
+
+  beforeEach(() => {
+    setActivePinia(createPinia())
+    vi.clearAllMocks()
+    store = useForecastOrderDetailStore()
+  })
+
+  // ==================== 1. 详情加载 ====================
+  describe('fetchDetail - 详情加载', () => {
+    it('fetchDetail(id) → detail 有数据', async () => {
+      ;(getById as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800,
+        data: { ...mockDetail },
+      })
+
+      await store.fetchDetail(1)
+
+      expect(store.detail).not.toBeNull()
+      expect(store.detail?.forecastOrderId).toBe(1)
+      expect(store.detail?.forecastOrderNo).toBe('FO-20260629-0001')
+      expect(store.detailFcId).toBe(1)
+      expect(getById).toHaveBeenCalledWith(1)
+    })
+
+    it('fetchDetail 失败时 detail 保持 null', async () => {
+      ;(getById as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 500,
+        msg: '服务器错误',
+        data: null,
+      })
+
+      await store.fetchDetail(999)
+
+      expect(store.detail).toBeNull()
+    })
+  })
+
+  // ==================== 2. 抽屉显隐 ====================
+  describe('抽屉显隐', () => {
+    it('openDrawer(id) → drawerVisible=true 并加载详情', async () => {
+      ;(getById as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800,
+        data: { ...mockDetail },
+      })
+
+      await store.openDrawer(1)
+
+      expect(store.drawerVisible).toBe(true)
+      expect(store.drawerMode).toBe('detail')
+    })
+
+    it('closeDrawer() → drawerVisible=false, detail 置 null', () => {
+      store.detail = { ...mockDetail }
+      store.drawerVisible = true
+
+      store.closeDrawer()
+
+      expect(store.drawerVisible).toBe(false)
+      expect(store.detail).toBeNull()
+    })
+  })
+
+  // ==================== 3. 评审模式切换 ====================
+  describe('评审模式切换', () => {
+    it('switchToReview() → drawerMode=review', () => {
+      store.switchToReview()
+      expect(store.drawerMode).toBe('review')
+    })
+  })
+
+  // ==================== 4. visibleButtons 计算 ====================
+  describe('visibleButtons - 3角色×9状态矩阵', () => {
+    it('DRAFT + sales → edit, discard（有单号；详情视图不含 submit）', () => {
+      store.detail = { ...mockDetail, foStatus: 'DRAFT' as const }
+      store.currentRole = 'salesman'
+      const btns = store.visibleButtons
+      expect(btns).toContain('edit')
+      // 详情视图不显示「提交」—— 提交应走编辑→表单→提交流程
+      expect(btns).not.toContain('submit')
+      // mockDetail 有 forecastOrderNo → discard（非 delete）
+      expect(btns).toContain('discard')
+    })
+
+    it('SUBMITTED + sales → withdraw', () => {
+      store.detail = { ...mockDetail, foStatus: 'SUBMITTED' as const }
+      store.currentRole = 'salesman'
+      const btns = store.visibleButtons
+      expect(btns).toContain('withdraw')
+      expect(btns).not.toContain('edit')
+    })
+
+    it('REJECTED + sales → resubmit, discard', () => {
+      store.detail = { ...mockDetail, foStatus: 'REJECTED' as const }
+      store.currentRole = 'salesman'
+      const btns = store.visibleButtons
+      expect(btns).toContain('resubmit')
+      expect(btns).toContain('discard')
+      // withdraw 仅适用于 SUBMITTED，REJECTED 不应出现
+      expect(btns).not.toContain('withdraw')
+    })
+
+    it('SCHEDULED + sales → change, convert', () => {
+      store.detail = { ...mockDetail, foStatus: 'SCHEDULED' as const, actualScheduleQty: 500 }
+      store.currentRole = 'salesman'
+      const btns = store.visibleButtons
+      expect(btns).toContain('change')
+      expect(btns).toContain('convert')
+    })
+
+    it('PARTIAL_CONVERTED + sales → change, convert', () => {
+      store.detail = { ...mockDetail, foStatus: 'PARTIAL_CONVERTED' as const }
+      store.currentRole = 'salesman'
+      const btns = store.visibleButtons
+      expect(btns).toContain('change')
+      expect(btns).toContain('convert')
+    })
+
+    it('SUBMITTED + planner → reviewAccept, reviewReject', () => {
+      store.detail = { ...mockDetail, foStatus: 'SUBMITTED' as const }
+      store.currentRole = 'planner'
+      const btns = store.visibleButtons
+      expect(btns).toContain('reviewAccept')
+      expect(btns).toContain('reviewReject')
+    })
+
+    it('DRAFT + planner → 空数组', () => {
+      store.detail = { ...mockDetail, foStatus: 'DRAFT' as const }
+      store.currentRole = 'planner'
+      const btns = store.visibleButtons
+      expect(btns).toEqual([])
+    })
+
+    it('manager → 无未完成变更单时返回空数组', () => {
+      store.detail = { ...mockDetail, foStatus: 'SCHEDULED' as const }
+      store.currentRole = 'manager'
+      // 没有 pending change，manager 无需审批的操作
+      const btns = store.visibleButtons
+      expect(btns).toEqual([])
+    })
+
+    it('manager + 存在未完成变更单 → approve-change', () => {
+      store.detail = { ...mockDetail, foStatus: 'SCHEDULED' as const }
+      store.currentRole = 'manager'
+      // 模拟存在未完成变更单
+      store.changeList = [{ coStatus: 'SUBMITTED' } as any]
+      const btns = store.visibleButtons
+      expect(btns).toContain('approve-change')
+    })
+
+    it('DRAFT + forecastOrderNo 存在 → 额外显示 discard', () => {
+      store.detail = { ...mockDetail, foStatus: 'DRAFT' as const, forecastOrderNo: 'FO-001' }
+      store.currentRole = 'salesman'
+      const btns = store.visibleButtons
+      expect(btns).toContain('discard')
+    })
+
+    it('detail 为 null 时返回空数组', () => {
+      store.detail = null
+      store.currentRole = 'salesman'
+      expect(store.visibleButtons).toEqual([])
+    })
+  })
+
+  // ==================== 5. 撤回操作 ====================
+  describe('withdraw - 撤回操作', () => {
+    it('撤回成功 → Toast 提示 + 更新 detail', async () => {
+      store.detail = { ...mockDetail, foStatus: 'SUBMITTED' as const }
+      ;(withdrawForecastOrder as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800,
+        data: { ...mockDetail, foStatus: 'DRAFT' },
+      })
+
+      await store.withdraw()
+
+      expect(withdrawForecastOrder).toHaveBeenCalledWith(1)
+      expect(store.detail?.foStatus).toBe('DRAFT')
+    })
+
+    it('detail 为 null 时不调用 API', async () => {
+      store.detail = null
+      await store.withdraw()
+      expect(withdrawForecastOrder).not.toHaveBeenCalled()
+    })
+  })
+
+  // ==================== 6. 作废操作 ====================
+  describe('doDiscard - 作废操作', () => {
+    it('作废成功 → 抽屉关闭', async () => {
+      store.detail = { ...mockDetail }
+      store.drawerVisible = true
+      ;(discardForecastOrder as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800,
+        data: null,
+      })
+
+      await store.doDiscard()
+
+      expect(discardForecastOrder).toHaveBeenCalledWith(1)
+      expect(store.drawerVisible).toBe(false)
+    })
+
+    it('detail 为 null 时不调用 API', async () => {
+      store.detail = null
+      await store.doDiscard()
+      expect(discardForecastOrder).not.toHaveBeenCalled()
+    })
+  })
+
+  // ==================== 7. 评审接收 ====================
+  describe('doReviewAccept - 评审接收', () => {
+    it('评审接收成功 → drawerMode 切回 detail', async () => {
+      store.detail = { ...mockDetail }
+      store.drawerMode = 'review'
+      ;(reviewAccept as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800,
+        data: { ...mockDetail, foStatus: 'PLAN_RECEIVED' },
+      })
+
+      await store.doReviewAccept({
+        forecastOrderId: 1,
+        planSuggestedQty: 800,
+        planReplyDate: '2026-07-20',
+        planReplyComment: '同意按量排产',
+      })
+
+      expect(reviewAccept).toHaveBeenCalled()
+      expect(store.drawerMode).toBe('detail')
+      expect(store.detail?.foStatus).toBe('PLAN_RECEIVED')
+    })
+  })
+
+  // ==================== 8. 评审驳回 ====================
+  describe('doReviewReject - 评审驳回', () => {
+    it('驳回原因不为空才执行 API 调用', async () => {
+      store.detail = { ...mockDetail }
+      store.drawerMode = 'review'
+      ;(reviewReject as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800,
+        data: { ...mockDetail, foStatus: 'REJECTED' as const },
+      })
+
+      await store.doReviewReject({
+        forecastOrderId: 1,
+        rejectReason: '需求量不合理',
+      })
+
+      expect(reviewReject).toHaveBeenCalled()
+      expect(store.drawerMode).toBe('detail')
+    })
+
+    it('驳回原因为空时不调用 API', async () => {
+      store.detail = { ...mockDetail }
+      ;(reviewReject as ReturnType<typeof vi.fn>).mockClear()
+
+      await store.doReviewReject({
+        forecastOrderId: 1,
+        rejectReason: '',
+      })
+
+      expect(reviewReject).not.toHaveBeenCalled()
+    })
+  })
+})

package/references/front-demo/src/store/modules/forecast-order/__tests__/forecastOrderListStore.spec.ts

@@ -0,0 +1,297 @@
+/**
+ * M06-01 销售预测 - ForecastOrderListStore 单元测试 (T016)
+ *
+ * TDD RED phase — tests written before implementation is verified.
+ * Covers:
+ * 1. List loading (fetchList)
+ * 2. Pagination switch (onPageChange)
+ * 3. Page size switch (onPageSizeChange)
+ * 4. Filter change + search
+ * 5. Loading state
+ * 6. Role setting
+ * 7. Empty state
+ * 8. Reset
+ * 9. Error state (no crash)
+ */
+
+import { setActivePinia, createPinia } from 'pinia'
+import { describe, it, expect, beforeEach, vi } from 'vitest'
+
+// Mock API module — must match the import path used in the store
+vi.mock('@/api/forecast/forecast-order', () => ({
+  findPagination: vi.fn(),
+}))
+
+// Mock error handler to avoid ElMessage side effects
+vi.mock('@/utils/errorHandler', () => ({
+  handleApiError: vi.fn(),
+}))
+
+import { findPagination } from '@/api/forecast/forecast-order'
+import { useForecastOrderListStore } from '@/store/modules/forecast-order/forecastOrderListStore'
+
+// Mock data — 7 records with diverse statuses
+const mockOrders = [
+  { forecastOrderId: 1, forecastOrderNo: 'FO-20260629-0001', forecastOrderType: 'NORMAL', foStatus: 'SUBMITTED', submitter: 1001, tradeType: 'DOMESTIC', submitTime: '2026-06-29 10:00:00', forecastReplyTime: null, reasonDesc: null, customerCode: 'CUS001', customerName: '上海XX汽车零部件有限公司', groupCustomerCode: null, groupCustomerName: null, productCode: 'PROD001', productName: '5052铝板', productCategory: '铝加工材', materialLevel: 'FINISHED', standardization: 'STANDARD', minOrderQty: 5000, forecastQty: 10000, unit: '公斤', shippingPoint: 'SHANGHAI', expectedDeliveryDate: '2026-07-15', customsManualNo: null, rawMaterialOrigin: null, lowCarbonRatio: null, processingFlag: 0, designatedFactory: null, planSuggestedQty: null, planReplyDate: null, planReplyComment: null, rejectReason: null, forceConvertDeadline: null, actualScheduleQty: null, convertedQty: 0, releasedQty: 0, relatedSoNos: null, creationDate: '2026-06-29 10:00:00', createdBy: 1001, lastUpdateDate: '2026-06-29 10:00:00', lastUpdatedBy: 1001, deleteFlag: 0, versionNum: 1 },
+  { forecastOrderId: 2, forecastOrderNo: null, forecastOrderType: 'NORMAL', foStatus: 'DRAFT', submitter: 1001, tradeType: 'EXPORT', submitTime: '2026-06-28 09:00:00', forecastReplyTime: null, reasonDesc: null, customerCode: 'CUS002', customerName: '浙江YY铝业有限公司', groupCustomerCode: null, groupCustomerName: null, productCode: 'PROD002', productName: '6061铝棒', productCategory: '铝加工材', materialLevel: 'INGOT', standardization: 'STANDARD', minOrderQty: 3000, forecastQty: 8000, unit: '公斤', shippingPoint: 'CHONGQING', expectedDeliveryDate: '2026-08-01', customsManualNo: null, rawMaterialOrigin: null, lowCarbonRatio: 30, processingFlag: 1, designatedFactory: null, planSuggestedQty: null, planReplyDate: null, planReplyComment: null, rejectReason: null, forceConvertDeadline: null, actualScheduleQty: null, convertedQty: 0, releasedQty: 0, relatedSoNos: null, creationDate: '2026-06-28 09:00:00', createdBy: 1001, lastUpdateDate: '2026-06-28 09:00:00', lastUpdatedBy: 1001, deleteFlag: 0, versionNum: 1 },
+  { forecastOrderId: 3, forecastOrderNo: 'FO-20260627-0003', forecastOrderType: 'NORMAL', foStatus: 'REJECTED', submitter: 1002, tradeType: 'DOMESTIC', submitTime: '2026-06-27 14:00:00', forecastReplyTime: '2026-06-28 10:00:00', reasonDesc: '测试原因', customerCode: 'CUS003', customerName: '北京ZZ贸易有限公司', groupCustomerCode: 'GC001', groupCustomerName: 'XX集团', productCode: 'PROD003', productName: '铝合金窗框', productCategory: '铝加工制品', materialLevel: 'FINISHED', standardization: 'NON_STANDARD', minOrderQty: 1000, forecastQty: 5000, unit: '公斤', shippingPoint: 'SHANGHAI', expectedDeliveryDate: '2026-07-20', customsManualNo: 'B001', rawMaterialOrigin: '中国', lowCarbonRatio: null, processingFlag: 0, designatedFactory: '上海工厂', planSuggestedQty: 6000, planReplyDate: '2026-08-15', planReplyComment: '建议适当调整', rejectReason: '需求不合理', forceConvertDeadline: null, actualScheduleQty: null, convertedQty: 0, releasedQty: 0, relatedSoNos: null, creationDate: '2026-06-27 14:00:00', createdBy: 1002, lastUpdateDate: '2026-06-28 10:00:00', lastUpdatedBy: 1003, deleteFlag: 0, versionNum: 2 },
+  { forecastOrderId: 4, forecastOrderNo: 'FO-20260626-0004', forecastOrderType: 'NORMAL', foStatus: 'PLAN_RECEIVED', submitter: 1003, tradeType: 'DOMESTIC', submitTime: '2026-06-26 11:00:00', forecastReplyTime: '2026-06-27 16:00:00', reasonDesc: null, customerCode: 'CUS004', customerName: '广州AA金属制品有限公司', groupCustomerCode: null, groupCustomerName: null, productCode: 'PROD004', productName: '7075铝型材', productCategory: '铝加工材', materialLevel: 'COLD_ROLLED', standardization: 'NON_STANDARD', minOrderQty: 500, forecastQty: 3000, unit: '公斤', shippingPoint: 'SHANGHAI', expectedDeliveryDate: '2026-07-10', customsManualNo: null, rawMaterialOrigin: null, lowCarbonRatio: 50, processingFlag: 0, designatedFactory: null, planSuggestedQty: 3000, planReplyDate: '2026-07-25', planReplyComment: '同意', rejectReason: null, forceConvertDeadline: null, actualScheduleQty: 3000, convertedQty: 1000, releasedQty: 0, relatedSoNos: 'SO-001', creationDate: '2026-06-26 11:00:00', createdBy: 1003, lastUpdateDate: '2026-06-27 16:00:00', lastUpdatedBy: 1004, deleteFlag: 0, versionNum: 3 },
+  { forecastOrderId: 5, forecastOrderNo: 'FO-20260625-0005', forecastOrderType: 'NORMAL', foStatus: 'SCHEDULED', submitter: 1004, tradeType: 'EXPORT', submitTime: '2026-06-25 08:00:00', forecastReplyTime: '2026-06-26 09:00:00', reasonDesc: null, customerCode: 'CUS005', customerName: '深圳BB电子有限公司', groupCustomerCode: null, groupCustomerName: null, productCode: 'PROD005', productName: '废铝料A型', productCategory: '废铝', materialLevel: 'FINISHED', standardization: 'STANDARD', minOrderQty: 10000, forecastQty: 20000, unit: '公斤', shippingPoint: 'CHONGQING', expectedDeliveryDate: '2026-07-05', customsManualNo: null, rawMaterialOrigin: null, lowCarbonRatio: null, processingFlag: 0, designatedFactory: null, planSuggestedQty: 18000, planReplyDate: '2026-07-15', planReplyComment: '部分满足', rejectReason: null, forceConvertDeadline: '2026-08-01', actualScheduleQty: 18000, convertedQty: 5000, releasedQty: 0, relatedSoNos: 'SO-002,SO-003', creationDate: '2026-06-25 08:00:00', createdBy: 1004, lastUpdateDate: '2026-06-26 09:00:00', lastUpdatedBy: 1004, deleteFlag: 0, versionNum: 1 },
+  { forecastOrderId: 6, forecastOrderNo: 'FO-20260624-0006', forecastOrderType: 'NORMAL', foStatus: 'FULL_CONVERTED', submitter: 1005, tradeType: 'DOMESTIC', submitTime: '2026-06-24 15:00:00', forecastReplyTime: '2026-06-25 10:00:00', reasonDesc: null, customerCode: 'CUS006', customerName: '成都CC装备有限公司', groupCustomerCode: 'GC001', groupCustomerName: 'XX集团', productCode: 'PROD006', productName: '铝门框架-X1', productCategory: '铝加工制品', materialLevel: 'FINISHED', standardization: 'STANDARD', minOrderQty: 2000, forecastQty: 5000, unit: '公斤', shippingPoint: 'SHANGHAI', expectedDeliveryDate: '2026-06-30', customsManualNo: null, rawMaterialOrigin: null, lowCarbonRatio: null, processingFlag: 0, designatedFactory: null, planSuggestedQty: 5000, planReplyDate: '2026-07-10', planReplyComment: null, rejectReason: null, forceConvertDeadline: null, actualScheduleQty: 5000, convertedQty: 5000, releasedQty: 0, relatedSoNos: 'SO-004', creationDate: '2026-06-24 15:00:00', createdBy: 1005, lastUpdateDate: '2026-06-30 10:00:00', lastUpdatedBy: 1005, deleteFlag: 0, versionNum: 2 },
+  { forecastOrderId: 7, forecastOrderNo: 'FO-20260623-0007', forecastOrderType: 'NORMAL', foStatus: 'DISCARDED', submitter: 1001, tradeType: 'DOMESTIC', submitTime: '2026-06-23 10:00:00', forecastReplyTime: null, reasonDesc: null, customerCode: 'CUS007', customerName: '武汉DD工业有限公司', groupCustomerCode: null, groupCustomerName: null, productCode: 'PROD007', productName: '铝板边角料', productCategory: '废铝', materialLevel: 'INGOT', standardization: 'STANDARD', minOrderQty: 8000, forecastQty: 15000, unit: '公斤', shippingPoint: 'SHANGHAI', expectedDeliveryDate: '2026-07-01', customsManualNo: null, rawMaterialOrigin: null, lowCarbonRatio: null, processingFlag: 0, designatedFactory: null, planSuggestedQty: null, planReplyDate: null, planReplyComment: null, rejectReason: null, forceConvertDeadline: null, actualScheduleQty: null, convertedQty: 0, releasedQty: 0, relatedSoNos: null, creationDate: '2026-06-23 10:00:00', createdBy: 1001, lastUpdateDate: '2026-06-23 11:00:00', lastUpdatedBy: 1001, deleteFlag: 0, versionNum: 1 },
+]
+
+describe('ForecastOrderListStore (T016)', () => {
+  let store: ReturnType<typeof useForecastOrderListStore>
+
+  beforeEach(() => {
+    setActivePinia(createPinia())
+    vi.clearAllMocks()
+    store = useForecastOrderListStore()
+  })
+
+  // ==================== 1. List loading ====================
+  describe('fetchList - 列表加载', () => {
+    it('调用 fetchList 后 list 有数据、total 正确', async () => {
+      ;(findPagination as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800,
+        msg: '成功',
+        data: { total: 7, records: mockOrders, pageIndex: 1, pageRows: 20 },
+      })
+
+      await store.fetchList()
+
+      expect(store.list.length).toBe(7)
+      expect(store.total).toBe(7)
+      expect(findPagination).toHaveBeenCalledTimes(1)
+    })
+
+    it('API 参数包含 pageIndex/pageRows 和 searchForm', async () => {
+      ;(findPagination as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800,
+        msg: '成功',
+        data: { total: 0, records: [], pageIndex: 1, pageRows: 20 },
+      })
+
+      store.searchForm = { customerName: 'XX' }
+      await store.fetchList()
+
+      const callArgs = (findPagination as ReturnType<typeof vi.fn>).mock.calls[0][0]
+      expect(callArgs.pageIndex).toBe(1)
+      expect(callArgs.pageRows).toBe(20)
+      expect(callArgs.params.customerName).toBe('XX')
+    })
+  })
+
+  // ==================== 2. Pagination switch ====================
+  describe('onPageChange - 分页切换', () => {
+    it('onPageChange(2) 后 pageIndex 变为 2 并触发 fetchList', async () => {
+      ;(findPagination as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800,
+        msg: '成功',
+        data: { total: 7, records: mockOrders.slice(2, 4), pageIndex: 2, pageRows: 2 },
+      })
+
+      await store.onPageChange(2)
+
+      expect(store.pagination.pageIndex).toBe(2)
+      expect(findPagination).toHaveBeenCalledTimes(1)
+      const callArgs = (findPagination as ReturnType<typeof vi.fn>).mock.calls[0][0]
+      expect(callArgs.pageIndex).toBe(2)
+    })
+  })
+
+  // ==================== 3. Page size switch ====================
+  describe('onPageSizeChange - 分页大小切换', () => {
+    it('onPageSizeChange(50) 后 pageRows 变为 50, pageIndex 重置为 1', async () => {
+      store.pagination.pageIndex = 3 // simulate being on page 3
+      ;(findPagination as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800,
+        msg: '成功',
+        data: { total: 7, records: mockOrders, pageIndex: 1, pageRows: 50 },
+      })
+
+      await store.onPageSizeChange(50)
+
+      expect(store.pagination.pageRows).toBe(50)
+      expect(store.pagination.pageIndex).toBe(1)
+    })
+  })
+
+  // ==================== 4. Filter change + search ====================
+  describe('updateSearchForm + search - 筛选条件变更', () => {
+    it('updateSearchForm({foStatus: \'DRAFT\'}) 后 searchForm 更新', () => {
+      store.updateSearchForm({ foStatus: 'DRAFT' })
+
+      expect(store.searchForm.foStatus).toBe('DRAFT')
+    })
+
+    it('search() → pageIndex 重置为 1 → 触发 fetchList', async () => {
+      store.pagination.pageIndex = 5
+      store.updateSearchForm({ foStatus: 'SUBMITTED' })
+      ;(findPagination as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800,
+        msg: '成功',
+        data: { total: 2, records: mockOrders.slice(0, 2), pageIndex: 1, pageRows: 20 },
+      })
+
+      await store.search()
+
+      expect(store.pagination.pageIndex).toBe(1)
+      expect(findPagination).toHaveBeenCalledTimes(1)
+    })
+
+    it('updateSearchForm 合并多个筛选条件', () => {
+      store.updateSearchForm({ customerCode: 'CUS001' })
+      store.updateSearchForm({ productCategory: '铝加工材' })
+
+      expect(store.searchForm.customerCode).toBe('CUS001')
+      expect(store.searchForm.productCategory).toBe('铝加工材')
+    })
+  })
+
+  // ==================== 5. Loading state ====================
+  describe('loading 状态', () => {
+    it('fetchList 开始时 loading=true，结束时 loading=false', async () => {
+      let resolvePromise: (value: unknown) => void = () => {}
+      const promise = new Promise(resolve => { resolvePromise = resolve })
+
+      ;(findPagination as ReturnType<typeof vi.fn>).mockReturnValue(promise)
+
+      const fetchPromise = store.fetchList()
+      // During fetch, loading should be true
+      expect(store.loading).toBe(true)
+
+      resolvePromise({ code: 800, msg: '成功', data: { total: 0, records: [], pageIndex: 1, pageRows: 20 } })
+      await fetchPromise
+
+      // After fetch, loading should be false
+      expect(store.loading).toBe(false)
+    })
+
+    it('初始状态 loading 为 false', () => {
+      expect(store.loading).toBe(false)
+    })
+  })
+
+  // ==================== 6. Role setting ====================
+  describe('setRole - 角色设置', () => {
+    it('setRole(\'planner\') 后 currentRole 变为 \'planner\'', () => {
+      store.setRole('planner')
+      expect(store.currentRole).toBe('planner')
+    })
+
+    it('setRole(\'sales\') 后 currentRole 变为 \'sales\'', () => {
+      store.setRole('salesman')
+      expect(store.currentRole).toBe('salesman')
+    })
+
+    it('setRole(\'manager\') 后 currentRole 变为 \'manager\'', () => {
+      store.setRole('manager')
+      expect(store.currentRole).toBe('manager')
+    })
+  })
+
+  // ==================== 7. Empty state ====================
+  describe('isEmpty - 空状态', () => {
+    it('API 返回空列表时 isEmpty 为 true', async () => {
+      ;(findPagination as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800,
+        msg: '成功',
+        data: { total: 0, records: [], pageIndex: 1, pageRows: 20 },
+      })
+
+      await store.fetchList()
+
+      expect(store.list.length).toBe(0)
+      expect(store.isEmpty).toBe(true)
+      expect(store.hasData).toBe(false)
+    })
+
+    it('加载中时 isEmpty 为 false（loading 状态优先）', () => {
+      store.loading = true
+      store.list = []
+
+      // isEmpty 逻辑：!loading && list.length === 0
+      // 正在加载时即使 list 为空也不应判为空状态
+      expect(store.isEmpty).toBe(false)
+    })
+  })
+
+  // ==================== 8. Reset ====================
+  describe('reset - 重置', () => {
+    it('reset() → searchForm 清空, pageIndex 重置为 1 → 触发 fetchList', async () => {
+      store.searchForm = { customerName: 'XX', foStatus: 'DRAFT' }
+      store.pagination.pageIndex = 5
+      ;(findPagination as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800,
+        msg: '成功',
+        data: { total: 7, records: mockOrders, pageIndex: 1, pageRows: 20 },
+      })
+
+      await store.reset()
+
+      expect(store.searchForm).toEqual({})
+      expect(store.pagination.pageIndex).toBe(1)
+      expect(findPagination).toHaveBeenCalledTimes(1)
+    })
+  })
+
+  // ==================== 9. Error state ====================
+  describe('错误状态', () => {
+    it('API 返回错误码时列表为空，不 crash', async () => {
+      ;(findPagination as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 500,
+        msg: '服务器内部错误',
+        data: null,
+      })
+
+      // 不应抛出异常
+      await expect(store.fetchList()).resolves.toBeUndefined()
+
+      expect(store.list.length).toBe(0)
+      expect(store.total).toBe(0)
+      expect(store.loading).toBe(false)
+    })
+
+    it('API 调用抛异常时列表为空，不 crash', async () => {
+      ;(findPagination as ReturnType<typeof vi.fn>).mockRejectedValue(new Error('网络异常'))
+
+      await expect(store.fetchList()).resolves.toBeUndefined()
+
+      expect(store.list.length).toBe(0)
+      expect(store.total).toBe(0)
+      expect(store.loading).toBe(false)
+    })
+  })
+
+  // ==================== 10. deleteRowLocally ====================
+  describe('deleteRowLocally - 本地删除行', () => {
+    it('deleteRowLocally 按 ID 删除行', async () => {
+      ;(findPagination as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800,
+        msg: '成功',
+        data: { total: 3, records: mockOrders.slice(0, 3), pageIndex: 1, pageRows: 20 },
+      })
+
+      await store.fetchList()
+      expect(store.list.length).toBe(3)
+
+      store.deleteRowLocally(1)
+      expect(store.list.length).toBe(2)
+      expect(store.list.find(item => item.forecastOrderId === 1)).toBeUndefined()
+    })
+
+    it('deleteRowLocally 删除不存在的 ID 无影响', async () => {
+      ;(findPagination as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800,
+        msg: '成功',
+        data: { total: 3, records: mockOrders.slice(0, 3), pageIndex: 1, pageRows: 20 },
+      })
+
+      await store.fetchList()
+      store.deleteRowLocally(999)
+      expect(store.list.length).toBe(3)
+    })
+  })
+})