gubersail-platform-ui/src/constants/material.js

/**
 * 物料相关常量定义
 * @fileoverview 物料明细记录、查询参数等类型定义
 */

// ==================== JSDoc 类型定义 ====================

/**
 * 物料明细记录
 * @typedef {Object} MaterialDetailRecord
 * @property {string} id - 物料ID
 * @property {string} materialCode - 物料编码
 * @property {string} materialName - 物料名称
 * @property {string} specification - 规格
 * @property {string} unit - 单位
 * @property {number} quantity - 数量
 * @property {number} unitPrice - 单价
 * @property {number} totalPrice - 总价
 * @property {number} itemStatus - 明细状态：0未确认 1已确认 2部分发货 3已完成
 * @property {string} dataSource - 数据来源：REMOTE远程 IMPORTED导入
 * @property {boolean} isDeletable - 是否可删除
 * @property {string} [remark] - 备注
 * @property {string} [createTime] - 创建时间
 * @property {string} [updateTime] - 更新时间
 */

/**
 * 订单表单模型
 * @typedef {Object} OrderFormModel
 * @property {string} id - 订单ID
 * @property {string} orderNo - 订单编号
 * @property {number} orderType - 订单类型：0未知 1普通
 * @property {number} orderStatus - 订单状态：0草稿 1待审核 2已审核 3已发货 4已完成 5已取消
 * @property {string} customerName - 客户名称
 * @property {string} customerContact - 客户联系方式
 * @property {string} deliveryAddress - 交货地址
 * @property {string} [deliveryDate] - 交货日期
 * @property {number} totalAmount - 订单总金额
 * @property {string} [remark] - 备注
 * @property {Array<MaterialDetailRecord>} materials - 物料明细列表
 * @property {string} [createTime] - 创建时间
 * @property {string} [updateTime] - 更新时间
 */

/**
 * 物料查询参数
 * @typedef {Object} MaterialQueryParams
 * @property {string} [materialCode] - 物料编码
 * @property {string} [materialName] - 物料名称
 * @property {string} [specification] - 规格
 * @property {number} [itemStatus] - 明细状态
 * @property {string} [dataSource] - 数据来源
 * @property {number} [current] - 当前页码
 * @property {number} [pageSize] - 每页条数
 */

/**
 * 物料删除事件数据
 * @typedef {Object} MaterialDeleteEventData
 * @property {string} id - 物料ID
 * @property {string} materialCode - 物料编码
 * @property {string} materialName - 物料名称
 * @property {number} itemStatus - 明细状态
 */

export {}