学习主题
仓储管理系统的核心实体关系、功能架构及业务流程建模，掌握Mermaid语法实现可视化图表绘制。
学习内容梳理
一、系统核心实体与关系
-
核心实体及字段约束
Warehouse（仓库）：id（主键）、code（唯一编码）、name（名称）、address（地址）、manager（负责人）
Material（物资）：id（主键）、materialCode（唯一编码）、name/spec/materialType（复合唯一）、warehouse（所在仓库名称，文本关联）
StockMove（出入库单）：id（主键）、type（IN/OUT）、material_id（外键关联Material）、warehouse（发生仓库）、createTime（创建时间） -
实体关联规则
StockMove与Material：N:1强外键关联（material_id → Material.id）
Material与Warehouse：文本关联（Material.warehouse → Warehouse.name，无数据库外键约束）
二、系统功能架构
仓储管理系统分为三大核心模块，各模块功能如下：
- 基础数据管理：物资管理（新增/删除/查询/搜索）、仓库管理（新增/删除/查询）
- 作业管理：入库作业、出库作业
- 查询统计：库存查询、仓库汇总、单据查询
三、业务流程核心逻辑
- 入库流程：选择物资与目标仓库 → 设置Material.warehouse为目标仓库 → 保存物资 → 生成IN类型StockMove → 返回成功并刷新列表
- 出库流程：选择物资 → 清空Material.warehouse → 保存物资 → 生成OUT类型StockMove → 返回成功并刷新列表
四、Mermaid图表绘制实践
-
问题解决：图表生成失败修复
失败原因：Mermaid语法兼容性问题（分支逻辑、子图嵌套格式不规范）
修复方案：
业务流程图：改用官方推荐的choice节点语法，简化分支逻辑
数据流图：减少嵌套层级，明确标注数据流编号，添加样式区分实体类型
兼容处理：移除高版本语法（如复杂classDef），保留核心逻辑适配低版本平台 -
关键图表模板（修正版）
业务流程图（入库/出库）：优化分支判断，增加样式区分节点类型
数据流图（DFD Level0）：简化子图结构，标注数据流方向与含义
拆分版流程：将复杂流程拆分为独立入库/出库图表，降低渲染复杂度
学习难点与解决
-
难点：Mermaid语法在不同平台的兼容性差异，导致部分图表渲染失败
解决：通过Mermaid Live Editor验证语法正确性，移除平台不支持的高级特性，保留核心逻辑；拆分复杂图表为简单子图表。 -
难点：实体间文本关联与外键关联的可视化区分
解决：在ER图中用虚线标注文本关联，实线标注外键关联，添加注释说明关联规则。
学习收获
- 掌握仓储管理系统的核心业务模型，理解实体设计、功能划分与流程逻辑的关联性；
- 熟练使用Mermaid语法绘制ER图、功能结构图、业务流程图、数据流图，解决语法兼容性问题；
- 学会通过拆分图表、简化逻辑、标注说明等方式提升可视化图表的可读性与兼容性。