迪诺学堂标识

15-物料资产中心详细PRD

MAT · 管理物料、固定资产、图书、礼品和校区库存，联动采购、入库、领用、调拨、盘点、报废、财务凭证和积分商城兑换。

系统 迪诺学堂
版本 v1.0
日期 2026-06-23
阶段 模块详细 PRD

01 · 模块定位

物料资产中心

采购入库后库存增加，学员兑换礼品后库存锁定，前台核销后完成出库、积分扣减和订单关闭。

业务目标

管理物料、固定资产、图书、礼品和校区库存，联动采购、入库、领用、调拨、盘点、报废、财务凭证和积分商城兑换。

使用终端

PC Web 采购/库管工作台，校区前台核销入口，学员端兑换入口。

验收主线

采购入库后库存增加，学员兑换礼品后库存锁定，前台核销后完成出库、积分扣减和订单关闭。

02 · 范围边界

明确本模块负责什么、依赖什么、不负责什么

边界清晰后，原型、接口和数据库设计才能避免重复建设。

模块内范围

  • 物料档案
  • 供应商
  • 采购申请
  • 采购入库
  • 库存台账
  • 固定资产
  • 图书管理
  • 礼品核销
  • 供应商报价
  • 采购对账
  • 采购付款
  • 采购退货
  • 固定资产维修
  • 责任人变更
  • 资产调拨
  • 图书进销存
  • 积分礼品库存售后
  • 积分礼品实物售后
  • 库存成本策略
  • 成本调整单
  • 设备维修工单

上游依赖

  • 组织校区与账号权限
  • 课程/客户/合同等主数据
  • 审批流、消息模板、文件中心
  • 必要的第三方接口密钥

下游输出

  • 业务状态和待办
  • 消息通知和审批记录
  • 报表指标和数据快照
  • 审计日志和接口回执

03 · 确认口径、后台配置与默认实施规则

物料资产中心必须承接的已确认规则

本章节来自待决策与澄清清单的收口结果，已经转为本模块 PRD 的正式需求、配置项或默认实施规则。
分类事项本模块落地要求责任方
默认实施规则接口设计说明书组织方式采用单独 HTML 文件集中管理接口协议；模块 PRD 保留模块级接口摘要，避免每个模块重复写通用协议。产品/研发
默认实施规则接口错误码与重试中间件所有外部接口和内部异步任务统一错误码、幂等键、重试次数、告警阈值和回执归档策略。后端/测试/运维

04 · 业务流程

物料资产中心主流程

流程用于指导原型图的页面顺序、按钮状态和异常分支。
01物料档案

维护教材、教具、礼品、办公用品、市场物料、固定资产和图书的分类、编码、单位和状态。

02供应商

维护供应商档案、联系人、报价资质、结算方式、对账周期和停用状态。

03采购申请

采购申请按物料类别、预算、校区、供应商和金额阈值进入审批。

04采购入库

到货验收支持扫码入库、数量差异、质量异常、发票关联和入库单生成。

05库存台账

库存支持总部仓、校区仓、教室、员工、批次、序列号、安全库存和库存金额。

06固定资产

固定资产覆盖购置、领用、归还、维修、折旧、调拨、盘点、报损、报废和丢失处理。

07图书管理

图书仅做进销存管理，覆盖图书 SKU、采购入库、领用出库、调拨、损耗、盘点和课程配套发放。

08礼品核销

积分商城礼品从物料 SKU 上架，兑换后锁库，前台核销后自动出库并关闭兑换订单。

05 · 功能清单

按子模块拆到可设计、可开发、可测试的颗粒度

每一行功能都需要在原型中体现入口、状态、按钮、字段和反馈。
一级功能二级功能功能说明规则/验收
物料档案基础维护物料档案支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
物料档案业务处理维护教材、教具、礼品、办公用品、市场物料、固定资产和图书的分类、编码、单位和状态。必须联动状态、权限、消息、审批和指标
物料档案异常闭环物料编码重复处理失败原因可见、可重试、可转人工、可追溯
供应商基础维护供应商支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
供应商业务处理维护供应商档案、联系人、报价资质、结算方式、对账周期和停用状态。必须联动状态、权限、消息、审批和指标
供应商异常闭环供应商状态异常处理失败原因可见、可重试、可转人工、可追溯
采购申请基础维护采购申请支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
采购申请业务处理采购申请按物料类别、预算、校区、供应商和金额阈值进入审批。必须联动状态、权限、消息、审批和指标
采购申请异常闭环预算不足处理失败原因可见、可重试、可转人工、可追溯
采购入库基础维护采购入库支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
采购入库业务处理到货验收支持扫码入库、数量差异、质量异常、发票关联和入库单生成。必须联动状态、权限、消息、审批和指标
采购入库异常闭环入库差异处理失败原因可见、可重试、可转人工、可追溯
库存台账基础维护库存台账支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
库存台账业务处理库存支持总部仓、校区仓、教室、员工、批次、序列号、安全库存和库存金额。必须联动状态、权限、消息、审批和指标
库存台账异常闭环库存不足处理失败原因可见、可重试、可转人工、可追溯
固定资产基础维护固定资产支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
固定资产业务处理固定资产覆盖购置、领用、归还、维修、折旧、调拨、盘点、报损、报废和丢失处理。必须联动状态、权限、消息、审批和指标
固定资产异常闭环资产责任人缺失处理失败原因可见、可重试、可转人工、可追溯
图书管理基础维护图书管理支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
图书管理业务处理图书仅做进销存管理，覆盖图书 SKU、采购入库、领用出库、调拨、损耗、盘点和课程配套发放。必须联动状态、权限、消息、审批和指标
图书管理异常闭环图书库存不足处理失败原因可见、可重试、可转人工、可追溯
礼品核销基础维护礼品核销支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
礼品核销业务处理积分商城礼品从物料 SKU 上架，兑换后锁库，前台核销后自动出库并关闭兑换订单。必须联动状态、权限、消息、审批和指标
礼品核销异常闭环核销码失效处理失败原因可见、可重试、可转人工、可追溯
供应商报价基础维护供应商报价支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
供应商报价业务处理采购前可维护多供应商报价、有效期、税率、起订量和比价结果。必须联动状态、权限、消息、审批和指标
供应商报价异常闭环报价过期处理失败原因可见、可重试、可转人工、可追溯
采购对账基础维护采购对账支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
采购对账业务处理供应商对账联动采购订单、入库差异、退货、发票和付款申请。必须联动状态、权限、消息、审批和指标
采购对账异常闭环供应商对账不平处理失败原因可见、可重试、可转人工、可追溯
采购付款基础维护采购付款支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
采购付款业务处理采购对账通过后进入付款申请、付款审批、付款状态和财务凭证联动。必须联动状态、权限、消息、审批和指标
采购付款异常闭环采购付款失败处理失败原因可见、可重试、可转人工、可追溯
采购退货基础维护采购退货支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
采购退货业务处理采购退货支持退货申请、出库、供应商确认、应付冲减和库存成本回滚。必须联动状态、权限、消息、审批和指标
采购退货异常闭环退货数量超限处理失败原因可见、可重试、可转人工、可追溯
固定资产维修基础维护固定资产维修支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
固定资产维修业务处理固定资产和教学设备维修支持报修、派工、处理、配件消耗、恢复校验和关闭。必须联动状态、权限、消息、审批和指标
固定资产维修异常闭环维修超期处理失败原因可见、可重试、可转人工、可追溯
责任人变更基础维护责任人变更支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
责任人变更业务处理固定资产、设备、图书和高价值物料责任人变更需记录移交、确认和审计。必须联动状态、权限、消息、审批和指标
责任人变更异常闭环责任人确认超时处理失败原因可见、可重试、可转人工、可追溯
资产调拨基础维护资产调拨支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
资产调拨业务处理跨校区或跨仓库调拨生成调出、在途、调入、成本转移和签收记录。必须联动状态、权限、消息、审批和指标
资产调拨异常闭环调拨签收失败处理失败原因可见、可重试、可转人工、可追溯
图书进销存基础维护图书进销存支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
图书进销存业务处理图书库存独立管理采购、入库、领用、调拨、盘点、损耗和库存预警，不做借阅。必须联动状态、权限、消息、审批和指标
图书进销存异常闭环盘点差异处理失败原因可见、可重试、可转人工、可追溯
积分礼品库存售后基础维护积分礼品库存售后支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
积分礼品库存售后业务处理积分兑换取消、过期未核销、核销撤销和库存释放形成礼品库存售后流水。必须联动状态、权限、消息、审批和指标
积分礼品库存售后异常闭环库存释放失败处理失败原因可见、可重试、可转人工、可追溯
积分礼品实物售后基础维护积分礼品实物售后支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
积分礼品实物售后业务处理礼品领取后退货、换货、坏损、返库、报损、补发和积分返还均需联动库存与积分流水。必须联动状态、权限、消息、审批和指标
积分礼品实物售后异常闭环礼品坏损处理处理失败原因可见、可重试、可转人工、可追溯
库存成本策略基础维护库存成本策略支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
库存成本策略业务处理物料、礼品、图书和固定资产支持批次成本、移动加权、先进先出等成本口径配置。必须联动状态、权限、消息、审批和指标
库存成本策略异常闭环成本口径缺失处理失败原因可见、可重试、可转人工、可追溯
成本调整单基础维护成本调整单支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
成本调整单业务处理盘盈盘亏、报损报废、调拨差异和历史成本修正通过成本调整单审批生效。必须联动状态、权限、消息、审批和指标
成本调整单异常闭环成本调整失败处理失败原因可见、可重试、可转人工、可追溯
设备维修工单基础维护设备维修工单支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
设备维修工单业务处理摄像头、门店网关、考勤机、TV 等设备异常可生成维修工单并回写设备状态。必须联动状态、权限、消息、审批和指标
设备维修工单异常闭环设备恢复校验失败处理失败原因可见、可重试、可转人工、可追溯

功能到数据对象/接口/表映射

功能域承接对象核心表代表接口状态机/状态字段研发落地校验
物料档案Supplier、Material/Inventory/Asset/Book、Warehouse、Inventorymat_supplier、mat_sku、mat_warehouse、mat_inventory接口资源组 /api/v1/mat/features/01sku_type、warehouse_type新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
供应商Supplier、StockInmat_supplier、mat_stock_inPOST/GET /api/v1/material/purchase-reconciliationsstock_in_status、approval_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
采购申请Supplier、StockInmat_supplier、mat_stock_in接口资源组 /api/v1/mat/features/03stock_in_status、approval_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
采购入库Supplier、StockInmat_supplier、mat_stock_in接口资源组 /api/v1/mat/features/04stock_in_status、approval_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
库存台账Material/Inventory/Asset/Book、Inventory、StockIn、StockOutmat_sku、mat_inventory、mat_stock_in、mat_stock_out接口资源组 /api/v1/mat/features/05sku_type、stock_in_status、approval_status、stock_out_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
固定资产Asset、AssetLifecycle/Maintenancemat_asset、mat_maintenance_order接口资源组 /api/v1/mat/features/06asset_status、maintenance_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
图书管理Material/Inventory/Asset/Bookmat_sku接口资源组 /api/v1/mat/features/07sku_type新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
礼品核销Supplier、Material/Inventory/Asset/Book、Warehouse、Inventorymat_supplier、mat_sku、mat_warehouse、mat_inventory接口资源组 /api/v1/mat/features/08sku_type、warehouse_type新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
供应商报价Supplier、StockInmat_supplier、mat_stock_in接口资源组 /api/v1/mat/features/09stock_in_status、approval_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
采购对账Supplier、StockInmat_supplier、mat_stock_in接口资源组 /api/v1/mat/features/10stock_in_status、approval_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
采购付款Supplier、StockInmat_supplier、mat_stock_in接口资源组 /api/v1/mat/features/11stock_in_status、approval_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
采购退货Supplier、StockInmat_supplier、mat_stock_in接口资源组 /api/v1/mat/features/12stock_in_status、approval_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
固定资产维修Asset、AssetLifecycle/Maintenancemat_asset、mat_maintenance_order接口资源组 /api/v1/mat/features/13asset_status、maintenance_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
责任人变更Supplier、Material/Inventory/Asset/Book、Warehouse、Inventorymat_supplier、mat_sku、mat_warehouse、mat_inventory接口资源组 /api/v1/mat/features/14sku_type、warehouse_type新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
资产调拨Material/Inventory/Asset/Book、Inventory、StockIn、StockOutmat_sku、mat_inventory、mat_stock_in、mat_stock_out接口资源组 /api/v1/mat/features/15sku_type、stock_in_status、approval_status、stock_out_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
图书进销存Supplier、Material/Inventory/Asset/Book、Warehouse、Inventorymat_supplier、mat_sku、mat_warehouse、mat_inventory接口资源组 /api/v1/mat/features/16sku_type、warehouse_type新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
积分礼品库存售后Material/Inventory/Asset/Book、Inventory、StockIn、StockOutmat_sku、mat_inventory、mat_stock_in、mat_stock_out接口资源组 /api/v1/mat/features/17sku_type、stock_in_status、approval_status、stock_out_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
积分礼品实物售后Supplier、Material/Inventory/Asset/Book、Warehouse、Inventorymat_supplier、mat_sku、mat_warehouse、mat_inventory接口资源组 /api/v1/mat/features/18sku_type、warehouse_type新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
库存成本策略Material/Inventory/Asset/Book、Inventory、StockIn、StockOutmat_sku、mat_inventory、mat_stock_in、mat_stock_out接口资源组 /api/v1/mat/features/19sku_type、stock_in_status、approval_status、stock_out_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
成本调整单Material/Inventory/Asset/Book、Inventory、StockIn、StockOutmat_sku、mat_inventory、mat_stock_in、mat_stock_out接口资源组 /api/v1/mat/features/20sku_type、stock_in_status、approval_status、stock_out_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
设备维修工单Asset、AssetLifecycle/Maintenancemat_asset、mat_maintenance_order接口资源组 /api/v1/mat/features/21asset_status、maintenance_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计

06 · 原子级功能需求

用于研发任务拆分和测试用例追踪

需求编号可直接进入项目管理工具。
编号需求描述入口页面关键动作输入校验输出结果异常处理验收标准
FR-MAT-001物料分类覆盖教材、教具、礼品、办公用品、市场物料、固定资产和图书资产生命周期/图书进销存领用、维修、责任人变更、盘点或图书出入库校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务责任人缺失、维修超期或库存不足主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-MAT-002SKU 档案支持编码、规格、单位、条码、成本价、适用校区、安全库存和库存属性采购入库采购申请校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务盘点差异主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-MAT-003采购申请按金额、物料类别、预算、校区和供应商进入审批采购对账付款采购对账、采购付款或凭证归档校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务对账不平、付款失败或凭证缺失主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-MAT-004到货验收支持扫码入库、数量差异、质量异常、发票关联和入库单生成指标异常处理异常订阅、责任人处理或口径审批校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务指标延迟、责任人缺失或口径版本不一致主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-MAT-005库存支持总部仓、校区仓、教室、员工、批次、序列号、安全库存和库存金额采购对账付款采购付款校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务供应商对账不平主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-MAT-006固定资产支持购置、领用、维修、折旧、调拨、盘点和报废资产生命周期/图书进销存领用、维修、责任人变更、盘点或图书出入库校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务责任人缺失、维修超期或库存不足主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-MAT-007图书仅支持采购、入库、领用出库、调拨、损耗、盘点和课程配套发放采购对账付款采购对账、采购付款或凭证归档校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务对账不平、付款失败或凭证缺失主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-MAT-008积分商城礼品从物料 SKU 上架，兑换后锁库，线下核销后自动出库积分商城/兑换售后积分兑换、取消、核销或库存释放校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务积分不足、库存释放失败或核销码失效主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-MAT-009物料采购需覆盖供应商报价、采购审批、采购入库、入库差异、供应商对账、采购付款、采购退货和凭证联动。采购对账付款采购对账、采购付款或凭证归档校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务对账不平、付款失败或凭证缺失主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-MAT-010固定资产需覆盖领用、归还、责任人变更、调拨、维修、盘点、报损、报废和丢失赔偿。资产生命周期/图书进销存领用、维修、责任人变更、盘点或图书出入库校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务责任人缺失、维修超期或库存不足主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-MAT-011图书只做进销存管理，覆盖图书 SKU、采购入库、领用出库、调拨、盘点、报损和库存预警。采购对账付款采购对账、采购付款或凭证归档校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务对账不平、付款失败或凭证缺失主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-MAT-012积分商城礼品库存需与物料库存联动，兑换锁库、核销出库、取消释放、过期释放和异常回滚必须可追踪。积分商城/兑换售后积分兑换、取消、核销或库存释放校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务积分不足、库存释放失败或核销码失效主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-MAT-013积分礼品领取后的退货、换货、坏损需联动物料库存，按返库、换新、报损或补发生成库存流水和审计记录。积分商城/兑换售后积分兑换、取消、核销或库存释放校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务积分不足、库存释放失败或核销码失效主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-MAT-014物料、礼品、图书和固定资产需配置成本计价方式，支持批次成本、移动加权和先进先出中的实施口径，并明确跨校区调拨、盘盈盘亏、报损报废的财务科目。资产生命周期/图书进销存领用、维修、责任人变更、盘点或图书出入库校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务责任人缺失、维修超期或库存不足主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-MAT-015巡课摄像头、门店网关和相关设备离线后可生成维修工单，跟踪派单、接单、处理、恢复校验、关闭和升级。资产生命周期/图书进销存领用、维修、责任人变更、盘点或图书出入库校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务责任人缺失、维修超期或库存不足主流程、异常流、权限流、接口失败和数据一致性均可通过测试

07 · 关联闭环补充需求

物料资产中心在跨模块闭环中的责任边界

本章节承接最终闭环核对清单，明确本模块需要补齐的页面、接口对象、异常兜底和验收口径。
闭环项本模块责任关键场景页面/功能补充关联对象/接口验收口径
礼品实物售后负责礼品库存、核销、取消、退回、过期、售后和线下领取异常积分商城兑换礼品后的线下领取和异常处理礼品库存、兑换核销、售后处理、库存释放、积分退回联动PointsAccount/PointsOrder、PointsRedemptionAfterSales、Material/Inventory/Asset/Book售后完成后库存流水、积分流水和核销流水一致
库存成本策略负责物料、固定资产、图书、礼品的计价方式、成本流水和盘点差异采购入库、出库、调拨、报损、盘点、资产维修成本策略配置、库存流水、盘点差异、成本调整Material/Inventory/Asset/Book、PurchaseReconciliation/Payment所有库存变动必须有成本来源和审计记录
设备维修工单负责设备、固定资产和教学硬件的维修工单生命周期摄像头、网关、考勤机、TV、电脑等设备故障维修工单、派工、处理记录、配件消耗、复核关闭AssetLifecycle/Maintenance、ClassroomCamera/PatrolRecord/TeachingQualityScore维修工单关闭时必须回写资产状态和处理成本

08 · 页面与原型设计说明

页面清单、布局要求、按钮字段和状态

原型图设计需要覆盖列表、详情、表单、弹窗、空状态、异常状态和权限状态。
终端页面用户页面目标布局结构关键按钮关键字段异常状态原型备注
PC Web物料档案采购/库管/校区前台维护物料、礼品、图书、固定资产、供应商和安全库存资产库存页采用左侧分类树、顶部仓库/校区筛选、中部台账表格，详情抽屉展示流水、成本、责任人和审计。新增 SKU、采购申请、验收入库、领用出库、调拨、盘点、报损报废、维修派工物料编码、分类、仓库/校区、库存数量、批次成本、供应商、责任人、盘点差异、物料分类、库存状态库存不足、编码重复、入库差异、责任人缺失、维修超期、成本调整失败需覆盖图书仅进销存、固定资产责任人变更、维修工单、礼品库存、成本策略和财务凭证联动。 建议 Figma Frame：MAT-物料档案；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web采购入库采购/库管/财务发起采购、审批、到货验收、发票关联和入库单据页采用步骤式表单，票据区支持 OCR 识别与核验结果；付款台账以批次、状态、异常原因和补偿入口组织。新增报销单、OCR 识别、国税核验、发票查重、提交审批、生成付款批次、失败重试报销人、费用类型、发票号码、校区税务主体、核验编码、重复结果、付款账户、补偿状态、物料编码、物料分类OCR 低置信度、发票核验失败、重复报销、付款失败、付款撤销待审、接口频控需绘制票据识别、人工修正、国税主体选择、查重拦截、审批流、付款失败补偿和日志详情。 建议 Figma Frame：MAT-采购入库；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web库存台账库管/校区前台查询库存、领用出库、调拨、盘点、报废和库存预警资产库存页采用左侧分类树、顶部仓库/校区筛选、中部台账表格，详情抽屉展示流水、成本、责任人和审计。新增 SKU、采购申请、验收入库、领用出库、调拨、盘点、报损报废、维修派工物料编码、分类、仓库/校区、库存数量、批次成本、供应商、责任人、盘点差异、物料分类、库存状态库存不足、编码重复、入库差异、责任人缺失、维修超期、成本调整失败需覆盖图书仅进销存、固定资产责任人变更、维修工单、礼品库存、成本策略和财务凭证联动。 建议 Figma Frame：MAT-库存台账；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web/微信小程序礼品核销校区前台/学员扫码核销积分兑换订单、扣减礼品库存并回写积分订单商城首页展示积分余额、礼品分类和库存状态；订单详情展示核销码、领取校区、售后进度和库存联动结果。兑换礼品、取消兑换、查看核销码、扫码核销、申请售后、查看积分流水积分余额、礼品 SKU、所需积分、可用库存、兑换订单、核销码、领取校区、售后状态、物料编码、物料分类积分不足、库存不足、核销码过期、重复核销、库存释放失败、积分退回失败需画兑换确认、库存锁定、核销成功、取消退回、实物售后、线下领取异常和积分流水。 建议 Figma Frame：MAT-礼品核销；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web采购对账付款物料管理员/财务处理供应商对账、采购付款、付款凭证、采购退货和入库差异财务工作台左侧账套/期间切换，中部为凭证或报表列表，右侧展示借贷分录、附件、来源单据和回执。切换账套、生成凭证、审核凭证、红冲、期间结账、生成申报表、归档回执校区账套、会计期间、凭证字号、借方金额、贷方金额、来源单据、审核人、回执状态、物料编码、物料分类借贷不平、期间关闭、来源单据缺失、监管回执失败、申报数据不平、成本口径缺失需覆盖总部跨账套视角、校区独立账套、凭证来源追溯、红冲、反结账限制和监管/税务回执。 建议 Figma Frame：MAT-采购对账付款；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web固定资产维修与责任人变更物料管理员/校区前台维护资产维修、责任人变更、领用归还、调拨、报废和丢失处理资产库存页采用左侧分类树、顶部仓库/校区筛选、中部台账表格，详情抽屉展示流水、成本、责任人和审计。新增 SKU、采购申请、验收入库、领用出库、调拨、盘点、报损报废、维修派工物料编码、分类、仓库/校区、库存数量、批次成本、供应商、责任人、盘点差异、物料分类、库存状态库存不足、编码重复、入库差异、责任人缺失、维修超期、成本调整失败需覆盖图书仅进销存、固定资产责任人变更、维修工单、礼品库存、成本策略和财务凭证联动。 建议 Figma Frame：MAT-固定资产维修与责任人变更；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web图书进销存物料管理员/校区前台只做图书采购入库、领用出库、调拨、盘点、报损和库存预警资产库存页采用左侧分类树、顶部仓库/校区筛选、中部台账表格，详情抽屉展示流水、成本、责任人和审计。新增 SKU、采购申请、验收入库、领用出库、调拨、盘点、报损报废、维修派工物料编码、分类、仓库/校区、库存数量、批次成本、供应商、责任人、盘点差异、物料分类、库存状态库存不足、编码重复、入库差异、责任人缺失、维修超期、成本调整失败需覆盖图书仅进销存、固定资产责任人变更、维修工单、礼品库存、成本策略和财务凭证联动。 建议 Figma Frame：MAT-图书进销存；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web礼品实物售后处理前台/物料管理员处理积分礼品实物售后、返库、换新、报损、补发和库存流水商城首页展示积分余额、礼品分类和库存状态；订单详情展示核销码、领取校区、售后进度和库存联动结果。兑换礼品、取消兑换、查看核销码、扫码核销、申请售后、查看积分流水积分余额、礼品 SKU、所需积分、可用库存、兑换订单、核销码、领取校区、售后状态、物料编码、物料分类积分不足、库存不足、核销码过期、重复核销、库存释放失败、积分退回失败需画兑换确认、库存锁定、核销成功、取消退回、实物售后、线下领取异常和积分流水。 建议 Figma Frame：MAT-礼品实物售后处理；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web库存成本策略物料管理员/财务配置批次成本、移动加权、先进先出、成本科目和跨校区调拨成本规则财务工作台左侧账套/期间切换，中部为凭证或报表列表，右侧展示借贷分录、附件、来源单据和回执。切换账套、生成凭证、审核凭证、红冲、期间结账、生成申报表、归档回执校区账套、会计期间、凭证字号、借方金额、贷方金额、来源单据、审核人、回执状态、物料编码、物料分类借贷不平、期间关闭、来源单据缺失、监管回执失败、申报数据不平、成本口径缺失需覆盖总部跨账套视角、校区独立账套、凭证来源追溯、红冲、反结账限制和监管/税务回执。 建议 Figma Frame：MAT-库存成本策略；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web图书库存授权用户围绕进销存范围完善图书库存的入口、字段、状态、异常提示、处理进度和验收反馈资产库存页采用左侧分类树、顶部仓库/校区筛选、中部台账表格，详情抽屉展示流水、成本、责任人和审计。新增 SKU、采购申请、验收入库、领用出库、调拨、盘点、报损报废、维修派工物料编码、分类、仓库/校区、库存数量、批次成本、供应商、责任人、盘点差异、物料分类、库存状态库存不足、编码重复、入库差异、责任人缺失、维修超期、成本调整失败需覆盖图书仅进销存、固定资产责任人变更、维修工单、礼品库存、成本策略和财务凭证联动。 建议 Figma Frame：MAT-图书库存；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web固定资产授权用户围绕进销存范围完善固定资产的入口、字段、状态、异常提示、处理进度和验收反馈资产库存页采用左侧分类树、顶部仓库/校区筛选、中部台账表格，详情抽屉展示流水、成本、责任人和审计。新增 SKU、采购申请、验收入库、领用出库、调拨、盘点、报损报废、维修派工物料编码、分类、仓库/校区、库存数量、批次成本、供应商、责任人、盘点差异、物料分类、库存状态库存不足、编码重复、入库差异、责任人缺失、维修超期、成本调整失败需覆盖图书仅进销存、固定资产责任人变更、维修工单、礼品库存、成本策略和财务凭证联动。 建议 Figma Frame：MAT-固定资产；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web库存流水授权用户围绕进销存范围完善库存流水的入口、字段、状态、异常提示、处理进度和验收反馈资产库存页采用左侧分类树、顶部仓库/校区筛选、中部台账表格，详情抽屉展示流水、成本、责任人和审计。新增 SKU、采购申请、验收入库、领用出库、调拨、盘点、报损报废、维修派工物料编码、分类、仓库/校区、库存数量、批次成本、供应商、责任人、盘点差异、物料分类、库存状态库存不足、编码重复、入库差异、责任人缺失、维修超期、成本调整失败需覆盖图书仅进销存、固定资产责任人变更、维修工单、礼品库存、成本策略和财务凭证联动。 建议 Figma Frame：MAT-库存流水；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web礼品库存授权用户围绕积分联动完善礼品库存的入口、字段、状态、异常提示、处理进度和验收反馈资产库存页采用左侧分类树、顶部仓库/校区筛选、中部台账表格，详情抽屉展示流水、成本、责任人和审计。新增 SKU、采购申请、验收入库、领用出库、调拨、盘点、报损报废、维修派工物料编码、分类、仓库/校区、库存数量、批次成本、供应商、责任人、盘点差异、物料分类、库存状态库存不足、编码重复、入库差异、责任人缺失、维修超期、成本调整失败需覆盖图书仅进销存、固定资产责任人变更、维修工单、礼品库存、成本策略和财务凭证联动。 建议 Figma Frame：MAT-礼品库存；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web兑换订单授权用户围绕积分联动完善兑换订单的入口、字段、状态、异常提示、处理进度和验收反馈资产库存页采用左侧分类树、顶部仓库/校区筛选、中部台账表格，详情抽屉展示流水、成本、责任人和审计。新增 SKU、采购申请、验收入库、领用出库、调拨、盘点、报损报废、维修派工物料编码、分类、仓库/校区、库存数量、批次成本、供应商、责任人、盘点差异、物料分类、库存状态库存不足、编码重复、入库差异、责任人缺失、维修超期、成本调整失败需覆盖图书仅进销存、固定资产责任人变更、维修工单、礼品库存、成本策略和财务凭证联动。 建议 Figma Frame：MAT-兑换订单；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web核销台授权用户围绕积分联动完善核销台的入口、字段、状态、异常提示、处理进度和验收反馈资产库存页采用左侧分类树、顶部仓库/校区筛选、中部台账表格，详情抽屉展示流水、成本、责任人和审计。新增 SKU、采购申请、验收入库、领用出库、调拨、盘点、报损报废、维修派工物料编码、分类、仓库/校区、库存数量、批次成本、供应商、责任人、盘点差异、物料分类、库存状态库存不足、编码重复、入库差异、责任人缺失、维修超期、成本调整失败需覆盖图书仅进销存、固定资产责任人变更、维修工单、礼品库存、成本策略和财务凭证联动。 建议 Figma Frame：MAT-核销台；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web采购订单授权用户围绕采购财务完善采购订单的入口、字段、状态、异常提示、处理进度和验收反馈资产库存页采用左侧分类树、顶部仓库/校区筛选、中部台账表格，详情抽屉展示流水、成本、责任人和审计。新增 SKU、采购申请、验收入库、领用出库、调拨、盘点、报损报废、维修派工物料编码、分类、仓库/校区、库存数量、批次成本、供应商、责任人、盘点差异、物料分类、库存状态库存不足、编码重复、入库差异、责任人缺失、维修超期、成本调整失败需覆盖图书仅进销存、固定资产责任人变更、维修工单、礼品库存、成本策略和财务凭证联动。 建议 Figma Frame：MAT-采购订单；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web入库单授权用户围绕采购财务完善入库单的入口、字段、状态、异常提示、处理进度和验收反馈资产库存页采用左侧分类树、顶部仓库/校区筛选、中部台账表格，详情抽屉展示流水、成本、责任人和审计。新增 SKU、采购申请、验收入库、领用出库、调拨、盘点、报损报废、维修派工物料编码、分类、仓库/校区、库存数量、批次成本、供应商、责任人、盘点差异、物料分类、库存状态库存不足、编码重复、入库差异、责任人缺失、维修超期、成本调整失败需覆盖图书仅进销存、固定资产责任人变更、维修工单、礼品库存、成本策略和财务凭证联动。 建议 Figma Frame：MAT-入库单；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web对账单授权用户围绕采购财务完善对账单的入口、字段、状态、异常提示、处理进度和验收反馈资产库存页采用左侧分类树、顶部仓库/校区筛选、中部台账表格，详情抽屉展示流水、成本、责任人和审计。新增 SKU、采购申请、验收入库、领用出库、调拨、盘点、报损报废、维修派工物料编码、分类、仓库/校区、库存数量、批次成本、供应商、责任人、盘点差异、物料分类、库存状态库存不足、编码重复、入库差异、责任人缺失、维修超期、成本调整失败需覆盖图书仅进销存、固定资产责任人变更、维修工单、礼品库存、成本策略和财务凭证联动。 建议 Figma Frame：MAT-对账单；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web付款单授权用户围绕采购财务完善付款单的入口、字段、状态、异常提示、处理进度和验收反馈资产库存页采用左侧分类树、顶部仓库/校区筛选、中部台账表格，详情抽屉展示流水、成本、责任人和审计。新增 SKU、采购申请、验收入库、领用出库、调拨、盘点、报损报废、维修派工物料编码、分类、仓库/校区、库存数量、批次成本、供应商、责任人、盘点差异、物料分类、库存状态库存不足、编码重复、入库差异、责任人缺失、维修超期、成本调整失败需覆盖图书仅进销存、固定资产责任人变更、维修工单、礼品库存、成本策略和财务凭证联动。 建议 Figma Frame：MAT-付款单；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。

09 · 页面到接口的前后端闭环矩阵

把原型页面、后端接口、数据对象、状态和消息审批绑定到一起

设计原型时，每个关键页面必须能解释前端展示什么、后端提交什么、状态怎么变、异常怎么处理。
原型页面关键接口关联对象状态流审批/权限触发消息/待办触达原型验收要求
物料档案POST/GET /api/v1/material/purchase-reconciliationsSupplier待入库 -> 在库 -> 已锁定 -> 已出库 -> 调拨中 -> 盘点中 -> 已报废物料采购审批：采购金额超过阈值、跨校区采购或固定资产采购处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
采购入库POST /api/v1/assets/lifecycle-actionsMaterial/Inventory/Asset/Book草稿 -> 待开播 -> 直播中 -> 已结束 -> 回放生成中 -> 可回放 -> 异常 -> 已关闭固定资产报废审批：固定资产、图书或高价值物料需要报废处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
库存台账POST/GET /api/v1/material/purchase-reconciliationsWarehouse未录制 -> 录制中 -> 转码中 -> 可回放 -> 转码失败 -> 已过期 -> 已归档直播供应商配置审批：新增或变更直播供应商密钥、回调地址、录制存储、转码模板和域名配置处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
礼品核销POST /api/v1/assets/lifecycle-actionsInventory在库 -> 领用中 -> 已领用 -> 归还中 -> 调拨中 -> 维修中 -> 盘点中 -> 报废审批 -> 已报废 -> 已丢失物料采购审批：采购金额超过阈值、跨校区采购或固定资产采购处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
采购对账付款POST/GET /api/v1/material/purchase-reconciliationsStockIn询价中 -> 待审批 -> 待下单 -> 待入库 -> 入库差异 -> 待对账 -> 对账不平 -> 待付款 -> 已付款 -> 已退货 -> 已关闭固定资产报废审批：固定资产、图书或高价值物料需要报废处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
固定资产维修与责任人变更POST /api/v1/assets/lifecycle-actionsStockOut草稿 -> 待审核 -> 已启用 -> 已停用 -> 待重算 -> 重算中 -> 已归档直播供应商配置审批：新增或变更直播供应商密钥、回调地址、录制存储、转码模板和域名配置处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
图书进销存POST/GET /api/v1/material/purchase-reconciliationsAsset待派单 -> 已派单 -> 已接单 -> 排查中 -> 待恢复校验 -> 已恢复 -> 已关闭 -> 已升级物料采购审批：采购金额超过阈值、跨校区采购或固定资产采购处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
礼品实物售后处理POST /api/v1/assets/lifecycle-actionsAssetLifecycle/Maintenance待入库 -> 在库 -> 已锁定 -> 已出库 -> 调拨中 -> 盘点中 -> 已报废固定资产报废审批：固定资产、图书或高价值物料需要报废处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
库存成本策略POST/GET /api/v1/material/purchase-reconciliationsSupplier草稿 -> 待开播 -> 直播中 -> 已结束 -> 回放生成中 -> 可回放 -> 异常 -> 已关闭直播供应商配置审批：新增或变更直播供应商密钥、回调地址、录制存储、转码模板和域名配置处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
图书库存POST /api/v1/assets/lifecycle-actionsMaterial/Inventory/Asset/Book未录制 -> 录制中 -> 转码中 -> 可回放 -> 转码失败 -> 已过期 -> 已归档物料采购审批：采购金额超过阈值、跨校区采购或固定资产采购处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
固定资产POST/GET /api/v1/material/purchase-reconciliationsWarehouse在库 -> 领用中 -> 已领用 -> 归还中 -> 调拨中 -> 维修中 -> 盘点中 -> 报废审批 -> 已报废 -> 已丢失固定资产报废审批：固定资产、图书或高价值物料需要报废处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
库存流水POST /api/v1/assets/lifecycle-actionsInventory在库 -> 领用中 -> 已领用 -> 归还中 -> 调拨中 -> 维修中 -> 盘点中 -> 报废审批 -> 已报废 -> 已丢失直播供应商配置审批：新增或变更直播供应商密钥、回调地址、录制存储、转码模板和域名配置处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口

10 · 原型、UI、研发、测试交付补充

把关键闭环补强为下一阶段可执行任务

本章节为正式 PRD 的交付要求，面向原型图、UI、开发、联调和测试分工。
能力域功能补充要求原型交付要求UI 交互要求研发实现要求测试验收要求
进销存范围明确图书仅按库存和资产管理，补齐采购、入库、出库、调拨、盘点、报损、报废。物料档案、图书库存、固定资产、库存流水 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；图书无借阅状态，只有库存和资产生命周期。
积分联动补齐礼品 SKU、库存锁定、核销出库、取消释放、售后返库和积分流水。礼品库存、兑换订单、核销台 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；库存数量、积分账户和核销记录一致。
采购财务补齐采购申请、订单、入库差异、供应商对账、付款审批和凭证联动。采购订单、入库单、对账单、付款单 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；采购入库后可形成库存/资产和财务应付链路。

11 · 数据对象与字段字典

明确页面、接口、数据库共同使用的数据语言

字段涉及敏感、人脸、财务、绩效时，原型需体现脱敏、授权和审计。

核心对象

对象说明
Supplier供应商档案；落地表：mat_supplier
Material/Inventory/Asset/Book物料、固定资产、图书、礼品 SKU；落地表：mat_sku
Warehouse仓库和校区库位；落地表：mat_warehouse
Inventory库存余额；落地表：mat_inventory
StockIn采购入库/退货入库；落地表：mat_stock_in
StockOut领用出库/核销出库；落地表：mat_stock_out
Asset固定资产台账；落地表：mat_asset
AssetLifecycle/Maintenance资产维修与生命周期；落地表：mat_maintenance_order

关联引用对象

对象说明
Organization集团、区域、校区、部门组织树；引用来源：FND / sys_organization
User/Employee统一登录账号；引用来源：FND / sys_user
Employee员工基础档案；引用来源：FND / sys_employee
Role角色定义；引用来源：FND / sys_role
ApprovalFlow审批流配置；引用来源：FND / sys_approval_flow
MessageTemplate消息模板与多端触达配置；引用来源：FND / sys_message_template
AuditLog全平台操作审计日志；引用来源：FND / sys_audit_log
IntegrationLog接口调用日志；引用来源：OPEN / int_integration_log
SensitiveFieldPolicy敏感字段脱敏策略；引用来源：SEC / sec_sensitive_field_policy
FinanceVoucher会计凭证；引用来源：FIN / fin_voucher
PointsOrder积分商城兑换订单；引用来源：APP / pts_order
PointsRedemptionAfterSales积分兑换售后；引用来源：APP / pts_after_sales
ClassroomCamera教室摄像头设备清单；引用来源：PAT / video_classroom_camera
FaceDevice人脸识别考勤设备；引用来源：FAC / dev_face_device
TVDevice安卓 TV 教学端设备；引用来源：TTV / tv_device

完整字段字典

对象字段类型必填规则数据级别
SupplieridBIGINT是主键，雪花或号段生成，禁止复用普通
Suppliertenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
Supplierorg_idBIGINT否所属组织，集团级或公共配置为空普通
Suppliercampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
Suppliercreated_byBIGINT是创建人账号 ID普通
Suppliercreated_atDATETIME是创建时间普通
Supplierupdated_byBIGINT否最后更新人账号 ID普通
Supplierupdated_atDATETIME否最后更新时间普通
Supplieris_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
Supplierdeleted_atDATETIME否删除时间，未删除为空普通
Supplierdeleted_byBIGINT否删除人账号 ID，未删除为空普通
SupplierversionINT是乐观锁版本号，写操作必须校验普通
Suppliersupplier_codeVARCHAR(64)是供应商编码，唯一普通
Suppliersupplier_nameVARCHAR(128)是供应商名称普通
Suppliercontact_nameVARCHAR(64)否联系人普通
Suppliercontact_mobileVARCHAR(32)否联系人手机，敏感敏感
Suppliersettlement_ruleJSON否结算规则普通
SupplierenabledTINYINT是是否启用普通
Material/Inventory/Asset/BookidBIGINT是主键，雪花或号段生成，禁止复用普通
Material/Inventory/Asset/Booktenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
Material/Inventory/Asset/Bookorg_idBIGINT否所属组织，集团级或公共配置为空普通
Material/Inventory/Asset/Bookcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
Material/Inventory/Asset/Bookcreated_byBIGINT是创建人账号 ID普通
Material/Inventory/Asset/Bookcreated_atDATETIME是创建时间普通
Material/Inventory/Asset/Bookupdated_byBIGINT否最后更新人账号 ID普通
Material/Inventory/Asset/Bookupdated_atDATETIME否最后更新时间普通
Material/Inventory/Asset/Bookis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
Material/Inventory/Asset/Bookdeleted_atDATETIME否删除时间，未删除为空普通
Material/Inventory/Asset/Bookdeleted_byBIGINT否删除人账号 ID，未删除为空普通
Material/Inventory/Asset/BookversionINT是乐观锁版本号，写操作必须校验普通
Material/Inventory/Asset/Booksku_codeVARCHAR(64)是SKU 编码，唯一普通
Material/Inventory/Asset/Booksku_nameVARCHAR(128)是SKU 名称普通
Material/Inventory/Asset/Booksku_typeVARCHAR(32)是物料/固定资产/图书/积分礼品普通
Material/Inventory/Asset/BookunitVARCHAR(16)是计量单位普通
Material/Inventory/Asset/Bookgift_pointsINT否作为积分礼品时所需积分普通
Material/Inventory/Asset/BookenabledTINYINT是是否启用普通
WarehouseidBIGINT是主键，雪花或号段生成，禁止复用普通
Warehousetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
Warehouseorg_idBIGINT否所属组织，集团级或公共配置为空普通
Warehousecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
Warehousecreated_byBIGINT是创建人账号 ID普通
Warehousecreated_atDATETIME是创建时间普通
Warehouseupdated_byBIGINT否最后更新人账号 ID普通
Warehouseupdated_atDATETIME否最后更新时间普通
Warehouseis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
Warehousedeleted_atDATETIME否删除时间，未删除为空普通
Warehousedeleted_byBIGINT否删除人账号 ID，未删除为空普通
WarehouseversionINT是乐观锁版本号，写操作必须校验普通
Warehousewarehouse_codeVARCHAR(64)是仓库编码，唯一普通
Warehousewarehouse_nameVARCHAR(128)是仓库名称普通
Warehousewarehouse_typeVARCHAR(32)是总部仓/校区仓/礼品仓/图书仓普通
Warehousemanager_idBIGINT否仓库负责人普通
WarehouseenabledTINYINT是是否启用普通
InventoryidBIGINT是主键，雪花或号段生成，禁止复用普通
Inventorytenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
Inventoryorg_idBIGINT否所属组织，集团级或公共配置为空普通
Inventorycampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
Inventorycreated_byBIGINT是创建人账号 ID普通
Inventorycreated_atDATETIME是创建时间普通
Inventoryupdated_byBIGINT否最后更新人账号 ID普通
Inventoryupdated_atDATETIME否最后更新时间普通
Inventoryis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
Inventorydeleted_atDATETIME否删除时间，未删除为空普通
Inventorydeleted_byBIGINT否删除人账号 ID，未删除为空普通
InventoryversionINT是乐观锁版本号，写操作必须校验普通
Inventorysku_idBIGINT是SKU ID普通
Inventorywarehouse_idBIGINT是仓库 ID普通
Inventoryavailable_qtyDECIMAL(18,2)是可用库存普通
Inventorylocked_qtyDECIMAL(18,2)是锁定库存普通
Inventoryin_transit_qtyDECIMAL(18,2)是在途库存普通
Inventorycost_amountDECIMAL(18,2)否库存成本普通
StockInidBIGINT是主键，雪花或号段生成，禁止复用普通
StockIntenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
StockInorg_idBIGINT否所属组织，集团级或公共配置为空普通
StockIncampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
StockIncreated_byBIGINT是创建人账号 ID普通
StockIncreated_atDATETIME是创建时间普通
StockInupdated_byBIGINT否最后更新人账号 ID普通
StockInupdated_atDATETIME否最后更新时间普通
StockInis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
StockIndeleted_atDATETIME否删除时间，未删除为空普通
StockIndeleted_byBIGINT否删除人账号 ID，未删除为空普通
StockInversionINT是乐观锁版本号，写操作必须校验普通
StockInstock_in_noVARCHAR(64)是入库单编号，唯一普通
StockInwarehouse_idBIGINT是入库仓库普通
StockInsupplier_idBIGINT否供应商 ID普通
StockInsource_biz_noVARCHAR(64)否来源单号普通
StockInline_itemsJSON是入库明细普通
StockInstock_in_statusVARCHAR(32)是草稿/待审核/已入库/已作废普通
StockInapproval_statusVARCHAR(32)否审批状态，未发起为空普通
StockInapproval_instance_idBIGINT否关联审批实例 ID普通
StockOutidBIGINT是主键，雪花或号段生成，禁止复用普通
StockOuttenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
StockOutorg_idBIGINT否所属组织，集团级或公共配置为空普通
StockOutcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
StockOutcreated_byBIGINT是创建人账号 ID普通
StockOutcreated_atDATETIME是创建时间普通
StockOutupdated_byBIGINT否最后更新人账号 ID普通
StockOutupdated_atDATETIME否最后更新时间普通
StockOutis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
StockOutdeleted_atDATETIME否删除时间，未删除为空普通
StockOutdeleted_byBIGINT否删除人账号 ID，未删除为空普通
StockOutversionINT是乐观锁版本号，写操作必须校验普通
StockOutstock_out_noVARCHAR(64)是出库单编号，唯一普通
StockOutwarehouse_idBIGINT是出库仓库普通
StockOutuse_sceneVARCHAR(32)是教学/办公/积分兑换/报损/调拨普通
StockOutsource_biz_noVARCHAR(64)否来源单号普通
StockOutline_itemsJSON是出库明细普通
StockOutstock_out_statusVARCHAR(32)是草稿/待审核/已出库/已作废普通
StockOutapproval_statusVARCHAR(32)否审批状态，未发起为空普通
StockOutapproval_instance_idBIGINT否关联审批实例 ID普通
AssetidBIGINT是主键，雪花或号段生成，禁止复用普通
Assettenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
Assetorg_idBIGINT否所属组织，集团级或公共配置为空普通
Assetcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
Assetcreated_byBIGINT是创建人账号 ID普通
Assetcreated_atDATETIME是创建时间普通
Assetupdated_byBIGINT否最后更新人账号 ID普通
Assetupdated_atDATETIME否最后更新时间普通
Assetis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
Assetdeleted_atDATETIME否删除时间，未删除为空普通
Assetdeleted_byBIGINT否删除人账号 ID，未删除为空普通
AssetversionINT是乐观锁版本号，写操作必须校验普通
Assetasset_noVARCHAR(64)是资产编号，唯一普通
Assetsku_idBIGINT是资产 SKU普通
Assetowner_org_idBIGINT否归属组织普通
Assetkeeper_idBIGINT否保管人普通
Assetpurchase_dateDATE否购置日期普通
Assetasset_statusVARCHAR(32)是在用/闲置/维修/报废/调拨中普通
AssetLifecycle/MaintenanceidBIGINT是主键，雪花或号段生成，禁止复用普通
AssetLifecycle/Maintenancetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
AssetLifecycle/Maintenanceorg_idBIGINT否所属组织，集团级或公共配置为空普通
AssetLifecycle/Maintenancecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
AssetLifecycle/Maintenancecreated_byBIGINT是创建人账号 ID普通
AssetLifecycle/Maintenancecreated_atDATETIME是创建时间普通
AssetLifecycle/Maintenanceupdated_byBIGINT否最后更新人账号 ID普通
AssetLifecycle/Maintenanceupdated_atDATETIME否最后更新时间普通
AssetLifecycle/Maintenanceis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
AssetLifecycle/Maintenancedeleted_atDATETIME否删除时间，未删除为空普通
AssetLifecycle/Maintenancedeleted_byBIGINT否删除人账号 ID，未删除为空普通
AssetLifecycle/MaintenanceversionINT是乐观锁版本号，写操作必须校验普通
AssetLifecycle/Maintenancemaintenance_noVARCHAR(64)是维修单编号，唯一普通
AssetLifecycle/Maintenanceasset_idBIGINT是资产 ID普通
AssetLifecycle/Maintenancefault_descVARCHAR(512)是故障描述普通
AssetLifecycle/Maintenancerepair_vendor_idBIGINT否维修供应商普通
AssetLifecycle/Maintenancerepair_amountDECIMAL(18,2)否维修金额普通
AssetLifecycle/Maintenancemaintenance_statusVARCHAR(32)是待维修/维修中/已完成/已报废普通

引用对象字段字典

引用表对象字段类型必填规则数据级别
sys_organizationOrganizationidBIGINT是主键，雪花或号段生成，禁止复用普通
sys_organizationOrganizationtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sys_organizationOrganizationorg_idBIGINT否所属组织，集团级或公共配置为空普通
sys_organizationOrganizationcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sys_organizationOrganizationcreated_byBIGINT是创建人账号 ID普通
sys_organizationOrganizationcreated_atDATETIME是创建时间普通
sys_organizationOrganizationupdated_byBIGINT否最后更新人账号 ID普通
sys_organizationOrganizationupdated_atDATETIME否最后更新时间普通
sys_organizationOrganizationis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sys_organizationOrganizationdeleted_atDATETIME否删除时间，未删除为空普通
sys_organizationOrganizationdeleted_byBIGINT否删除人账号 ID，未删除为空普通
sys_organizationOrganizationversionINT是乐观锁版本号，写操作必须校验普通
sys_organizationOrganizationorg_codeVARCHAR(64)是组织编码，租户内唯一普通
sys_organizationOrganizationorg_nameVARCHAR(128)是组织名称普通
sys_organizationOrganizationorg_typeVARCHAR(32)是集团/区域/校区/部门/法人主体普通
sys_organizationOrganizationparent_idBIGINT否上级组织 ID，根节点为空普通
sys_organizationOrganizationsort_noINT否同级排序普通
sys_organizationOrganizationenabledTINYINT是是否启用普通
sys_userUser/EmployeeidBIGINT是主键，雪花或号段生成，禁止复用普通
sys_userUser/Employeetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sys_userUser/Employeeorg_idBIGINT否所属组织，集团级或公共配置为空普通
sys_userUser/Employeecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sys_userUser/Employeecreated_byBIGINT是创建人账号 ID普通
sys_userUser/Employeecreated_atDATETIME是创建时间普通
sys_userUser/Employeeupdated_byBIGINT否最后更新人账号 ID普通
sys_userUser/Employeeupdated_atDATETIME否最后更新时间普通
sys_userUser/Employeeis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sys_userUser/Employeedeleted_atDATETIME否删除时间，未删除为空普通
sys_userUser/Employeedeleted_byBIGINT否删除人账号 ID，未删除为空普通
sys_userUser/EmployeeversionINT是乐观锁版本号，写操作必须校验普通
sys_userUser/Employeeuser_noVARCHAR(64)是账号编号，唯一普通
sys_userUser/Employeelogin_nameVARCHAR(64)是登录名，唯一普通
sys_userUser/EmployeemobileVARCHAR(32)否手机号，敏感脱敏展示敏感
sys_userUser/Employeepassword_hashVARCHAR(255)否密码哈希，禁止前端返回高敏
sys_userUser/Employeeuser_typeVARCHAR(32)是员工/学员/家长/外部账号普通
sys_userUser/Employeelogin_statusVARCHAR(32)是正常/锁定/停用/待激活普通
sys_employeeEmployeeidBIGINT是主键，雪花或号段生成，禁止复用普通
sys_employeeEmployeetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sys_employeeEmployeeorg_idBIGINT否所属组织，集团级或公共配置为空普通
sys_employeeEmployeecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sys_employeeEmployeecreated_byBIGINT是创建人账号 ID普通
sys_employeeEmployeecreated_atDATETIME是创建时间普通
sys_employeeEmployeeupdated_byBIGINT否最后更新人账号 ID普通
sys_employeeEmployeeupdated_atDATETIME否最后更新时间普通
sys_employeeEmployeeis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sys_employeeEmployeedeleted_atDATETIME否删除时间，未删除为空普通
sys_employeeEmployeedeleted_byBIGINT否删除人账号 ID，未删除为空普通
sys_employeeEmployeeversionINT是乐观锁版本号，写操作必须校验普通
sys_employeeEmployeeemployee_noVARCHAR(64)是工号，唯一普通
sys_employeeEmployeeuser_idBIGINT否关联账号 ID普通
sys_employeeEmployeeemployee_nameVARCHAR(64)是员工姓名普通
sys_employeeEmployeeprimary_campus_idBIGINT否主校区 ID普通
sys_employeeEmployeejob_titleVARCHAR(64)否岗位名称普通
sys_employeeEmployeehire_statusVARCHAR(32)是在职/试用/离职/停用普通
sys_roleRoleidBIGINT是主键，雪花或号段生成，禁止复用普通
sys_roleRoletenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sys_roleRoleorg_idBIGINT否所属组织，集团级或公共配置为空普通
sys_roleRolecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sys_roleRolecreated_byBIGINT是创建人账号 ID普通
sys_roleRolecreated_atDATETIME是创建时间普通
sys_roleRoleupdated_byBIGINT否最后更新人账号 ID普通
sys_roleRoleupdated_atDATETIME否最后更新时间普通
sys_roleRoleis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sys_roleRoledeleted_atDATETIME否删除时间，未删除为空普通
sys_roleRoledeleted_byBIGINT否删除人账号 ID，未删除为空普通
sys_roleRoleversionINT是乐观锁版本号，写操作必须校验普通
sys_roleRolerole_codeVARCHAR(64)是角色编码，唯一普通
sys_roleRolerole_nameVARCHAR(128)是角色名称普通
sys_roleRolerole_levelVARCHAR(32)是总部/区域/校区/个人普通
sys_roleRoledata_scope_typeVARCHAR(32)是数据范围类型普通
sys_roleRoleenabledTINYINT是是否启用普通
sys_approval_flowApprovalFlowidBIGINT是主键，雪花或号段生成，禁止复用普通
sys_approval_flowApprovalFlowtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sys_approval_flowApprovalFloworg_idBIGINT否所属组织，集团级或公共配置为空普通
sys_approval_flowApprovalFlowcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sys_approval_flowApprovalFlowcreated_byBIGINT是创建人账号 ID普通
sys_approval_flowApprovalFlowcreated_atDATETIME是创建时间普通
sys_approval_flowApprovalFlowupdated_byBIGINT否最后更新人账号 ID普通
sys_approval_flowApprovalFlowupdated_atDATETIME否最后更新时间普通
sys_approval_flowApprovalFlowis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sys_approval_flowApprovalFlowdeleted_atDATETIME否删除时间，未删除为空普通
sys_approval_flowApprovalFlowdeleted_byBIGINT否删除人账号 ID，未删除为空普通
sys_approval_flowApprovalFlowversionINT是乐观锁版本号，写操作必须校验普通
sys_approval_flowApprovalFlowflow_codeVARCHAR(64)是审批流编码，唯一普通
sys_approval_flowApprovalFlowbiz_typeVARCHAR(64)是业务类型普通
sys_approval_flowApprovalFlowflow_nameVARCHAR(128)是审批流名称普通
sys_approval_flowApprovalFlowcondition_jsonJSON否触发条件普通
sys_approval_flowApprovalFlownode_jsonJSON是节点、审批人和超时规则普通
sys_approval_flowApprovalFlowversion_noINT是审批流版本号普通
sys_approval_flowApprovalFlowenabledTINYINT是是否启用普通
sys_message_templateMessageTemplateidBIGINT是主键，雪花或号段生成，禁止复用普通
sys_message_templateMessageTemplatetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sys_message_templateMessageTemplateorg_idBIGINT否所属组织，集团级或公共配置为空普通
sys_message_templateMessageTemplatecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sys_message_templateMessageTemplatecreated_byBIGINT是创建人账号 ID普通
sys_message_templateMessageTemplatecreated_atDATETIME是创建时间普通
sys_message_templateMessageTemplateupdated_byBIGINT否最后更新人账号 ID普通
sys_message_templateMessageTemplateupdated_atDATETIME否最后更新时间普通
sys_message_templateMessageTemplateis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sys_message_templateMessageTemplatedeleted_atDATETIME否删除时间，未删除为空普通
sys_message_templateMessageTemplatedeleted_byBIGINT否删除人账号 ID，未删除为空普通
sys_message_templateMessageTemplateversionINT是乐观锁版本号，写操作必须校验普通
sys_message_templateMessageTemplatetemplate_codeVARCHAR(64)是模板编码，唯一普通
sys_message_templateMessageTemplatetemplate_nameVARCHAR(128)是模板名称普通
sys_message_templateMessageTemplatechannelVARCHAR(32)是站内信/短信/微信小程序/企微/Push普通
sys_message_templateMessageTemplatereceiver_ruleJSON是接收人规则普通
sys_message_templateMessageTemplatecontent_templateTEXT是模板内容普通
sys_message_templateMessageTemplateenabledTINYINT是是否启用普通
sys_audit_logAuditLogidBIGINT是主键，雪花或号段生成，禁止复用普通
sys_audit_logAuditLogtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sys_audit_logAuditLogorg_idBIGINT否所属组织，集团级或公共配置为空普通
sys_audit_logAuditLogcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sys_audit_logAuditLogcreated_byBIGINT是创建人账号 ID普通
sys_audit_logAuditLogcreated_atDATETIME是创建时间普通
sys_audit_logAuditLogupdated_byBIGINT否最后更新人账号 ID普通
sys_audit_logAuditLogupdated_atDATETIME否最后更新时间普通
sys_audit_logAuditLogis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sys_audit_logAuditLogdeleted_atDATETIME否删除时间，未删除为空普通
sys_audit_logAuditLogdeleted_byBIGINT否删除人账号 ID，未删除为空普通
sys_audit_logAuditLogversionINT是乐观锁版本号，写操作必须校验普通
sys_audit_logAuditLogoperator_idBIGINT是操作人 ID普通
sys_audit_logAuditLogbiz_typeVARCHAR(64)是业务类型普通
sys_audit_logAuditLogbiz_idBIGINT否业务主键 ID普通
sys_audit_logAuditLogaction_codeVARCHAR(64)是操作编码普通
sys_audit_logAuditLogbefore_snapshotJSON否变更前快照普通
sys_audit_logAuditLogafter_snapshotJSON否变更后快照普通
sys_audit_logAuditLogip_addressVARCHAR(64)否操作 IP普通
int_integration_logIntegrationLogidBIGINT是主键，雪花或号段生成，禁止复用普通
int_integration_logIntegrationLogtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
int_integration_logIntegrationLogorg_idBIGINT否所属组织，集团级或公共配置为空普通
int_integration_logIntegrationLogcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
int_integration_logIntegrationLogcreated_byBIGINT是创建人账号 ID普通
int_integration_logIntegrationLogcreated_atDATETIME是创建时间普通
int_integration_logIntegrationLogupdated_byBIGINT否最后更新人账号 ID普通
int_integration_logIntegrationLogupdated_atDATETIME否最后更新时间普通
int_integration_logIntegrationLogis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
int_integration_logIntegrationLogdeleted_atDATETIME否删除时间，未删除为空普通
int_integration_logIntegrationLogdeleted_byBIGINT否删除人账号 ID，未删除为空普通
int_integration_logIntegrationLogversionINT是乐观锁版本号，写操作必须校验普通
int_integration_logIntegrationLogrequest_idVARCHAR(128)是请求 ID，幂等键普通
int_integration_logIntegrationLogsystem_codeVARCHAR(64)是外部系统编码普通
int_integration_logIntegrationLogapi_pathVARCHAR(512)是接口路径普通
int_integration_logIntegrationLogbiz_typeVARCHAR(64)否业务类型普通
int_integration_logIntegrationLogbiz_idBIGINT否业务 ID普通
int_integration_logIntegrationLogrequest_payloadJSON否请求报文，敏感字段脱敏敏感
int_integration_logIntegrationLogresponse_payloadJSON否响应报文普通
int_integration_logIntegrationLogcall_statusVARCHAR(32)是成功/失败/超时/重试中普通
sec_sensitive_field_policySensitiveFieldPolicyidBIGINT是主键，雪花或号段生成，禁止复用普通
sec_sensitive_field_policySensitiveFieldPolicytenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sec_sensitive_field_policySensitiveFieldPolicyorg_idBIGINT否所属组织，集团级或公共配置为空普通
sec_sensitive_field_policySensitiveFieldPolicycampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sec_sensitive_field_policySensitiveFieldPolicycreated_byBIGINT是创建人账号 ID普通
sec_sensitive_field_policySensitiveFieldPolicycreated_atDATETIME是创建时间普通
sec_sensitive_field_policySensitiveFieldPolicyupdated_byBIGINT否最后更新人账号 ID普通
sec_sensitive_field_policySensitiveFieldPolicyupdated_atDATETIME否最后更新时间普通
sec_sensitive_field_policySensitiveFieldPolicyis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sec_sensitive_field_policySensitiveFieldPolicydeleted_atDATETIME否删除时间，未删除为空普通
sec_sensitive_field_policySensitiveFieldPolicydeleted_byBIGINT否删除人账号 ID，未删除为空普通
sec_sensitive_field_policySensitiveFieldPolicyversionINT是乐观锁版本号，写操作必须校验普通
sec_sensitive_field_policySensitiveFieldPolicyfield_codeVARCHAR(128)是字段编码，唯一普通
sec_sensitive_field_policySensitiveFieldPolicybiz_typeVARCHAR(64)是业务类型普通
sec_sensitive_field_policySensitiveFieldPolicymask_ruleVARCHAR(64)是脱敏规则普通
sec_sensitive_field_policySensitiveFieldPolicyview_requires_approvalTINYINT是明文查看是否需审批普通
sec_sensitive_field_policySensitiveFieldPolicywatermark_requiredTINYINT是是否加水印普通
fin_voucherFinanceVoucheridBIGINT是主键，雪花或号段生成，禁止复用普通
fin_voucherFinanceVouchertenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
fin_voucherFinanceVoucherorg_idBIGINT否所属组织，集团级或公共配置为空普通
fin_voucherFinanceVouchercampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
fin_voucherFinanceVouchercreated_byBIGINT是创建人账号 ID普通
fin_voucherFinanceVouchercreated_atDATETIME是创建时间普通
fin_voucherFinanceVoucherupdated_byBIGINT否最后更新人账号 ID普通
fin_voucherFinanceVoucherupdated_atDATETIME否最后更新时间普通
fin_voucherFinanceVoucheris_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
fin_voucherFinanceVoucherdeleted_atDATETIME否删除时间，未删除为空普通
fin_voucherFinanceVoucherdeleted_byBIGINT否删除人账号 ID，未删除为空普通
fin_voucherFinanceVoucherversionINT是乐观锁版本号，写操作必须校验普通
fin_voucherFinanceVouchervoucher_noVARCHAR(64)是凭证编号，账套期间内唯一普通
fin_voucherFinanceVoucheraccount_set_idBIGINT是账套 ID普通
fin_voucherFinanceVoucherperiod_codeVARCHAR(32)是会计期间普通
fin_voucherFinanceVouchersource_biz_typeVARCHAR(64)否来源业务类型普通
fin_voucherFinanceVouchersource_biz_noVARCHAR(64)否来源业务编号普通
fin_voucherFinanceVouchervoucher_statusVARCHAR(32)是草稿/待审核/已审核/已过账/已红冲普通
fin_voucherFinanceVoucherapproval_statusVARCHAR(32)否审批状态，未发起为空普通
fin_voucherFinanceVoucherapproval_instance_idBIGINT否关联审批实例 ID普通
pts_orderPointsOrderidBIGINT是主键，雪花或号段生成，禁止复用普通
pts_orderPointsOrdertenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
pts_orderPointsOrderorg_idBIGINT否所属组织，集团级或公共配置为空普通
pts_orderPointsOrdercampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
pts_orderPointsOrdercreated_byBIGINT是创建人账号 ID普通
pts_orderPointsOrdercreated_atDATETIME是创建时间普通
pts_orderPointsOrderupdated_byBIGINT否最后更新人账号 ID普通
pts_orderPointsOrderupdated_atDATETIME否最后更新时间普通
pts_orderPointsOrderis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
pts_orderPointsOrderdeleted_atDATETIME否删除时间，未删除为空普通
pts_orderPointsOrderdeleted_byBIGINT否删除人账号 ID，未删除为空普通
pts_orderPointsOrderversionINT是乐观锁版本号，写操作必须校验普通
pts_orderPointsOrderorder_noVARCHAR(64)是积分订单编号，唯一普通
pts_orderPointsOrderstudent_idBIGINT是学员 ID普通
pts_orderPointsOrdergift_sku_idBIGINT是礼品 SKU ID，关联物料普通
pts_orderPointsOrderlock_idBIGINT否积分锁库记录 ID普通
pts_orderPointsOrderpoints_amountINT是消耗积分普通
pts_orderPointsOrderwrite_off_code_idBIGINT否核销码 ID普通
pts_orderPointsOrderorder_statusVARCHAR(32)是待领取/已核销/已取消/售后中普通
pts_after_salesPointsRedemptionAfterSalesidBIGINT是主键，雪花或号段生成，禁止复用普通
pts_after_salesPointsRedemptionAfterSalestenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
pts_after_salesPointsRedemptionAfterSalesorg_idBIGINT否所属组织，集团级或公共配置为空普通
pts_after_salesPointsRedemptionAfterSalescampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
pts_after_salesPointsRedemptionAfterSalescreated_byBIGINT是创建人账号 ID普通
pts_after_salesPointsRedemptionAfterSalescreated_atDATETIME是创建时间普通
pts_after_salesPointsRedemptionAfterSalesupdated_byBIGINT否最后更新人账号 ID普通
pts_after_salesPointsRedemptionAfterSalesupdated_atDATETIME否最后更新时间普通
pts_after_salesPointsRedemptionAfterSalesis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
pts_after_salesPointsRedemptionAfterSalesdeleted_atDATETIME否删除时间，未删除为空普通
pts_after_salesPointsRedemptionAfterSalesdeleted_byBIGINT否删除人账号 ID，未删除为空普通
pts_after_salesPointsRedemptionAfterSalesversionINT是乐观锁版本号，写操作必须校验普通
pts_after_salesPointsRedemptionAfterSalesafter_sales_noVARCHAR(64)是售后编号，唯一普通
pts_after_salesPointsRedemptionAfterSalespoints_order_idBIGINT是积分订单 ID普通
pts_after_salesPointsRedemptionAfterSalesrequest_typeVARCHAR(32)是取消/退积分/补发/异常核销普通
pts_after_salesPointsRedemptionAfterSalesrequest_reasonVARCHAR(512)是申请原因普通
pts_after_salesPointsRedemptionAfterSaleshandle_resultVARCHAR(512)否处理结果普通
pts_after_salesPointsRedemptionAfterSaleshandle_statusVARCHAR(32)是待处理/已处理/已驳回普通
video_classroom_cameraClassroomCameraidBIGINT是主键，雪花或号段生成，禁止复用普通
video_classroom_cameraClassroomCameratenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
video_classroom_cameraClassroomCameraorg_idBIGINT否所属组织，集团级或公共配置为空普通
video_classroom_cameraClassroomCameracampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
video_classroom_cameraClassroomCameracreated_byBIGINT是创建人账号 ID普通
video_classroom_cameraClassroomCameracreated_atDATETIME是创建时间普通
video_classroom_cameraClassroomCameraupdated_byBIGINT否最后更新人账号 ID普通
video_classroom_cameraClassroomCameraupdated_atDATETIME否最后更新时间普通
video_classroom_cameraClassroomCamerais_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
video_classroom_cameraClassroomCameradeleted_atDATETIME否删除时间，未删除为空普通
video_classroom_cameraClassroomCameradeleted_byBIGINT否删除人账号 ID，未删除为空普通
video_classroom_cameraClassroomCameraversionINT是乐观锁版本号，写操作必须校验普通
video_classroom_cameraClassroomCameracamera_codeVARCHAR(64)是摄像头编码，唯一普通
video_classroom_cameraClassroomCameracamera_nameVARCHAR(128)是摄像头名称普通
video_classroom_cameraClassroomCameraplatform_idBIGINT是所属视频平台普通
video_classroom_cameraClassroomCameragateway_idBIGINT否门店网关 ID普通
video_classroom_cameraClassroomCameraclassroom_idBIGINT否教室 ID普通
video_classroom_cameraClassroomCamerastream_addressVARCHAR(512)否直播流地址普通
video_classroom_cameraClassroomCameracamera_statusVARCHAR(32)是在线/离线/停用/异常普通
dev_face_deviceFaceDeviceidBIGINT是主键，雪花或号段生成，禁止复用普通
dev_face_deviceFaceDevicetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
dev_face_deviceFaceDeviceorg_idBIGINT否所属组织，集团级或公共配置为空普通
dev_face_deviceFaceDevicecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
dev_face_deviceFaceDevicecreated_byBIGINT是创建人账号 ID普通
dev_face_deviceFaceDevicecreated_atDATETIME是创建时间普通
dev_face_deviceFaceDeviceupdated_byBIGINT否最后更新人账号 ID普通
dev_face_deviceFaceDeviceupdated_atDATETIME否最后更新时间普通
dev_face_deviceFaceDeviceis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
dev_face_deviceFaceDevicedeleted_atDATETIME否删除时间，未删除为空普通
dev_face_deviceFaceDevicedeleted_byBIGINT否删除人账号 ID，未删除为空普通
dev_face_deviceFaceDeviceversionINT是乐观锁版本号，写操作必须校验普通
dev_face_deviceFaceDevicedevice_codeVARCHAR(64)是设备编码，唯一普通
dev_face_deviceFaceDevicevendor_codeVARCHAR(32)是设备品牌/厂商普通
dev_face_deviceFaceDevicedevice_nameVARCHAR(128)是设备名称普通
dev_face_deviceFaceDeviceclassroom_idBIGINT否绑定教室 ID普通
dev_face_deviceFaceDeviceapi_endpointVARCHAR(512)否设备或平台 API 地址普通
dev_face_deviceFaceDevicedevice_statusVARCHAR(32)是在线/离线/停用/异常普通
tv_deviceTVDeviceidBIGINT是主键，雪花或号段生成，禁止复用普通
tv_deviceTVDevicetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
tv_deviceTVDeviceorg_idBIGINT否所属组织，集团级或公共配置为空普通
tv_deviceTVDevicecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
tv_deviceTVDevicecreated_byBIGINT是创建人账号 ID普通
tv_deviceTVDevicecreated_atDATETIME是创建时间普通
tv_deviceTVDeviceupdated_byBIGINT否最后更新人账号 ID普通
tv_deviceTVDeviceupdated_atDATETIME否最后更新时间普通
tv_deviceTVDeviceis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
tv_deviceTVDevicedeleted_atDATETIME否删除时间，未删除为空普通
tv_deviceTVDevicedeleted_byBIGINT否删除人账号 ID，未删除为空普通
tv_deviceTVDeviceversionINT是乐观锁版本号，写操作必须校验普通
tv_deviceTVDevicedevice_codeVARCHAR(64)是TV 设备编码，唯一普通
tv_deviceTVDeviceclassroom_idBIGINT是绑定教室 ID普通
tv_deviceTVDeviceapp_versionVARCHAR(32)是应用版本普通
tv_deviceTVDevicedevice_statusVARCHAR(32)是在线/离线/停用/异常普通
tv_deviceTVDeviceheartbeat_atDATETIME否最近心跳普通
tv_deviceTVDevicefocus_modeVARCHAR(32)否遥控器焦点模式普通

JSON 字段结构与校验

表名对象字段结构编码结构定义校验规则示例
mat_supplierSuppliersettlement_ruleINVENTORY_LINES[{skuId:number, warehouseId:number, qty:number, unitCost:number, batchNo?:string, sourceBizNo?:string}]数量必须大于 0；成本策略按物料配置计算[{"skuId":501,"warehouseId":9,"qty":10,"unitCost":12.5}]
mat_stock_inStockInline_itemsINVENTORY_LINES[{skuId:number, warehouseId:number, qty:number, unitCost:number, batchNo?:string, sourceBizNo?:string}]数量必须大于 0；成本策略按物料配置计算[{"skuId":501,"warehouseId":9,"qty":10,"unitCost":12.5}]
mat_stock_outStockOutline_itemsINVENTORY_LINES[{skuId:number, warehouseId:number, qty:number, unitCost:number, batchNo?:string, sourceBizNo?:string}]数量必须大于 0；成本策略按物料配置计算[{"skuId":501,"warehouseId":9,"qty":10,"unitCost":12.5}]

状态/枚举标准字典

表名对象字段枚举编码取值终态/流转规则字段说明
mat_supplierSuppliertenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
mat_supplierSupplieris_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
mat_supplierSupplierenabledENABLED_STATUS0 停用、1 启用非终态，可按状态机或字典规则流转是否启用
mat_skuMaterial/Inventory/Asset/Booktenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
mat_skuMaterial/Inventory/Asset/Bookis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
mat_skuMaterial/Inventory/Asset/Booksku_typeSKU_TYPE物料、固定资产、图书、积分礼品非终态，可按状态机或字典规则流转物料/固定资产/图书/积分礼品
mat_skuMaterial/Inventory/Asset/BookenabledENABLED_STATUS0 停用、1 启用非终态，可按状态机或字典规则流转是否启用
mat_warehouseWarehousetenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
mat_warehouseWarehouseis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
mat_warehouseWarehousewarehouse_typeWAREHOUSE_TYPE总部仓、校区仓、礼品仓、图书仓非终态，可按状态机或字典规则流转总部仓/校区仓/礼品仓/图书仓
mat_warehouseWarehouseenabledENABLED_STATUS0 停用、1 启用非终态，可按状态机或字典规则流转是否启用
mat_inventoryInventorytenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
mat_inventoryInventoryis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
mat_stock_inStockIntenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
mat_stock_inStockInis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
mat_stock_inStockInstock_in_statusSTOCK_IN_STATUS草稿、待审核、已入库、已作废包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程草稿/待审核/已入库/已作废
mat_stock_inStockInapproval_statusAPPROVAL_STATUSNOT_STARTED 未发起、PENDING 审批中、APPROVED 已通过、REJECTED 已驳回、REVOKED 已撤回非终态，可按状态机或字典规则流转审批状态，未发起为空
mat_stock_outStockOuttenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
mat_stock_outStockOutis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
mat_stock_outStockOutuse_sceneUSE_SCENE教学、办公、积分兑换、报损、调拨非终态，可按状态机或字典规则流转教学/办公/积分兑换/报损/调拨
mat_stock_outStockOutstock_out_statusSTOCK_OUT_STATUS草稿、待审核、已出库、已作废包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程草稿/待审核/已出库/已作废
mat_stock_outStockOutapproval_statusAPPROVAL_STATUSNOT_STARTED 未发起、PENDING 审批中、APPROVED 已通过、REJECTED 已驳回、REVOKED 已撤回非终态，可按状态机或字典规则流转审批状态，未发起为空
mat_assetAssettenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
mat_assetAssetis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
mat_assetAssetasset_statusASSET_STATUS在用、闲置、维修、报废、调拨中非终态，可按状态机或字典规则流转在用/闲置/维修/报废/调拨中
mat_maintenance_orderAssetLifecycle/Maintenancetenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
mat_maintenance_orderAssetLifecycle/Maintenanceis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
mat_maintenance_orderAssetLifecycle/Maintenancemaintenance_statusMAINTENANCE_STATUS待维修、维修中、已完成、已报废非终态，可按状态机或字典规则流转待维修/维修中/已完成/已报废

敏感字段与数据安全策略

来源表名对象字段数据级别脱敏/返回策略明文查看条件导出策略审计要求端侧展示规则
本模块对象mat_supplierSuppliercontact_mobile敏感MOBILE_MASK默认展示 138****0000；明文查看需字段权限或敏感字段查看审批导出手机号必须触发导出审批、下载水印和有效期控制明文查看、复制、导出和批量下载均写入 SensitiveAccessLogPC 管理端按字段权限展示；移动端仅展示本人授权范围内脱敏信息
引用对象sys_userUser/Employeemobile敏感MOBILE_MASK默认展示 138****0000；明文查看需字段权限或敏感字段查看审批导出手机号必须触发导出审批、下载水印和有效期控制明文查看、复制、导出和批量下载均写入 SensitiveAccessLogPC 管理端按字段权限展示；移动端仅展示本人授权范围内脱敏信息
引用对象sys_userUser/Employeepassword_hash高敏NEVER_RETURN禁止接口返回明文；仅密钥中心/鉴权服务按服务身份读取密钥引用禁止导出；配置导出只允许导出脱敏引用和启停状态配置新增、修改、启停、轮换和失败读取均记录安全审计前端只展示已配置/未配置、到期时间和连通性状态，不展示密钥值
引用对象int_integration_logIntegrationLogrequest_payload敏感PAYLOAD_DESENSITIZE接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段查看报文、下载附件、失败重放和人工补偿均记录审计业务端展示摘要和状态，完整报文仅运维/安全后台查看
引用对象int_integration_logIntegrationLogresponse_payload普通PAYLOAD_DESENSITIZE接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段查看报文、下载附件、失败重放和人工补偿均记录审计业务端展示摘要和状态，完整报文仅运维/安全后台查看
引用对象sec_sensitive_field_policySensitiveFieldPolicymask_rule普通BIZ_FIELD_MASK按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行导出时按数据级别触发审批、水印、下载有效期和日志查看、修改、删除、导出、下载和审批均记录操作审计默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则
引用对象fin_voucherFinanceVouchervoucher_no普通BIZ_FIELD_MASK按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行导出时按数据级别触发审批、水印、下载有效期和日志查看、修改、删除、导出、下载和审批均记录操作审计默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则

核心数据表完整字段

表名对象字段类型必填规则数据级别
mat_supplierSupplieridBIGINT是主键，雪花或号段生成，禁止复用普通
mat_supplierSuppliertenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
mat_supplierSupplierorg_idBIGINT否所属组织，集团级或公共配置为空普通
mat_supplierSuppliercampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
mat_supplierSuppliercreated_byBIGINT是创建人账号 ID普通
mat_supplierSuppliercreated_atDATETIME是创建时间普通
mat_supplierSupplierupdated_byBIGINT否最后更新人账号 ID普通
mat_supplierSupplierupdated_atDATETIME否最后更新时间普通
mat_supplierSupplieris_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
mat_supplierSupplierdeleted_atDATETIME否删除时间，未删除为空普通
mat_supplierSupplierdeleted_byBIGINT否删除人账号 ID，未删除为空普通
mat_supplierSupplierversionINT是乐观锁版本号，写操作必须校验普通
mat_supplierSuppliersupplier_codeVARCHAR(64)是供应商编码，唯一普通
mat_supplierSuppliersupplier_nameVARCHAR(128)是供应商名称普通
mat_supplierSuppliercontact_nameVARCHAR(64)否联系人普通
mat_supplierSuppliercontact_mobileVARCHAR(32)否联系人手机，敏感敏感
mat_supplierSuppliersettlement_ruleJSON否结算规则普通
mat_supplierSupplierenabledTINYINT是是否启用普通
mat_skuMaterial/Inventory/Asset/BookidBIGINT是主键，雪花或号段生成，禁止复用普通
mat_skuMaterial/Inventory/Asset/Booktenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
mat_skuMaterial/Inventory/Asset/Bookorg_idBIGINT否所属组织，集团级或公共配置为空普通
mat_skuMaterial/Inventory/Asset/Bookcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
mat_skuMaterial/Inventory/Asset/Bookcreated_byBIGINT是创建人账号 ID普通
mat_skuMaterial/Inventory/Asset/Bookcreated_atDATETIME是创建时间普通
mat_skuMaterial/Inventory/Asset/Bookupdated_byBIGINT否最后更新人账号 ID普通
mat_skuMaterial/Inventory/Asset/Bookupdated_atDATETIME否最后更新时间普通
mat_skuMaterial/Inventory/Asset/Bookis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
mat_skuMaterial/Inventory/Asset/Bookdeleted_atDATETIME否删除时间，未删除为空普通
mat_skuMaterial/Inventory/Asset/Bookdeleted_byBIGINT否删除人账号 ID，未删除为空普通
mat_skuMaterial/Inventory/Asset/BookversionINT是乐观锁版本号，写操作必须校验普通
mat_skuMaterial/Inventory/Asset/Booksku_codeVARCHAR(64)是SKU 编码，唯一普通
mat_skuMaterial/Inventory/Asset/Booksku_nameVARCHAR(128)是SKU 名称普通
mat_skuMaterial/Inventory/Asset/Booksku_typeVARCHAR(32)是物料/固定资产/图书/积分礼品普通
mat_skuMaterial/Inventory/Asset/BookunitVARCHAR(16)是计量单位普通
mat_skuMaterial/Inventory/Asset/Bookgift_pointsINT否作为积分礼品时所需积分普通
mat_skuMaterial/Inventory/Asset/BookenabledTINYINT是是否启用普通
mat_warehouseWarehouseidBIGINT是主键，雪花或号段生成，禁止复用普通
mat_warehouseWarehousetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
mat_warehouseWarehouseorg_idBIGINT否所属组织，集团级或公共配置为空普通
mat_warehouseWarehousecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
mat_warehouseWarehousecreated_byBIGINT是创建人账号 ID普通
mat_warehouseWarehousecreated_atDATETIME是创建时间普通
mat_warehouseWarehouseupdated_byBIGINT否最后更新人账号 ID普通
mat_warehouseWarehouseupdated_atDATETIME否最后更新时间普通
mat_warehouseWarehouseis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
mat_warehouseWarehousedeleted_atDATETIME否删除时间，未删除为空普通
mat_warehouseWarehousedeleted_byBIGINT否删除人账号 ID，未删除为空普通
mat_warehouseWarehouseversionINT是乐观锁版本号，写操作必须校验普通
mat_warehouseWarehousewarehouse_codeVARCHAR(64)是仓库编码，唯一普通
mat_warehouseWarehousewarehouse_nameVARCHAR(128)是仓库名称普通
mat_warehouseWarehousewarehouse_typeVARCHAR(32)是总部仓/校区仓/礼品仓/图书仓普通
mat_warehouseWarehousemanager_idBIGINT否仓库负责人普通
mat_warehouseWarehouseenabledTINYINT是是否启用普通
mat_inventoryInventoryidBIGINT是主键，雪花或号段生成，禁止复用普通
mat_inventoryInventorytenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
mat_inventoryInventoryorg_idBIGINT否所属组织，集团级或公共配置为空普通
mat_inventoryInventorycampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
mat_inventoryInventorycreated_byBIGINT是创建人账号 ID普通
mat_inventoryInventorycreated_atDATETIME是创建时间普通
mat_inventoryInventoryupdated_byBIGINT否最后更新人账号 ID普通
mat_inventoryInventoryupdated_atDATETIME否最后更新时间普通
mat_inventoryInventoryis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
mat_inventoryInventorydeleted_atDATETIME否删除时间，未删除为空普通
mat_inventoryInventorydeleted_byBIGINT否删除人账号 ID，未删除为空普通
mat_inventoryInventoryversionINT是乐观锁版本号，写操作必须校验普通
mat_inventoryInventorysku_idBIGINT是SKU ID普通
mat_inventoryInventorywarehouse_idBIGINT是仓库 ID普通
mat_inventoryInventoryavailable_qtyDECIMAL(18,2)是可用库存普通
mat_inventoryInventorylocked_qtyDECIMAL(18,2)是锁定库存普通
mat_inventoryInventoryin_transit_qtyDECIMAL(18,2)是在途库存普通
mat_inventoryInventorycost_amountDECIMAL(18,2)否库存成本普通
mat_stock_inStockInidBIGINT是主键，雪花或号段生成，禁止复用普通
mat_stock_inStockIntenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
mat_stock_inStockInorg_idBIGINT否所属组织，集团级或公共配置为空普通
mat_stock_inStockIncampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
mat_stock_inStockIncreated_byBIGINT是创建人账号 ID普通
mat_stock_inStockIncreated_atDATETIME是创建时间普通
mat_stock_inStockInupdated_byBIGINT否最后更新人账号 ID普通
mat_stock_inStockInupdated_atDATETIME否最后更新时间普通
mat_stock_inStockInis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
mat_stock_inStockIndeleted_atDATETIME否删除时间，未删除为空普通
mat_stock_inStockIndeleted_byBIGINT否删除人账号 ID，未删除为空普通
mat_stock_inStockInversionINT是乐观锁版本号，写操作必须校验普通
mat_stock_inStockInstock_in_noVARCHAR(64)是入库单编号，唯一普通
mat_stock_inStockInwarehouse_idBIGINT是入库仓库普通
mat_stock_inStockInsupplier_idBIGINT否供应商 ID普通
mat_stock_inStockInsource_biz_noVARCHAR(64)否来源单号普通
mat_stock_inStockInline_itemsJSON是入库明细普通
mat_stock_inStockInstock_in_statusVARCHAR(32)是草稿/待审核/已入库/已作废普通
mat_stock_inStockInapproval_statusVARCHAR(32)否审批状态，未发起为空普通
mat_stock_inStockInapproval_instance_idBIGINT否关联审批实例 ID普通
mat_stock_outStockOutidBIGINT是主键，雪花或号段生成，禁止复用普通
mat_stock_outStockOuttenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
mat_stock_outStockOutorg_idBIGINT否所属组织，集团级或公共配置为空普通
mat_stock_outStockOutcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
mat_stock_outStockOutcreated_byBIGINT是创建人账号 ID普通
mat_stock_outStockOutcreated_atDATETIME是创建时间普通
mat_stock_outStockOutupdated_byBIGINT否最后更新人账号 ID普通
mat_stock_outStockOutupdated_atDATETIME否最后更新时间普通
mat_stock_outStockOutis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
mat_stock_outStockOutdeleted_atDATETIME否删除时间，未删除为空普通
mat_stock_outStockOutdeleted_byBIGINT否删除人账号 ID，未删除为空普通
mat_stock_outStockOutversionINT是乐观锁版本号，写操作必须校验普通
mat_stock_outStockOutstock_out_noVARCHAR(64)是出库单编号，唯一普通
mat_stock_outStockOutwarehouse_idBIGINT是出库仓库普通
mat_stock_outStockOutuse_sceneVARCHAR(32)是教学/办公/积分兑换/报损/调拨普通
mat_stock_outStockOutsource_biz_noVARCHAR(64)否来源单号普通
mat_stock_outStockOutline_itemsJSON是出库明细普通
mat_stock_outStockOutstock_out_statusVARCHAR(32)是草稿/待审核/已出库/已作废普通
mat_stock_outStockOutapproval_statusVARCHAR(32)否审批状态，未发起为空普通
mat_stock_outStockOutapproval_instance_idBIGINT否关联审批实例 ID普通
mat_assetAssetidBIGINT是主键，雪花或号段生成，禁止复用普通
mat_assetAssettenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
mat_assetAssetorg_idBIGINT否所属组织，集团级或公共配置为空普通
mat_assetAssetcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
mat_assetAssetcreated_byBIGINT是创建人账号 ID普通
mat_assetAssetcreated_atDATETIME是创建时间普通
mat_assetAssetupdated_byBIGINT否最后更新人账号 ID普通
mat_assetAssetupdated_atDATETIME否最后更新时间普通
mat_assetAssetis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
mat_assetAssetdeleted_atDATETIME否删除时间，未删除为空普通
mat_assetAssetdeleted_byBIGINT否删除人账号 ID，未删除为空普通
mat_assetAssetversionINT是乐观锁版本号，写操作必须校验普通
mat_assetAssetasset_noVARCHAR(64)是资产编号，唯一普通
mat_assetAssetsku_idBIGINT是资产 SKU普通
mat_assetAssetowner_org_idBIGINT否归属组织普通
mat_assetAssetkeeper_idBIGINT否保管人普通
mat_assetAssetpurchase_dateDATE否购置日期普通
mat_assetAssetasset_statusVARCHAR(32)是在用/闲置/维修/报废/调拨中普通
mat_maintenance_orderAssetLifecycle/MaintenanceidBIGINT是主键，雪花或号段生成，禁止复用普通
mat_maintenance_orderAssetLifecycle/Maintenancetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
mat_maintenance_orderAssetLifecycle/Maintenanceorg_idBIGINT否所属组织，集团级或公共配置为空普通
mat_maintenance_orderAssetLifecycle/Maintenancecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
mat_maintenance_orderAssetLifecycle/Maintenancecreated_byBIGINT是创建人账号 ID普通
mat_maintenance_orderAssetLifecycle/Maintenancecreated_atDATETIME是创建时间普通
mat_maintenance_orderAssetLifecycle/Maintenanceupdated_byBIGINT否最后更新人账号 ID普通
mat_maintenance_orderAssetLifecycle/Maintenanceupdated_atDATETIME否最后更新时间普通
mat_maintenance_orderAssetLifecycle/Maintenanceis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
mat_maintenance_orderAssetLifecycle/Maintenancedeleted_atDATETIME否删除时间，未删除为空普通
mat_maintenance_orderAssetLifecycle/Maintenancedeleted_byBIGINT否删除人账号 ID，未删除为空普通
mat_maintenance_orderAssetLifecycle/MaintenanceversionINT是乐观锁版本号，写操作必须校验普通
mat_maintenance_orderAssetLifecycle/Maintenancemaintenance_noVARCHAR(64)是维修单编号，唯一普通
mat_maintenance_orderAssetLifecycle/Maintenanceasset_idBIGINT是资产 ID普通
mat_maintenance_orderAssetLifecycle/Maintenancefault_descVARCHAR(512)是故障描述普通
mat_maintenance_orderAssetLifecycle/Maintenancerepair_vendor_idBIGINT否维修供应商普通
mat_maintenance_orderAssetLifecycle/Maintenancerepair_amountDECIMAL(18,2)否维修金额普通
mat_maintenance_orderAssetLifecycle/Maintenancemaintenance_statusVARCHAR(32)是待维修/维修中/已完成/已报废普通

数据表与对象映射

表名对象用途完整字段索引建议
mat_supplierSupplier供应商档案id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、supplier_code(VARCHAR(64),必填)、supplier_name(VARCHAR(128),必填)、contact_name(VARCHAR(64))、contact_mobile(VARCHAR(32))、settlement_rule(JSON)、enabled(TINYINT,必填)uk_supplier_code、idx_enabled
mat_skuMaterial/Inventory/Asset/Book物料、固定资产、图书、礼品 SKUid(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、sku_code(VARCHAR(64),必填)、sku_name(VARCHAR(128),必填)、sku_type(VARCHAR(32),必填)、unit(VARCHAR(16),必填)、gift_points(INT)、enabled(TINYINT,必填)uk_sku_code、idx_type
mat_warehouseWarehouse仓库和校区库位id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、warehouse_code(VARCHAR(64),必填)、warehouse_name(VARCHAR(128),必填)、warehouse_type(VARCHAR(32),必填)、manager_id(BIGINT)、enabled(TINYINT,必填)uk_warehouse_code、idx_type
mat_inventoryInventory库存余额id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、sku_id(BIGINT,必填)、warehouse_id(BIGINT,必填)、available_qty(DECIMAL(18,2),必填)、locked_qty(DECIMAL(18,2),必填)、in_transit_qty(DECIMAL(18,2),必填)、cost_amount(DECIMAL(18,2))uk_sku_warehouse
mat_stock_inStockIn采购入库/退货入库id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、stock_in_no(VARCHAR(64),必填)、warehouse_id(BIGINT,必填)、supplier_id(BIGINT)、source_biz_no(VARCHAR(64))、line_items(JSON,必填)、stock_in_status(VARCHAR(32),必填)、approval_status(VARCHAR(32))、approval_instance_id(BIGINT)uk_stock_in_no、idx_status
mat_stock_outStockOut领用出库/核销出库id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、stock_out_no(VARCHAR(64),必填)、warehouse_id(BIGINT,必填)、use_scene(VARCHAR(32),必填)、source_biz_no(VARCHAR(64))、line_items(JSON,必填)、stock_out_status(VARCHAR(32),必填)、approval_status(VARCHAR(32))、approval_instance_id(BIGINT)uk_stock_out_no、idx_scene_status
mat_assetAsset固定资产台账id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、asset_no(VARCHAR(64),必填)、sku_id(BIGINT,必填)、owner_org_id(BIGINT)、keeper_id(BIGINT)、purchase_date(DATE)、asset_status(VARCHAR(32),必填)uk_asset_no、idx_status
mat_maintenance_orderAssetLifecycle/Maintenance资产维修与生命周期id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、maintenance_no(VARCHAR(64),必填)、asset_id(BIGINT,必填)、fault_desc(VARCHAR(512),必填)、repair_vendor_id(BIGINT)、repair_amount(DECIMAL(18,2))、maintenance_status(VARCHAR(32),必填)uk_maintenance_no、idx_asset_status

12 · 状态机与业务规则

约束业务对象如何流转、何时可编辑、何时触发审批

原型需要把状态标签、可操作按钮和禁用原因展示清楚。
对象状态触发与说明
督课评分待评分 -> 系统初评 -> 待复核 -> 已确认 -> 申诉中 -> 已调整 -> 已归档学生数据采集、教师数据采集、系统评分、督课复核、校长确认和申诉处理
监管报送待生成 -> 待报送 -> 报送中 -> 成功 -> 失败 -> 待重报 -> 人工处理合同备案、收款、课消、退费报送与回执
报销单草稿 -> 待 OCR -> 待核验 -> 待审批 -> 已通过 -> 待付款 -> 已付款 -> 已驳回 -> 已作废员工填单、票据识别、发票核验、查重、审批、付款归档
物料库存待入库 -> 在库 -> 已锁定 -> 已出库 -> 调拨中 -> 盘点中 -> 已报废采购入库、领用、兑换锁库、调拨、盘点、报废
工单新建 -> 已分派 -> 处理中 -> 待家长确认 -> 已关闭 -> 已升级 -> 已驳回投诉建议、服务请求、教学反馈和退费咨询
员工培训未分配 -> 待学习 -> 学习中 -> 待考试 -> 已通过 -> 未通过 -> 补训中 -> 已逾期培训计划发布、学习进度、考试成绩、补考复训和学习档案归档
直播房间草稿 -> 待开播 -> 直播中 -> 已结束 -> 回放生成中 -> 可回放 -> 异常 -> 已关闭创建房间、供应商资源申请、教师开播、下课、录制转码、回放发布和异常关闭
直播录制未录制 -> 录制中 -> 转码中 -> 可回放 -> 转码失败 -> 已过期 -> 已归档供应商录制回调、转码任务、回放发布、留存过期和资料归档
活动页面模板草稿 -> 待审核 -> 已上架 -> 已驳回 -> 已下架 -> 已归档模板创建、转模板提交、审核、上架、下架、归档和复用
直播连麦请求未举手 -> 已举手排队 -> 教师邀请中 -> 连接中 -> 上麦中 -> 已下麦 -> 已拒绝 -> 已取消 -> 已超时 -> 连接失败学员举手进入队列，教师处理后进入邀请和连接；取消、拒绝、超时、失败、下麦均写入互动事件和连麦请求记录
积分兑换售后待处理 -> 积分退回中 -> 库存释放中 -> 已完成 -> 失败待人工 -> 已关闭兑换取消、过期未核销、核销撤销和库存回滚
资产生命周期在库 -> 领用中 -> 已领用 -> 归还中 -> 调拨中 -> 维修中 -> 盘点中 -> 报废审批 -> 已报废 -> 已丢失固定资产领用、归还、责任人变更、调拨、维修、报废和丢失处理
采购对账付款询价中 -> 待审批 -> 待下单 -> 待入库 -> 入库差异 -> 待对账 -> 对账不平 -> 待付款 -> 已付款 -> 已退货 -> 已关闭采购申请、入库、对账、付款、退货和凭证归档
电子工资条待生成 -> 待审核 -> 待发布 -> 已发布 -> 员工已查看 -> 异议中 -> 已确认 -> 已归档薪资核算、审批、发布、员工查看确认、异议处理和归档
人脸授权撤回已提交 -> 家长已确认 -> 设备删除中 -> 部分失败 -> 已删除 -> 人工处理 -> 已关闭家长撤回、人脸模板删除任务、设备回执、失败重试和审计
回放发布访问待发布 -> 已发布 -> 已下架 -> 已过期 -> 无权限 -> 访问异常回放生成、范围发布、鉴权访问、下架、过期和异常处理
指标异常任务已触发 -> 待认领 -> 处理中 -> 已反馈 -> 已关闭 -> 已忽略 -> 已升级指标阈值触发、责任人处理、反馈和关闭确认
补课改期取消已确认 -> 改期申请中 -> 取消申请中 -> 教务处理中 -> 已重新安排 -> 已拒绝 -> 已关闭 -> 待冲正 -> 已冲正家长发起改期或取消，教务处理候选课次和课消冲正，最终回到补课安排或关闭
回放补传替换录制失败 -> 待补传 -> 审核中 -> 已发布 -> 替换中 -> 已替换 -> 已通知 -> 已驳回 -> 已下架录制失败或回放损坏后人工补传、审核、版本替换、通知和学习记录处理
积分实物售后已领取 -> 售后申请中 -> 待返库 -> 待换新 -> 待报损 -> 积分返还中 -> 已完成 -> 已拒绝礼品领取后退换货、坏损、返库报损、积分返还和库存流水处理
库存成本策略草稿 -> 待审核 -> 已启用 -> 已停用 -> 待重算 -> 重算中 -> 已归档成本计价规则配置、审批、生效、停用和历史成本处理
设备维修工单待派单 -> 已派单 -> 已接单 -> 排查中 -> 待恢复校验 -> 已恢复 -> 已关闭 -> 已升级视频设备离线告警生成维修工单，恢复后回测直播、回放、录像索引
工资条撤回重发已发布 -> 撤回中 -> 已撤回 -> 重发待审核 -> 已重发 -> 待重新确认 -> 已确认 -> 已归档工资条发布错误后撤回、重发、员工重新确认和版本留痕
线索客户合并仲裁待识别 -> 撞单待处理 -> 合并中 -> 仲裁中 -> 已合并 -> 已裁定 -> 误合并恢复中线索撞单、客户合并、归属争议仲裁和恢复
课堂端会话待绑定 -> 已绑定 -> 待开课 -> 授课中 -> 暂停中 -> 已结束 -> 异常断开教师或教室设备创建课堂会话，TV 与教师端完成绑定后同步课件、互动和课堂状态；断开后可重连，结束后归档审计。
教师端工作台任务待处理 -> 处理中 -> 已完成 -> 已驳回 -> 已超时 -> 已取消课程、批改、审批、培训、报销、工资条和直播任务统一进入工作台待办，并按业务模块回写处理状态。
员工推广资产待生成 -> 已生成 -> 分享中 -> 已停用 -> 已失效 -> 生成失败员工在教师端领取活动后生成专属短链、二维码和海报，活动停用或超期后资产失效
员工分享记录已分享 -> 已访问 -> 已扫码 -> 已留资 -> 已生成线索 -> 已预约试听 -> 已签约 -> 已流失外部访问、扫码、留资和转化阶段均回写员工分享记录
唯一性校验

物料资产中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

跨校区数据隔离

物料资产中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

敏感操作留痕

物料资产中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

外部接口幂等

物料资产中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

批量失败明细

物料资产中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

状态回退审批

物料资产中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

13 · 权限、审批与消息

动作权限、数据范围、审批触发和消息触达必须闭环

权限需要覆盖菜单、按钮、字段、接口和导出。

动作权限

  • SKU 建档：需映射菜单、按钮、接口和字段权限
  • 采购申请：需映射菜单、按钮、接口和字段权限
  • 验收入库：需映射菜单、按钮、接口和字段权限
  • 采购对账：需映射菜单、按钮、接口和字段权限
  • 采购付款：需映射菜单、按钮、接口和字段权限
  • 领用出库：需映射菜单、按钮、接口和字段权限
  • 资产维修：需映射菜单、按钮、接口和字段权限
  • 责任人变更：需映射菜单、按钮、接口和字段权限
  • 盘点调拨：需映射菜单、按钮、接口和字段权限
  • 礼品核销：需映射菜单、按钮、接口和字段权限

数据范围

  • 总部全量
  • 区域辖区
  • 校区本地
  • 部门/岗位
  • 本人负责
  • 授权班级/学员

审批配置

审批名称触发条件流程结果留痕
报销审批员工提交费用报销或发票查重命中风险员工提交 -> 部门主管 -> 校长/预算负责人 -> 财务复核通过后进入付款，驳回后返回报销人修改保留票据影像、OCR 结果、核验结果、查重结果和审批意见
物料采购审批采购金额超过阈值、跨校区采购或固定资产采购申请人 -> 校区负责人 -> 采购/财务 -> 总部审批通过后生成采购订单和到货验收任务保留预算、供应商、报价和采购合同附件
固定资产报废审批固定资产、图书或高价值物料需要报废责任人提交 -> 校区负责人 -> 资产管理员 -> 财务复核通过后出库、报废并生成财务核销记录保留照片、盘点记录、处置说明和残值
人脸授权撤回处理家长撤回人脸授权家长提交 -> 系统确认 -> 设备管理员执行停止识别并下发删除任务保留撤回凭证和删除结果
薪资审批月度薪资批次生成后人事核算 -> 校长确认 -> 财务复核 -> 总部终审工资条发布并生成凭证保留规则版本和计算明细
监管异常人工关闭监管报送连续失败或需人工确认财务提交 -> 财务主管审批异常关闭或重报保留回执、原因和处理附件
直播供应商配置审批新增或变更直播供应商密钥、回调地址、录制存储、转码模板和域名配置技术运维 -> 系统管理员 -> 安全管理员通过后配置生效并触发连通性校验，同一租户仅保留一个启用供应商保留配置前后快照和验签结果
系统节日模板上架审批新增或调整 24 节气、传统节日等系统内置模板设计/市场 -> 品牌审核 -> 总部管理员通过后上架到模板库并可被活动创建引用保留模板版本、素材版权、适用范围和上下架记录

消息模板

消息接收人触发渠道变量
试听预约通知家长/教师/顾问试听课预约成功或变更小程序、短信、App上课时间、校区、教室、教师
库存预警库管/校区负责人物料或礼品低于安全库存站内信、App、企微SKU、校区、当前库存、安全库存、补货建议
积分兑换核销通知学员/家长/校区前台兑换成功、即将过期或核销完成小程序、App、站内信礼品名称、兑换码、核销校区、有效期
摄像头离线告警设备管理员/校区前台摄像头心跳超时或拉流失败站内信、App校区、教室、摄像头编号、品牌、异常时间
培训任务通知员工/直属主管培训计划发布或即将到期站内信、App、微信小程序培训名称、截止时间、必修状态、学习入口
考试结果通知员工/人事/直属主管员工提交培训考试站内信、App考试名称、得分、是否通过、补考安排
集团会议直播通知员工/主管/总部会议发布、开播、未签到、纪要任务生成App、站内信、企微会议主题、参会范围、签到状态、任务入口
直播回放生成通知教师/教务/学员/员工录制转码完成或失败App、站内信、小程序直播标题、回放入口、有效期、失败原因

14 · 接口与技术细节

接口需支持幂等、权限、审计、重试和回执

每个写接口必须有 requestId 或业务幂等键，外部回调必须验签和去重。
接口方法方向请求字段响应字段幂等/权限
/api/v1/material/skusPOST/GETPC Web 到物料skuCode, skuName, category, unit, stockRuleskuId, status, stockSummaryskuCode 唯一
/api/v1/material/purchase-ordersPOSTPC Web 到物料supplierId, items, expectedAt, requestIdpoId, auditStatus, totalAmountrequestId 幂等
/api/v1/material/purchase-reconciliationsPOST/GETPC Web 到物料财务supplierId, purchaseOrderIds, inboundNos, invoiceIds, requestIdreconcileId, reconcileStatus, diffItems供应商 + 采购单幂等
/api/v1/material/purchase-paymentsPOSTPC Web 到财务reconcileId, paymentAccountId, payAmount, attachments, requestIdpaymentId, paymentStatus, voucherTaskIdreconcileId + requestId 幂等
/api/v1/inventory/stock-locksPOST积分商城到库存skuId, warehouseId, quantity, bizNolockId, lockStatus, expireAtbizNo 唯一
/api/v1/assets/booksPOST/GETPC Web 到资产bookCode, isbn, ownerCampusId, statusbookId, assetStatus, location资产编号唯一
/api/v1/assets/lifecycle-actionsPOSTPC Web 到物料资产assetId, actionType, targetOwnerId, targetWarehouseId, reason, attachments, requestIdactionId, assetLifecycleStatus, approvalStatus资产状态校验
/api/v1/points/redemptions/{id}/write-offPOST前台到积分商城orderId, writeOffCode, operatorIdwriteOffStatus, outboundNo核销码一次性使用

前端约束

  • 统一登录态和租户校区上下文
  • 列表分页、筛选、排序、列显隐
  • 表单本地校验与服务端错误映射
  • 移动/平板/TV 按终端适配交互

后端约束

  • 领域服务封装业务规则
  • 写操作事务一致性
  • 关键操作审计快照
  • 异步任务失败重试和告警

集成约束

  • 第三方接口统一走开放集成中心
  • 回执文件归档
  • 接口日志可按业务单号追踪
  • 密钥和回调地址按环境隔离

15 · 数据库与存储设计

核心表建议、关键字段和索引方向

详细 DDL 已在平台技术设计文档中统一展开，本处保留模块核心表、关键字段和索引方向。
表名用途核心字段索引建议
mat_supplier供应商档案id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、supplier_code、supplier_name、contact_name、contact_mobile、settlement_rule、enableduk_supplier_code、idx_enabled
mat_sku物料、固定资产、图书、礼品 SKUid、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、sku_code、sku_name、sku_type、unit、gift_points、enableduk_sku_code、idx_type
mat_warehouse仓库和校区库位id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、warehouse_code、warehouse_name、warehouse_type、manager_id、enableduk_warehouse_code、idx_type
mat_inventory库存余额id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、sku_id、warehouse_id、available_qty、locked_qty、in_transit_qty、cost_amountuk_sku_warehouse
mat_stock_in采购入库/退货入库id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、stock_in_no、warehouse_id、supplier_id、source_biz_no、line_items、stock_in_status、approval_status、approval_instance_iduk_stock_in_no、idx_status
mat_stock_out领用出库/核销出库id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、stock_out_no、warehouse_id、use_scene、source_biz_no、line_items、stock_out_status、approval_status、approval_instance_iduk_stock_out_no、idx_scene_status
mat_asset固定资产台账id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、asset_no、sku_id、owner_org_id、keeper_id、purchase_date、asset_statusuk_asset_no、idx_status
mat_maintenance_order资产维修与生命周期id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、maintenance_no、asset_id、fault_desc、repair_vendor_id、repair_amount、maintenance_statusuk_maintenance_no、idx_asset_status

DDL 草案

mat_supplierSupplier 
CREATE TABLE `mat_supplier` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `supplier_code` VARCHAR(64) NOT NULL COMMENT '供应商编码，唯一；数据级别：普通',
  `supplier_name` VARCHAR(128) NOT NULL COMMENT '供应商名称；数据级别：普通',
  `contact_name` VARCHAR(64) NULL COMMENT '联系人；数据级别：普通',
  `contact_mobile` VARCHAR(32) NULL COMMENT '联系人手机，敏感；数据级别：敏感',
  `settlement_rule` JSON NULL COMMENT '结算规则；数据级别：普通',
  `enabled` TINYINT NOT NULL COMMENT '是否启用；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_supplier_code` (`supplier_code`),
  KEY `idx_enabled` (`enabled`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='Supplier：供应商档案';
mat_skuMaterial/Inventory/Asset/Book 
CREATE TABLE `mat_sku` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `sku_code` VARCHAR(64) NOT NULL COMMENT 'SKU 编码，唯一；数据级别：普通',
  `sku_name` VARCHAR(128) NOT NULL COMMENT 'SKU 名称；数据级别：普通',
  `sku_type` VARCHAR(32) NOT NULL COMMENT '物料/固定资产/图书/积分礼品；数据级别：普通',
  `unit` VARCHAR(16) NOT NULL COMMENT '计量单位；数据级别：普通',
  `gift_points` INT NULL COMMENT '作为积分礼品时所需积分；数据级别：普通',
  `enabled` TINYINT NOT NULL COMMENT '是否启用；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_sku_code` (`sku_code`),
  KEY `idx_type` (`sku_type`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='Material/Inventory/Asset/Book：物料、固定资产、图书、礼品 SKU';
mat_warehouseWarehouse 
CREATE TABLE `mat_warehouse` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `warehouse_code` VARCHAR(64) NOT NULL COMMENT '仓库编码，唯一；数据级别：普通',
  `warehouse_name` VARCHAR(128) NOT NULL COMMENT '仓库名称；数据级别：普通',
  `warehouse_type` VARCHAR(32) NOT NULL COMMENT '总部仓/校区仓/礼品仓/图书仓；数据级别：普通',
  `manager_id` BIGINT NULL COMMENT '仓库负责人；数据级别：普通',
  `enabled` TINYINT NOT NULL COMMENT '是否启用；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_warehouse_code` (`warehouse_code`),
  KEY `idx_type` (`warehouse_type`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='Warehouse：仓库和校区库位';
mat_inventoryInventory 
CREATE TABLE `mat_inventory` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `sku_id` BIGINT NOT NULL COMMENT 'SKU ID；数据级别：普通',
  `warehouse_id` BIGINT NOT NULL COMMENT '仓库 ID；数据级别：普通',
  `available_qty` DECIMAL(18,2) NOT NULL COMMENT '可用库存；数据级别：普通',
  `locked_qty` DECIMAL(18,2) NOT NULL COMMENT '锁定库存；数据级别：普通',
  `in_transit_qty` DECIMAL(18,2) NOT NULL COMMENT '在途库存；数据级别：普通',
  `cost_amount` DECIMAL(18,2) NULL COMMENT '库存成本；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_sku_warehouse` (`sku_id`, `warehouse_id`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='Inventory：库存余额';
mat_stock_inStockIn 
CREATE TABLE `mat_stock_in` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `stock_in_no` VARCHAR(64) NOT NULL COMMENT '入库单编号，唯一；数据级别：普通',
  `warehouse_id` BIGINT NOT NULL COMMENT '入库仓库；数据级别：普通',
  `supplier_id` BIGINT NULL COMMENT '供应商 ID；数据级别：普通',
  `source_biz_no` VARCHAR(64) NULL COMMENT '来源单号；数据级别：普通',
  `line_items` JSON NOT NULL COMMENT '入库明细；数据级别：普通',
  `stock_in_status` VARCHAR(32) NOT NULL COMMENT '草稿/待审核/已入库/已作废；数据级别：普通',
  `approval_status` VARCHAR(32) NULL COMMENT '审批状态，未发起为空；数据级别：普通',
  `approval_instance_id` BIGINT NULL COMMENT '关联审批实例 ID；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_stock_in_no` (`stock_in_no`),
  KEY `idx_status` (`stock_in_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='StockIn：采购入库/退货入库';
mat_stock_outStockOut 
CREATE TABLE `mat_stock_out` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `stock_out_no` VARCHAR(64) NOT NULL COMMENT '出库单编号，唯一；数据级别：普通',
  `warehouse_id` BIGINT NOT NULL COMMENT '出库仓库；数据级别：普通',
  `use_scene` VARCHAR(32) NOT NULL COMMENT '教学/办公/积分兑换/报损/调拨；数据级别：普通',
  `source_biz_no` VARCHAR(64) NULL COMMENT '来源单号；数据级别：普通',
  `line_items` JSON NOT NULL COMMENT '出库明细；数据级别：普通',
  `stock_out_status` VARCHAR(32) NOT NULL COMMENT '草稿/待审核/已出库/已作废；数据级别：普通',
  `approval_status` VARCHAR(32) NULL COMMENT '审批状态，未发起为空；数据级别：普通',
  `approval_instance_id` BIGINT NULL COMMENT '关联审批实例 ID；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_stock_out_no` (`stock_out_no`),
  KEY `idx_scene_status` (`use_scene`, `stock_out_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='StockOut：领用出库/核销出库';
mat_assetAsset 
CREATE TABLE `mat_asset` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `asset_no` VARCHAR(64) NOT NULL COMMENT '资产编号，唯一；数据级别：普通',
  `sku_id` BIGINT NOT NULL COMMENT '资产 SKU；数据级别：普通',
  `owner_org_id` BIGINT NULL COMMENT '归属组织；数据级别：普通',
  `keeper_id` BIGINT NULL COMMENT '保管人；数据级别：普通',
  `purchase_date` DATE NULL COMMENT '购置日期；数据级别：普通',
  `asset_status` VARCHAR(32) NOT NULL COMMENT '在用/闲置/维修/报废/调拨中；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_asset_no` (`asset_no`),
  KEY `idx_status` (`asset_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='Asset：固定资产台账';
mat_maintenance_orderAssetLifecycle/Maintenance 
CREATE TABLE `mat_maintenance_order` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `maintenance_no` VARCHAR(64) NOT NULL COMMENT '维修单编号，唯一；数据级别：普通',
  `asset_id` BIGINT NOT NULL COMMENT '资产 ID；数据级别：普通',
  `fault_desc` VARCHAR(512) NOT NULL COMMENT '故障描述；数据级别：普通',
  `repair_vendor_id` BIGINT NULL COMMENT '维修供应商；数据级别：普通',
  `repair_amount` DECIMAL(18,2) NULL COMMENT '维修金额；数据级别：普通',
  `maintenance_status` VARCHAR(32) NOT NULL COMMENT '待维修/维修中/已完成/已报废；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_maintenance_no` (`maintenance_no`),
  KEY `idx_asset_status` (`asset_id`, `maintenance_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='AssetLifecycle/Maintenance：资产维修与生命周期';

16 · 异常、指标、测试与初始化

保证模块上线后可运营、可追踪、可验收

测试要覆盖主流程、异常流、权限流、接口失败和数据一致性。

异常状态

库存不足盘点差异资产责任缺失入库差异供应商对账不平采购付款失败资产责任人缺失维修超期图书库存不足库存释放失败礼品坏损成本口径缺失设备恢复校验失败

指标埋点

库存准确率采购到货率资产盘点差异率图书库存准确率礼品核销率

测试用例

编号场景前置步骤预期优先级
TC-026监管回执差异对账模拟监管返回金额不一致执行回执处理进入财务异常，无法自动关闭高
TC-038员工培训计划学习闭环培训计划已发布并分配员工员工打开培训、完成资料学习、提交考试学习进度、考试成绩和员工培训档案完整高
TC-039考试未通过自动补训考试通过线已配置员工考试分数低于通过线系统生成补考/复训任务并通知员工和主管中
TC-040千台级摄像头台账导入准备海康威视、宇视摄像头清单批量导入摄像头并绑定校区、教室和楼层点位导入成功、重复和错误明细清晰，摄像头状态可校验高
TC-041地图监控与直播巡课摄像头在线且账号具备巡课权限在地图中定位校区教室并打开多画面直播直播画面可打开，权限过滤正确，巡课访问留痕高
TC-047报销发票 OCR 与核验员工上传真实发票影像提交报销单并触发 OCR 与发票核验识别出发票关键字段，核验状态、查重状态和审批状态正确高
TC-050物料采购入库与出库物料 SKU、供应商和库存仓已建立提交采购、验收入库、领用出库和盘点库存数量、库存金额、出入库单和审批记录一致高
TC-051积分商城兑换与线下核销学员积分充足且礼品库存充足学员兑换礼品，前台扫码核销积分扣减、库存锁定、出库记录、核销状态全部正确高
TC-052积分兑换库存不足处理礼品可用库存低于兑换数量学员提交兑换系统阻止兑换或提示调拨补货，不扣减积分中
TC-LIVE-001教学直播完整闭环已创建课程、班级、课次、学员和供应商配置教务创建直播课，教师开播，学员进入互动，结束后生成回放签到、课消、学习档案、回放和统计均正确高
TC-MAT-ENH-001进销存范围交付闭环验收物料档案、图书库存、固定资产、库存流水相关基础数据、权限、审批流、消息模板和接口配置已初始化按明确图书仅按库存和资产管理，补齐采购、入库、出库、调拨、盘点、报损、报废。执行前端提交、后端处理、状态流转、异常重试和消息触达图书无借阅状态，只有库存和资产生命周期。；同时产生审计日志、指标埋点和必要的补偿任务高
TC-MAT-ENH-002积分联动交付闭环验收礼品库存、兑换订单、核销台相关基础数据、权限、审批流、消息模板和接口配置已初始化按补齐礼品 SKU、库存锁定、核销出库、取消释放、售后返库和积分流水。执行前端提交、后端处理、状态流转、异常重试和消息触达库存数量、积分账户和核销记录一致。；同时产生审计日志、指标埋点和必要的补偿任务高
TC-MAT-ENH-003采购财务交付闭环验收采购订单、入库单、对账单、付款单相关基础数据、权限、审批流、消息模板和接口配置已初始化按补齐采购申请、订单、入库差异、供应商对账、付款审批和凭证联动。执行前端提交、后端处理、状态流转、异常重试和消息触达采购入库后可形成库存/资产和财务应付链路。；同时产生审计日志、指标埋点和必要的补偿任务高

上线初始化

初始化项动作数据验收
课程与价格导入课程、班型、课包、课时、价格、适用校区课程编码、班型、价格表、有效期、赠课规则报价和合同可正确引用价格
远程巡课导入存量教室摄像头并配置品牌接入、地图点位和录像留存策略摄像头编号、品牌型号、网关配置、校区教室、楼层点位、存储策略摄像头可在地图中显示状态，直播和回放链路可抽检通过
知识库培训初始化知识库分类、资料类型、培训课程、考试规则和岗位能力学习分类目录、资料类型、必修课程、题库、学习档案规则员工可按岗位收到培训任务并完成考试
物料资产初始化物料分类、SKU、供应商、仓库、库存、固定资产和图书台账SKU 编码、单位、条码、安全库存、资产编号、库存余额采购、入库、领用、调拨和盘点可正常执行
积分商城配置积分规则、礼品 SKU、兑换积分、核销校区和库存联动积分来源、积分有效期、礼品库存、兑换规则、核销权限学员兑换后可锁库，前台核销后可出库
数据迁移迁移客户、学员、合同、剩余课时、课表、教师、员工基础数据源系统字段映射、校验结果、差异清单关键业务对象数量和余额一致
直播供应商基础配置初始化阿里云、腾讯云、七牛云直播框架的租户级配置providerCode、appId、appSecret、推流域名、播放域名、回调地址、录制策略、转码模板、对象存储桶/目录三家供应商均可完成连通性校验和测试回调，同一租户仅启用一个供应商
直播角色与权限初始化直播管理员、教务直播运营、教师主播、助教、学员、员工参会、市场运营等权限菜单、按钮、数据范围、导出审批、回放权限各角色只能访问授权直播房间和回放
进销存范围交付配置初始化明确图书仅按库存和资产管理，补齐采购、入库、出库、调拨、盘点、报损、报废。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限物料档案、图书库存、固定资产、库存流水图书无借阅状态，只有库存和资产生命周期。
积分联动交付配置初始化补齐礼品 SKU、库存锁定、核销出库、取消释放、售后返库和积分流水。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限礼品库存、兑换订单、核销台库存数量、积分账户和核销记录一致。
采购财务交付配置初始化补齐采购申请、订单、入库差异、供应商对账、付款审批和凭证联动。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限采购订单、入库单、对账单、付款单采购入库后可形成库存/资产和财务应付链路。