feat: 完成好水川 MOM 需求1/2/4/5/8（装箱、BOM成本、销售合同、劳动合同、留样）

吴羡

2 天以前 b3fe06c151dc8455649bf0a46e481ceb83e3ea2a

 docs/project-business/data/objects.json

@@ -7,7 +7,7 @@
    {"name": "联系人", "module": "销售管理", "table": "crm_contact", "doc": "客户下联系人，与商机多对多", "upstream": ["客户"], "downstream": ["商机"], "keywords": "联系人 contact"},
    {"name": "商机", "module": "销售管理", "table": "crm_business", "doc": "销售机会，DB 配置式阶段推进，结束态: 赢/输/无效", "upstream": ["客户"], "downstream": ["报价单", "合同"], "keywords": "商机 business 赢单 输单 阶段"},
    {"name": "报价单", "module": "销售管理", "table": "crm_sale_quotation", "doc": "QT编号，选 MDM 物料报价，AI OCR 录入，草稿→已转合同", "upstream": ["商机"], "downstream": ["合同"], "keywords": "报价 quotation QT"},
    {"name": "合同", "module": "销售管理", "table": "crm_contract", "doc": "HT编号，BPM 审批(0草稿/10审批中/20通过/30驳回/40取消/50作废)，通过后可生成销售订单；支持 Excel 导入（一合同多产品明细行、合并单元格自动拉平，客户与物料按名称/编码校验）；产品明细带出物料名称/编码/条码/规格型号/计量单位；删除合同时连带删除产品明细，不留孤儿数据", "upstream": ["报价单"], "downstream": ["销售订单", "回款计划", "开票"], "keywords": "合同 contract 审批 导入"},
    {"name": "合同", "module": "销售管理", "table": "crm_contract", "doc": "HT编号，BPM 审批(0草稿/10审批中/20通过/30驳回/40取消/50作废)，通过后可生成销售订单；支持 Excel 导入（一合同多产品明细行、合并单元格自动拉平，客户与物料按名称/编码校验）；产品明细带出物料名称/编码/条码/规格型号/计量单位；删除合同时连带删除产品明细，不留孤儿数据；销售订单审批通过且订单无关联合同时，系统按「客户名称-销售合同-订单号」自动反向生成草稿合同（不自动提交审批，同一订单仅一份，失败不影响订单审批）", "upstream": ["报价单", "销售订单(自动生成)"], "downstream": ["销售订单", "回款计划", "开票"], "keywords": "合同 contract 审批 导入 自动生成"},
    {"name": "发票", "module": "销售管理", "table": "crm_invoice", "doc": "KP编号（可留空自动生成、系统内唯一），BPM 审批，累计开票≤合同额，附件必传；支持 Excel 导入（仅新增不更新，合同须审核通过且本次金额≤合同剩余可开票额；同一批数据不可重复导入——同合同下发票号码相同、或发票号码留空时开票金额+发票抬头+开票日期相同即判重复，文件内重复行与库内已有单都拒该行并回显维度与实际值）", "upstream": ["合同"], "downstream": ["回款"], "keywords": "开票 发票 invoice 导入 去重"},
    {"name": "回款", "module": "销售管理", "table": "crm_receivable", "doc": "HK编号，创建即审批中(手动审核)，强制先开票，金额双校验", "upstream": ["合同", "发票"], "downstream": ["收款单(关联)"], "keywords": "回款 收款计划 receivable"},
    {"name": "销售目标", "module": "销售管理", "table": "crm_sales_target", "doc": "年/季/月×个人/部门/产品维度的合同回款等目标", "upstream": [], "downstream": ["业绩统计"], "keywords": "目标 target 业绩"},
@@ -19,11 +19,12 @@
    {"name": "采购来票", "module": "进销存", "table": "erp_purchase_invoice", "doc": "FPD编号，AI OCR 预填，累计≤订单总价，付款单的前置", "upstream": ["采购订单"], "downstream": ["付款单"], "keywords": "来票 发票 采购发票"},
    {"name": "付款单", "module": "财务", "table": "erp_finance_payment", "doc": "FKD编号，必须关联来票+附件，累计≤来票金额，BPM 审批", "upstream": ["采购来票"], "downstream": ["结算账户"], "keywords": "付款 应付 payment"},
    {"name": "收款单", "module": "财务", "table": "erp_finance_receipt", "doc": "SKD编号，关联 CRM 客户校验，无 BPM(手动审核)", "upstream": ["销售(弱关联)"], "downstream": ["结算账户"], "keywords": "收款 应收 receipt"},
    {"name": "销售订单", "module": "进销存", "table": "erp_sale_order", "doc": "XSDD编号，BPM 审批，需生产行自动建 MPS，出库状态:未0已预留1部分2全部3，生产完成事件回写", "upstream": ["合同"], "downstream": ["MPS", "发货通知", "销售出库", "售后工单"], "keywords": "销售订单 sale"},
    {"name": "主生产计划", "module": "生产", "table": "mes_pro_mps", "doc": "MPS计划，草稿0→已下发1→完成2/取消3，可合并下发", "upstream": ["销售订单"], "downstream": ["生产工单"], "keywords": "MPS 主计划 生产计划"},
    {"name": "生产工单", "module": "生产", "table": "mes_pro_work_order", "doc": "草稿0→已确认1→完成2/取消3，确认时按工艺路线生成任务，最后一道工序报工回写已生产数量", "upstream": ["MPS"], "downstream": ["生产任务", "领料", "完工入库"], "keywords": "工单 生产工单 work order"},
    {"name": "销售订单", "module": "进销存", "table": "erp_sale_order", "doc": "XSDD编号，BPM 审批，需生产行自动建 MPS；审批通过且订单无关联合同时自动生成 CRM 草稿合同并回写 contractId/contractNo（订单来自合同时跳过），合同生成失败不阻塞审批；出库状态:未0已预留1部分2全部3，生产完成事件回写", "upstream": ["合同", "手工新建"], "downstream": ["MPS", "合同(自动生成)", "发货通知", "销售出库", "售后工单"], "keywords": "销售订单 sale 自动合同"},
    {"name": "主生产计划", "module": "生产", "table": "mes_pro_mps", "doc": "MPS计划，草稿0→已下发1→完成2/取消3，可合并下发，关联工单完成时自动回写完成状态、产量与完成日期", "upstream": ["销售订单"], "downstream": ["生产工单"], "keywords": "MPS 主计划 生产计划"},
    {"name": "生产工单", "module": "生产", "table": "mes_pro_work_order", "doc": "草稿0→已确认1→完成2/取消3，确认时按工艺路线生成任务，最后一道工序报工回写已生产数量；人工完成要求已生产数量>0，完工时同步关联 MPS 已完成；记录超耗报警比例(工单覆盖)与标准/实际/超耗物料成本、物料单位成本、成本更新时间，报工审批后自动重算", "upstream": ["MPS"], "downstream": ["生产任务", "领料", "完工入库", "超耗报警"], "keywords": "工单 生产工单 work order 成本 算料"},
    {"name": "生产任务", "module": "生产", "table": "mes_pro_task", "doc": "工序粒度，预备0→生产中1→部分2→完成4，可暂停9取消5", "upstream": ["生产工单"], "downstream": ["报工"], "keywords": "任务 task 工序"},
    {"name": "报工单", "module": "生产", "table": "mes_pro_feedback", "doc": "草稿0→审批中2→待检3/完成4，按工序顺序校验(上道工序报满才可报)，联动倒冲消耗/产出入库/IPQC", "upstream": ["生产任务"], "downstream": ["产品产出", "物料消耗", "IPQC"], "keywords": "报工 feedback"},
    {"name": "报工单", "module": "生产", "table": "mes_pro_feedback", "doc": "草稿0→审批中2→待检3/完成4，按工序顺序校验(上道工序报满才可报)，联动倒冲消耗/产出入库/IPQC；审批通过后触发工单物料成本重算与超耗报警检查", "upstream": ["生产任务"], "downstream": ["产品产出", "物料消耗", "IPQC", "工单成本", "超耗报警"], "keywords": "报工 feedback"},
    {"name": "超耗报警", "module": "生产", "table": "mes_pro_over_consume_alert", "doc": "报工审批后按 工单→产品→全局参数 阈值判定，实际消耗>标准用量×(1+阈值%)时生成；记录标准/实际/超耗数量、超耗比例、单价与超耗金额，同一工单同物料仅一条，发送站内信给参数指定用户，状态 SENT/FAILED", "upstream": ["报工单", "物料消耗"], "downstream": ["站内信"], "keywords": "超耗 报警 成本 over consume alert"},
    {"name": "工艺路线", "module": "生产", "table": "mes_pro_route", "doc": "工序顺序+质检/关键/倒冲标记，驱动工单任务与报工规则", "upstream": [], "downstream": ["生产工单"], "keywords": "工艺 路线 route 工序"},
    {"name": "到货通知单", "module": "仓储", "table": "mes_wm_arrival_notice", "doc": "采购订单确认收货生成，草稿0→待质检2→待入库3→完成4", "upstream": ["采购订单"], "downstream": ["IQC", "采购入库"], "keywords": "到货 收货 arrival"},
    {"name": "采购入库单", "module": "仓储", "table": "mes_wm_item_receipt", "doc": "草稿0→待上架2→待执行3→完成4，完成后库存+并回写 ERP inCount/inStatus", "upstream": ["到货通知"], "downstream": ["库存台账", "采购订单(回写)"], "keywords": "采购入库 收货入库 receipt"},
@@ -40,10 +41,12 @@
    {"name": "OQC出货检验", "module": "质量", "table": "mes_qc_oqc", "doc": "销售出库提交触发，完成推进出库单待拣货；行操作「出报告」仅在已完成时可见；支持 Excel 批量导入（客户须在当前登录用户的客户数据权限范围内）；同一批数据不可重复导入（物料+客户+批次号+出货日期，文件内重复行与库内已有单都拒该行）", "upstream": ["销售出库单", "Excel 批量导入"], "downstream": ["销售出库单(推进)", "报告实例(出报告)"], "keywords": "OQC 出货检验 出厂检验 出报告 批量导入 导入模板"},
    {"name": "RQC退货检验", "module": "质量", "table": "mes_qc_rqc", "doc": "生产退料/销售退货/售后退货触发，结论回调售后；行操作「出报告」仅在已完成时可见。措辞已统一为「退货检验」（原菜单父项与 mes_qc_type 字典写「退料检验」，与后端枚举/表注释/菜单权限子项不一致；RQC 三者都覆盖，故取「退货检验」）", "upstream": ["退料", "退货"], "downstream": ["退货入库", "售后回调", "报告实例(出报告)"], "keywords": "RQC 退货检验 退料检验 出报告"},
    {"name": "NCR不合格品", "module": "质量", "table": "mes_qc_ncr", "doc": "待评审0→已评审6→已处置7→已关闭8，处置:退货/报废/返工/让步接收/降级", "upstream": ["IQC/IPQC/OQC/RQC"], "downstream": ["退货/报废/返工(台账)"], "keywords": "NCR 不合格 处置 特采 报废"},
    {"name": "留样记录", "module": "质量", "table": "mes_qc_retention_sample", "doc": "生产工单完工前必须登记，一张工单只能一条（work_order_id 唯一）；编号 LY+yyyyMMdd+4位流水按天生成；留样数量默认 2 件，到期日期默认留样日期+6个月；销售订单按 MPS 下发记录自动绑定，合并下发多张订单时需指定本次留样对应订单，客户订单来源工单按来源单号校验，库存备货工单可不绑定，MPS 记录的销售订单在系统中不存在时提示并阻断保存；手工完成与报工达标自动完工均校验留样，未登记拦截；工单已完成不允许删除留样", "upstream": ["生产工单", "MPS(销售订单)"], "downstream": ["工单完成校验", "销售订单(追溯)"], "keywords": "留样 留样记录 retention sample 完工留样 销售订单绑定"},
    {"name": "设备", "module": "设备", "table": "mes_dv_machinery", "doc": "台账状态:停机/生产中/保养中；点检·保养·维修工单；AI 风险预测消费其数据", "upstream": [], "downstream": ["点检", "维修", "生产风险预测"], "keywords": "设备 点检 保养 维修 machinery"},
    {"name": "售后工单", "module": "售后", "table": "after_sale_ticket", "doc": "草稿0→处理中10→待入库30→待退款40→完结50→关闭60/取消99，判定:一般/维修/退货", "upstream": ["客户反馈(人工录入)"], "downstream": ["维修记录", "退货申请"], "keywords": "售后 工单 ticket 维修"},
    {"name": "退货申请", "module": "售后", "table": "after_sale_return", "doc": "草稿0→已审核20(自动建MES退货单)→已质检40→已入库50→已退款60→关闭70；类型:退款退货/换货/仅退款", "upstream": ["售后工单"], "downstream": ["销售退货单", "退款"], "keywords": "售后退货 return"},
    {"name": "员工", "module": "人力", "table": "hrm_employee", "doc": "在职1/试用2/离职3，入职自动建系统账号", "upstream": [], "downstream": ["交接映射", "考勤", "薪酬"], "keywords": "员工 入职 employee"},
    {"name": "员工", "module": "人力", "table": "hrm_employee", "doc": "在职1/试用2/离职3，入职自动建系统账号", "upstream": [], "downstream": ["交接映射", "员工合同", "考勤", "薪酬"], "keywords": "员工 入职 employee"},
    {"name": "员工合同", "module": "人力", "table": "hrm_employee_contract", "doc": "一个员工多份合同(续签链 parentId、当前合同 isCurrent)；合同类型/期限类型走字典，固定期限必须填结束日期、同员工时间不得重叠；支持模板导入；可按合同记录自动生成 Word 劳动合同(占位符填充员工/部门/岗位/合同信息)并存系统文件库绑定为合同附件，每次生成保留历史版本；解除/终止需填日期与原因", "upstream": ["员工"], "downstream": ["合同文档附件", "到期提醒"], "keywords": "员工合同 劳动合同 合同文档 生成合同 附件 contract"},
    {"name": "离职交接", "module": "人力", "table": "hrm_user_handover", "doc": "from→to 映射，已完成20 后 expandUserIds 扩展交接人可见数据（当前各业务模块尚未实际接入调用）", "upstream": ["离职申请"], "downstream": ["各模块我的数据查询"], "keywords": "交接 离职 handover expandUserIds"},
    {"name": "排班计划", "module": "设备", "table": "mes_cal_plan", "doc": "班组×班次×日期排班，供生产与考勤引用", "upstream": [], "downstream": ["生产任务", "考勤"], "keywords": "排班 班组 班次 日历"},
    {"name": "报告模板", "module": "质检报告", "table": "qc_report_template", "doc": "智能质检报告模板，启用0/停用1；画布内容存在 qc_report_template_version（草稿0/已发布1/已停用2，已发布不可覆盖），currentVersion 指向当前已发布版本；源文件经 AI 导入识别成草稿后由人工确认才成为版本；同一模板重复导入按【替换】处理——先删旧附件（连带 blob 行与磁盘文件）再绑新的，不留孤儿文件；删除模板会连带清附件", "upstream": ["人工设计(GrapesJS 设计器)", "AI 导入草稿(qc-report/ai-import/draft)"], "downstream": ["模板版本", "报告实例"], "keywords": "报告模板 质检报告 template 设计器 版本 AI导入 识别 草稿 源文件替换"},