记录画图笔记

三、大公司实践:哪些必须画,哪些可以略?

图类型 是否必须 备注
系统架构图 ✅ 必画 项目评审、开发同步都需要
时序图 ✅ 必画 每个关键业务流程建议都画
部署图 ✅ 必画 交付上线、运维对接不可少
数据库ER图 ⚠️ 视情况 如果表少可以省略,但核心模块一定要画
功能流程图 ⚠️ 视情况 产品需求阶段有产出即可,开发侧通常参考,不一定自己画
状态图、类图等 ❌ 可选 通常用于复杂逻辑或多人协作时补充

不要所有功能都画图,而是聚焦以下内容:

  • 核心流程(如登录、支付、下单、退款等)
  • 系统间接口(微服务之间的调用)
  • 重复变更或多人维护的模块

图和文档要并行更新,避免图过期。

图要版本化管理 ,推荐放在 Git 项目文档目录下(如 /docs/design/

✅ 2. 流程图 / 泳道图 / 业务流程图

用途:展示一个完整业务流程的步骤、用户参与方、状态变化。

是否要做 场景 原因与建议
要做 涉及多个角色协作的流程(如 审核流、订单流、支付链路) 有助于对齐需求,避免遗漏关键逻辑,开发测试理解统一
要做 复杂状态变化(如:订单状态、审批状态) 泳道图可清晰展示不同用户或系统的操作边界
可以不做 单接口单操作场景,逻辑很简单(如"点击就执行") 这类流程写成文字+接口文档即可,画图反而啰嗦
可以不做 接口功能已经在时序图中完整表达了 如果时序图已涵盖流程,流程图可不画,避免重复工作

✅ 总结建议(给开发的实战建议)

图类型 什么项目要画 不画的替代方式
菜单图 / 模块结构图 做后台管理系统、SaaS 简单系统可直接列接口文档或接口分组
流程图 / 泳道图 有复杂业务流程,涉及多个角色 简单逻辑用接口注释或文字流程描述代替
权限功能表格 权限体系明确、多角色系统 权限不复杂时写在 PRD 或模块描述里

泳道活动图,更侧重于表达谁做了什么事;而时序图,除了强调流程中交互的消息和顺序,还表达谁对谁做了什么事。

我的体会是,遇到强调消息传递、时间顺序的,用时序图;遇到流程比较复杂、分支比较多的,用活动图。

相关推荐
开开心心就好2 天前
近200个工具的电脑故障修复合集
安全·智能手机·pdf·电脑·consul·memcache·1024程序员节
数据皮皮侠AI4 天前
中国城市可再生能源数据集(2005-2021)|顶刊 Sci Data 11 种能源面板
大数据·人工智能·笔记·能源·1024程序员节
计算机毕业论文辅导7 天前
物联网实战:基于MQTT协议的智能家居数据传输系统设计与实现
1024程序员节
开开心心就好7 天前
支持批量处理的视频分割工具推荐
安全·智能手机·rust·pdf·电脑·1024程序员节·lavarel
liuyao_xianhui9 天前
Linux开发工具结尾 _make
linux·运维·服务器·数据结构·哈希算法·宽度优先·1024程序员节
学传打活11 天前
【边打字.边学昆仑正义文化】_21_爱的结晶(1)
微信公众平台·1024程序员节·汉字·昆仑正义文化
数据皮皮侠AI18 天前
顶刊同款!中国地级市风灾风险与损失数据集(2000-2022)|灾害 / 环境 / 经济研究必备
大数据·人工智能·笔记·能源·1024程序员节
Fab1an19 天前
Busqueda——Hack The Box 靶机
linux·服务器·学习·1024程序员节
技术专家20 天前
Stable Diffusion系列的详细讨论 / Detailed Discussion of the Stable Diffusion Series
人工智能·python·算法·推荐算法·1024程序员节
学传打活22 天前
古代汉语是源,现代汉语是流,源与流一脉相承。
微信公众平台·1024程序员节·汉字·中华文化