adspecs 0.1.12

package/references/front-demo/src/store/modules/forecast-order/forecastOrderFormStore.ts

@@ -0,0 +1,281 @@
+import { defineStore } from 'pinia'
+import { ref, reactive, computed } from 'vue'
+import { useI18n } from 'vue-i18n'
+import type { ForecastOrderFormData } from '@/types/forecast-order'
+import { saveDraft, submitForReview, updateDraft, getById } from '@/api/forecast/forecast-order'
+import { reqIsSucceed } from '@/utils'
+import { handleApiError } from '@/utils/errorHandler'
+import { ElMessage } from 'element-plus'
+
+export const useForecastOrderFormStore = defineStore('forecastOrderForm', () => {
+  const { t } = useI18n()
+  // State
+  const editId = ref<number | undefined>(undefined)
+  const formData = reactive<ForecastOrderFormData>({
+    customerCode: '',
+    productCode: '',
+    forecastQty: undefined,
+    expectedDeliveryDate: '',
+    shippingPoint: 'SHANGHAI',
+    unit: '公斤',
+    processingFlag: 0,
+  })
+  const formMode = ref<'create' | 'edit'>('create')
+  const errors = ref<Record<string, string>>({})
+  const submitting = ref(false)
+  const leadDays = ref(30) // 提报提前期天数
+  const modalVisible = ref(false)
+
+  // Getters
+  const isEdit = computed(() => formMode.value === 'edit')
+  const hasForecastOrderNo = computed(() => !!formData.forecastOrderId && formMode.value === 'edit')
+
+  // Actions
+  function initCreate() {
+    editId.value = undefined
+    formMode.value = 'create'
+    Object.assign(formData, {
+      forecastOrderId: undefined,
+      customerCode: '',
+      customerName: '',
+      groupCustomerCode: '',
+      groupCustomerName: '',
+      productCode: '',
+      productName: '',
+      productCategory: '',
+      materialLevel: '',
+      standardization: '',
+      minOrderQty: undefined,
+      tradeType: '',
+      forecastQty: undefined,
+      shippingPoint: 'SHANGHAI',
+      unit: '公斤',
+      expectedDeliveryDate: '',
+      customsManualNo: '',
+      rawMaterialOrigin: '',
+      lowCarbonRatio: undefined,
+      processingFlag: 0,
+      designatedFactory: '',
+      reasonDesc: '',
+      versionNum: undefined,
+    })
+    errors.value = {}
+    modalVisible.value = true
+  }
+
+  async function initEdit(id: number) {
+    editId.value = id
+    formMode.value = 'edit'
+    try {
+      const res = await getById(id)
+      if (reqIsSucceed(res)) {
+        const data = res.data
+        Object.assign(formData, {
+          forecastOrderId: data.forecastOrderId,
+          customerCode: data.customerCode,
+          customerName: data.customerName,
+          groupCustomerCode: data.groupCustomerCode,
+          groupCustomerName: data.groupCustomerName,
+          productCode: data.productCode,
+          productName: data.productName,
+          productCategory: data.productCategory,
+          materialLevel: data.materialLevel,
+          standardization: data.standardization,
+          minOrderQty: data.minOrderQty,
+          tradeType: data.tradeType,
+          forecastQty: data.forecastQty,
+          shippingPoint: data.shippingPoint,
+          unit: data.unit,
+          expectedDeliveryDate: data.expectedDeliveryDate,
+          customsManualNo: data.customsManualNo,
+          rawMaterialOrigin: data.rawMaterialOrigin,
+          lowCarbonRatio: data.lowCarbonRatio,
+          processingFlag: data.processingFlag,
+          designatedFactory: data.designatedFactory,
+          reasonDesc: data.reasonDesc,
+          versionNum: data.versionNum,
+        })
+      }
+    } catch (error: unknown) {
+      const err = error as { code?: string; message?: string }
+      handleApiError(err?.code || 'unknown', err?.message)
+    }
+    errors.value = {}
+    modalVisible.value = true
+  }
+
+  function updateField<K extends keyof ForecastOrderFormData>(field: K, value: ForecastOrderFormData[K]) {
+    formData[field] = value
+    // 清除对应字段的错误
+    if (errors.value[field]) {
+      delete errors.value[field]
+    }
+  }
+
+  // 选择客户后回填客户信息
+  function onCustomerSelected(customer: { customerCode: string; customerName: string; groupCustomerCode?: string; groupCustomerName?: string; tradeType?: string }) {
+    formData.customerCode = customer.customerCode
+    formData.customerName = customer.customerName
+    formData.groupCustomerCode = customer.groupCustomerCode || ''
+    formData.groupCustomerName = customer.groupCustomerName || ''
+    if (customer.tradeType) {
+      formData.tradeType = customer.tradeType
+    }
+  }
+
+  // 选择产品后回填产品信息
+  function onProductSelected(product: { productCode: string; productName: string; productCategory: string; materialLevel?: string; standardization?: string; minOrderQty?: number }) {
+    formData.productCode = product.productCode
+    formData.productName = product.productName
+    formData.productCategory = product.productCategory
+    formData.materialLevel = product.materialLevel || ''
+    formData.standardization = product.standardization || ''
+    formData.minOrderQty = product.minOrderQty
+  }
+
+  function validateForm(): boolean {
+    errors.value = {}
+    if (!formData.customerCode) errors.value.customerCode = t('forecast-order.validation.customerRequired')
+    if (!formData.productCode) errors.value.productCode = t('forecast-order.validation.productRequired')
+    if (!formData.forecastQty || formData.forecastQty <= 0) errors.value.forecastQty = t('forecast-order.validation.forecastQtyRequired')
+    if (!formData.expectedDeliveryDate) errors.value.expectedDeliveryDate = t('forecast-order.validation.deliveryDateRequired')
+    return Object.keys(errors.value).length === 0
+  }
+
+  // 校验提前期（入库时间 >= 当前日期 + leadDays）
+  function validateLeadTime(): boolean {
+    if (!formData.expectedDeliveryDate) return false
+    const deliveryDate = new Date(formData.expectedDeliveryDate)
+    const minDate = new Date()
+    minDate.setDate(minDate.getDate() + leadDays.value)
+    minDate.setHours(0, 0, 0, 0)
+    deliveryDate.setHours(0, 0, 0, 0)
+    if (deliveryDate < minDate) {
+      errors.value.expectedDeliveryDate = t('forecast-order.form.advanceDaysError', { 0: leadDays.value })
+      return false
+    }
+    return true
+  }
+
+  // 校验 MOQ（需求量 >= 最小起订量）
+  function checkMoq(): { valid: boolean; message: string } {
+    if (formData.minOrderQty && formData.forecastQty && formData.forecastQty < formData.minOrderQty) {
+      return {
+        valid: false,
+        message: t('forecast-order.form.moqConfirm', { 0: formData.minOrderQty }),
+      }
+    }
+    return { valid: true, message: '' }
+  }
+
+  // 完整校验（含提前期）
+  function validateSubmit(): boolean {
+    if (!validateForm()) return false
+    if (!validateLeadTime()) return false
+    return true
+  }
+
+  // 设置提前期天数（从配置读取）
+  function setLeadDays(days: number) {
+    leadDays.value = days
+  }
+
+  async function saveDraftAction() {
+    if (submitting.value) return
+    submitting.value = true
+    try {
+      const res = await saveDraft({ params: { ...formData } })
+      if (reqIsSucceed(res)) {
+        ElMessage.success(t('forecast-order.toast.saveDraftSuccess'))
+        modalVisible.value = false
+        return res.data
+      } else {
+        handleApiError(res.code, res.msg)
+      }
+    } catch (error: unknown) {
+      const err = error as { code?: string; message?: string }
+      handleApiError(err?.code || 'unknown', err?.message)
+    } finally {
+      submitting.value = false
+    }
+  }
+
+  async function submitAction() {
+    if (!validateForm()) return
+    if (submitting.value) return
+    submitting.value = true
+    try {
+      const res = await submitForReview({ params: { ...formData } })
+      if (reqIsSucceed(res)) {
+        ElMessage.success(t('forecast-order.toast.submitSuccess'))
+        modalVisible.value = false
+        return res.data
+      } else {
+        handleApiError(res.code, res.msg)
+      }
+    } catch (error: unknown) {
+      const err = error as { code?: string; message?: string }
+      handleApiError(err?.code || 'unknown', err?.message)
+    } finally {
+      submitting.value = false
+    }
+  }
+
+  async function updateDraftAction() {
+    if (!validateForm()) return
+    if (submitting.value) return
+    submitting.value = true
+    try {
+      const res = await updateDraft({ params: { ...formData } })
+      if (reqIsSucceed(res)) {
+        ElMessage.success(t('forecast-order.toast.updateSuccess'))
+        modalVisible.value = false
+        return res.data
+      } else {
+        handleApiError(res.code, res.msg)
+      }
+    } catch (error: unknown) {
+      const err = error as { code?: string; message?: string }
+      handleApiError(err?.code || 'unknown', err?.message)
+    } finally {
+      submitting.value = false
+    }
+  }
+
+  function reset() {
+    editId.value = undefined
+    formMode.value = 'create'
+    errors.value = {}
+    submitting.value = false
+    modalVisible.value = false
+  }
+
+  return {
+    // State
+    editId,
+    formData,
+    formMode,
+    errors,
+    submitting,
+    leadDays,
+    modalVisible,
+    // Getters
+    isEdit,
+    hasForecastOrderNo,
+    // Actions
+    initCreate,
+    initEdit,
+    updateField,
+    onCustomerSelected,
+    onProductSelected,
+    validateForm,
+    validateLeadTime,
+    checkMoq,
+    validateSubmit,
+    setLeadDays,
+    saveDraftAction,
+    submitAction,
+    updateDraftAction,
+    reset,
+  }
+})

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

@@ -0,0 +1,101 @@
+import { defineStore } from 'pinia'
+import { ref, computed } from 'vue'
+import type { ForecastOrder, ForecastOrderSearchForm } from '@/types/forecast-order'
+import { findPagination } from '@/api/forecast/forecast-order'
+import { reqIsSucceed } from '@/utils'
+import { handleApiError } from '@/utils/errorHandler'
+
+export const useForecastOrderListStore = defineStore('forecastOrderList', () => {
+  // State
+  const list = ref<ForecastOrder[]>([])
+  const total = ref(0)
+  const loading = ref(false)
+  const searchForm = ref<ForecastOrderSearchForm>({})
+  const pagination = ref({ pageIndex: 1, pageRows: 20 })
+  const currentRole = ref<string>('salesman') // 'salesman' | 'planner' | 'manager'
+  const selectedRows = ref<ForecastOrder[]>([])
+
+  // Getters
+  const hasData = computed(() => list.value.length > 0)
+  const isEmpty = computed(() => !loading.value && list.value.length === 0)
+
+  // Actions
+  async function fetchList() {
+    loading.value = true
+    try {
+      const res = await findPagination({
+        pageIndex: pagination.value.pageIndex,
+        pageRows: pagination.value.pageRows,
+        params: searchForm.value,
+      })
+      if (reqIsSucceed(res)) {
+        list.value = res.data.records || []
+        total.value = res.data.total || 0
+      } else {
+        handleApiError(res.code, res.msg)
+      }
+    } catch (error: unknown) {
+      const err = error as { code?: string; message?: string }
+      handleApiError(err?.code || 'unknown', err?.message)
+    } finally {
+      loading.value = false
+    }
+  }
+
+  function updateSearchForm(form: Partial<ForecastOrderSearchForm>) {
+    searchForm.value = { ...searchForm.value, ...form }
+  }
+
+  async function search() {
+    pagination.value.pageIndex = 1
+    await fetchList()
+  }
+
+  async function reset() {
+    searchForm.value = {}
+    pagination.value.pageIndex = 1
+    await fetchList()
+  }
+
+  function onPageChange(page: number) {
+    pagination.value.pageIndex = page
+    fetchList()
+  }
+
+  function onPageSizeChange(size: number) {
+    pagination.value.pageRows = size
+    pagination.value.pageIndex = 1
+    fetchList()
+  }
+
+  function setRole(role: string) {
+    currentRole.value = role
+  }
+
+  function deleteRowLocally(id: number) {
+    list.value = list.value.filter(item => item.forecastOrderId !== id)
+  }
+
+  return {
+    // State
+    list,
+    total,
+    loading,
+    searchForm,
+    pagination,
+    currentRole,
+    selectedRows,
+    // Getters
+    hasData,
+    isEmpty,
+    // Actions
+    fetchList,
+    updateSearchForm,
+    search,
+    reset,
+    onPageChange,
+    onPageSizeChange,
+    setRole,
+    deleteRowLocally,
+  }
+})

package/references/front-demo/src/store/modules/forecast-order/index.ts

@@ -0,0 +1,5 @@
+export { useForecastOrderListStore } from './forecastOrderListStore'
+export { useForecastOrderFormStore } from './forecastOrderFormStore'
+export { useForecastOrderDetailStore } from './forecastOrderDetailStore'
+export { useChangeOrderFormStore } from './changeOrderFormStore'
+export { useConfigStore } from './configStore'

package/references/front-demo/src/store/modules/mdmCustomer/__tests__/customerStore.spec.ts

@@ -0,0 +1,206 @@
+/**
+ * M03-01 客户主数据 - CustomerStore 单元测试骨架
+ *
+ * 覆盖场景:
+ * - US-01: 列表分页查询 (正常/筛选/角色默认/空结果)
+ * - US-03: 新增客户
+ * - US-04: 客户详情查询
+ * - US-05: 编辑客户 (含乐观锁 versionNum)
+ * - US-06: 地址管理 (列表/新增/删除)
+ */
+
+import { setActivePinia, createPinia } from 'pinia'
+import { describe, it, expect, beforeEach, vi } from 'vitest'
+
+// Mock API 模块
+vi.mock('@/api/mdmCustomer/index', () => ({
+  findCrmCustomerPage: vi.fn(),
+  saveCrmCustomer: vi.fn(),
+  updateCrmCustomer: vi.fn(),
+  getCrmCustomerById: vi.fn(),
+  findAddressListByCustomerId: vi.fn(),
+  saveCrmCustomerAddress: vi.fn(),
+  deleteCrmCustomerAddress: vi.fn(),
+}))
+
+import {
+  findCrmCustomerPage,
+  saveCrmCustomer,
+  updateCrmCustomer,
+  getCrmCustomerById,
+  findAddressListByCustomerId,
+} from '@/api/mdmCustomer/index'
+import { useCustomerStore } from '@/store/modules/mdmCustomer/customerStore'
+
+// 5 条以上 Mock 客户数据
+const mockCustomers = [
+  { customerId: 1, customerCode: 'CUS-20260626-0001', customerName: '上海XX汽车零部件有限公司', shortName: 'XX汽配', tradeType: 'DOMESTIC', creditCode: '91310115XXXXXXXXXX', parentId: null, parentCustomerName: null, responsibleUserId: 1001, customerStatus: '正常', creationDate: '2026-06-20 14:00:00', versionNum: 1 },
+  { customerId: 2, customerCode: 'CUS-20260626-0002', customerName: '浙江YY铝业有限公司', shortName: 'YY铝业', tradeType: 'EXPORT', creditCode: '91330100XXXXXXXXXX', parentId: null, parentCustomerName: null, responsibleUserId: 1002, customerStatus: '正常', creationDate: '2026-06-19 10:30:00', versionNum: 1 },
+  { customerId: 3, customerCode: 'CUS-20260626-0003', customerName: '北京ZZ贸易有限公司', shortName: null, tradeType: 'DOMESTIC', creditCode: null, parentId: 100, parentCustomerCode: 'CUS-20260601-0001', parentCustomerName: 'XX集团', responsibleUserId: 1003, customerStatus: '正常', creationDate: '2026-06-18 16:45:00', versionNum: 2 },
+  { customerId: 4, customerCode: 'CUS-20260626-0004', customerName: '广州AA金属制品有限公司', shortName: 'AA金属', tradeType: 'EXPORT', creditCode: '91440100XXXXXXXXXX', parentId: null, parentCustomerName: null, responsibleUserId: 1004, customerStatus: '停用', creationDate: '2026-05-15 11:20:00', versionNum: 3 },
+  { customerId: 5, customerCode: 'CUS-20260626-0005', customerName: '深圳BB电子有限公司', shortName: 'BB电子', tradeType: 'DOMESTIC', creditCode: '91440300XXXXXXXXXX', parentId: null, parentCustomerName: null, responsibleUserId: 1005, customerStatus: '正常', creationDate: '2026-06-21 09:30:00', versionNum: 1 },
+  { customerId: 6, customerCode: 'CUS-20260626-0006', customerName: '成都CC装备有限公司', shortName: null, tradeType: 'DOMESTIC', creditCode: null, parentId: 100, parentCustomerCode: 'CUS-20260601-0001', parentCustomerName: 'XX集团', responsibleUserId: 1006, customerStatus: '停用', creationDate: '2026-06-22 08:00:00', versionNum: 1 },
+]
+
+describe('CustomerStore', () => {
+  let store: ReturnType<typeof useCustomerStore>
+
+  beforeEach(() => {
+    setActivePinia(createPinia())
+    vi.clearAllMocks()
+    store = useCustomerStore()
+  })
+
+  // ==================== US-01: 列表分页查询 ====================
+
+  describe('fetchList - 列表分页查询', () => {
+    it('无条件分页查询返回客户数据', async () => {
+      ;(findCrmCustomerPage as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800,
+        data: { rows: mockCustomers.slice(0, 3), total: 6 },
+      })
+
+      await store.fetchList()
+
+      expect(store.tableData.length).toBe(3)
+      expect(store.total).toBe(6)
+      expect(findCrmCustomerPage).toHaveBeenCalledTimes(1)
+    })
+
+    it('按客户名称模糊搜索', async () => {
+      ;(findCrmCustomerPage as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800,
+        data: { rows: [mockCustomers[0]], total: 1 },
+      })
+
+      await store.fetchList({ customerName: 'XX' })
+
+      expect(store.tableData.length).toBe(1)
+      expect(store.tableData[0].customerName).toContain('XX')
+    })
+
+    it('空结果返回空数组', async () => {
+      ;(findCrmCustomerPage as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800,
+        data: { rows: [], total: 0 },
+      })
+
+      await store.fetchList({ customerName: '不存在' })
+
+      expect(store.tableData).toEqual([])
+      expect(store.total).toBe(0)
+    })
+
+    it('销售员角色默认仅查询正常状态', async () => {
+      store.currentRole = 'sales'
+      ;(findCrmCustomerPage as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800,
+        data: { rows: [], total: 0 },
+      })
+
+      await store.fetchList()
+
+      const callArgs = (findCrmCustomerPage as ReturnType<typeof vi.fn>).mock.calls[0][0]
+      expect(callArgs.params.customerStatus).toBe('正常')
+    })
+
+    it('管理员角色默认查询全部状态', async () => {
+      store.currentRole = 'admin'
+      ;(findCrmCustomerPage as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800,
+        data: { rows: [], total: 0 },
+      })
+
+      await store.fetchList()
+
+      const callArgs = (findCrmCustomerPage as ReturnType<typeof vi.fn>).mock.calls[0][0]
+      expect(callArgs.params.customerStatus).toBe('')
+    })
+  })
+
+  // ==================== US-04: 客户详情 ====================
+
+  describe('fetchDetail - 客户详情查询', () => {
+    it('按 customerId 查询客户详情', async () => {
+      ;(getCrmCustomerById as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800,
+        data: { ...mockCustomers[0], addressList: [] },
+      })
+
+      await store.fetchDetail(1)
+
+      expect(store.detailData?.customerName).toBe('上海XX汽车零部件有限公司')
+      expect(store.detailVisible).toBe(false) // fetchDetail 不自动打开
+    })
+  })
+
+  // ==================== US-03 / US-05: 新增/编辑 ====================
+
+  describe('openAddForm / openEditForm', () => {
+    it('openAddForm 设置为新增模式', () => {
+      store.openAddForm()
+
+      expect(store.formMode).toBe('add')
+      expect(store.formVisible).toBe(true)
+      expect(store.formData.customerCode).toBe('')
+    })
+
+    it('openEditForm 回填行数据并保存 versionNum', () => {
+      const row = mockCustomers[0]
+      store.openEditForm(row)
+
+      expect(store.formMode).toBe('edit')
+      expect(store.formVisible).toBe(true)
+      expect(store.formData.customerCode).toBe('CUS-20260626-0001')
+      expect(store.formVersionNum).toBe(1)
+    })
+  })
+
+  describe('saveOrUpdateCustomer', () => {
+    it('新增客户成功关闭弹窗', async () => {
+      store.openAddForm()
+      store.formData.customerName = '新客户'
+      store.formData.tradeType = 'DOMESTIC'
+      ;(saveCrmCustomer as ReturnType<typeof vi.fn>).mockResolvedValue({ code: 800 })
+      ;(findCrmCustomerPage as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800, data: { rows: [], total: 0 },
+      })
+
+      const result = await store.saveOrUpdateCustomer()
+
+      expect(result).toBe(true)
+      expect(store.formVisible).toBe(false)
+    })
+
+    it('编辑客户携带 versionNum', async () => {
+      const row = mockCustomers[0]
+      store.openEditForm(row)
+      store.formData.shortName = '新简称'
+      ;(updateCrmCustomer as ReturnType<typeof vi.fn>).mockResolvedValue({ code: 800 })
+      ;(findCrmCustomerPage as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800, data: { rows: [], total: 0 },
+      })
+
+      await store.saveOrUpdateCustomer()
+
+      const callArgs = (updateCrmCustomer as ReturnType<typeof vi.fn>).mock.calls[0][0]
+      expect(callArgs.params.versionNum).toBe(1)
+    })
+  })
+
+  // ==================== US-06: 地址管理 ====================
+
+  describe('地址管理', () => {
+    it('fetchAddressList 加载地址列表', async () => {
+      ;(findAddressListByCustomerId as ReturnType<typeof vi.fn>).mockResolvedValue({
+        code: 800,
+        data: [{ addressId: 1, customerId: 1, addressDetail: '上海市金山区XX路100号', isDefault: 1 }],
+      })
+
+      await store.fetchAddressList(1)
+
+      expect(store.addressList.length).toBe(1)
+      expect(store.addressList[0].isDefault).toBe(1)
+    })
+  })
+})