目录
1 需求阶段|搞清楚做什么
2 设计阶段|想好怎么做(架构、数据库、接口)
结构化思考:选型的判断原则(对做工业软件很关键)
极简Mermaid总览图
结合做工业ToB软件(碳排放管理Web系统)的场景,区分:业务工具(协作、文档)、技术工具(编码、架构、测试、部署),同时标注轻量化选型。
1 需求阶段|搞清楚做什么
阶段目标:梳理业务、确定范围、输出需求、原型,对齐客户/内部
| 类别 | 工具 | 用途&技术说明 |
|---|---|---|
| 文档协作 | 飞书文档 / Confluence / Notion | 编写URS、SRS需求文档,版本留痕,多人评审 |
| 原型UI | Axure RP、墨刀、Figma | 页面交互原型,画Web页面流转;给客户确认界面 |
| 思维导图 | XMind、MindMaster | Mermaid,拆解业务场景、功能清单 |
| 需求管理 | Jira / 禅道 | 记录需求条目,标记状态,区分“要做/不做”边界 |
| 沟通 | 企业微信 | 需求评审会议,留存会议纪要 |
产出物:需求规格SRS、交互原型、业务思维导图、需求清单
2 设计阶段|想好怎么做(架构、数据库、接口)
阶段目标:系统架构、模块拆分、数据库、API接口、部署方案
| 类别 | 工具 | 用途&技术说明 |
|---|---|---|
| 架构绘图 | PlantUML、Mermaid、Visio、Draw.io | 架构图、数据流图、组件图、时序图(你经常用PlantUML) |
| 数据库设计 | PowerDesigner、DBeaver、Navicat、DrawSQL | ER图、表结构设计;MySQL / PostgreSQL(工业系统常用PG) |
| 接口设计 | Apifox、Postman、Swagger | 定义API入参出参,生成接口文档;支持mock模拟返回数据 |
| UI视觉 | Figma | 正式页面UI稿,样式、组件库 |
| 部署架构 | Draw.io | Mermaid绘制服务器、网络、第三方对接拓扑图 |
产出物:概要设计、数据库设计、API文档、部署架构图
##3 开发实现阶段|写代码阶段目标:编码、版本管理、本地调试、单元自测
| 类别 | 工具 | 用途&技术说明 |
|---|---|---|
| IDE编辑器 | VS Code、IDEA | 后端Java/Python;前端Vue/React代码编写 |
| 版本控制 | Git + Gitee/GitLab/Github | 代码仓库,分支管理,多人协作,代码回滚;必备 |
| 后端技术栈 | SpringBoot / FastAPI | Web后端;工业系统常用Java;快速原型用Python FastAPI |
| 前端技术栈 | Vue3 + Element‑Plus | B端Web管理系统主流,适合你的碳排放Web系统 |
| 本地数据库 | MySQL / PostgreSQL | 本地开发调试数据库 |
| 消息队列(可选) | RabbitMQ、Redis | 处理多源数据上传、异步计算(碳核算大量台账计算) |
| 单元测试 | JUnit(Java)、Pytest(Python) | 开发人员做单元白盒测试 |
产出:源代码,可运行版本,单元测试用例
##4 测试阶段|验证系统是否满足需求阶段目标:功能测试、接口测试、边界异常、性能测试,输出测试报告
| 类别 | 工具 | 用途&技术说明 |
|---|---|---|
| 测试管理 | 禅道、Jira | 编写测试计划、测试用例,提交bug缺陷跟踪 |
| 接口测试 | Apifox / Postman | 自动化接口测试,批量跑接口用例 |
| Web功能测试 | 浏览器(Chrome) | 手工页面功能测试;Selenium Playwright自动化UI测试 |
| 性能压力测试 | JMeter | 模拟多用户并发,大数据量碳台账导入压力测试 |
| 数据库校验工具 | DBeaver | 核对数据库计算结果,校验碳核算数据正确性 |
| 测试报告输出 | Word/飞书文档 | 输出完整软件测试报告 |
产出:测试计划、测试用例、缺陷记录、测试报告
##5 部署上线阶段|环境发布阶段目标:环境打包、部署、备份、权限配置
| 类别 | 工具 | 用途&技术说明 |
|---|---|---|
| 服务器 | Linux(CentOS / Ubuntu) | 后端运行环境,工业软件主流Linux |
| 容器 | Docker / Docker‑Compose | 容器打包,环境一致性,开发、测试、生产环境统一;强烈推荐ToB项目 |
| 部署 | Jenkins(CI/CD) | 自动打包、自动部署;小项目可手动部署 |
| 数据库运维 | DBeaver | 生产库备份、数据迁移 |
| 反向代理 | Nginx | Web服务转发,前端页面托管 |
产出:上线版本,部署手册,备份策略
##6 运维迭代阶段|上线之后维护阶段目标:故障排查、版本迭代、问题收集
| 类别 | 工具 | 用途&技术说明 |
|---|---|---|
| 日志查看 | Linux日志、ELK | 排查系统报错,碳核算计算异常定位 |
| 问题反馈 | Jira/禅道 | 收集客户问题,管理迭代需求 |
| 文档维护 | 飞书/Confluence | 持续更新操作手册、运维手册,文档和代码同步更新 |
结构化思考:选型的判断原则
- 项目规模决定工具重量
- 小项目原型:不用重型Jira、PowerDesigner;Mermaid+Apifox+飞书文档就够用。
- 招投标、半导体厂务类项目(需要验收交付文档):Jira、禅道、完整设计工具,文档齐全。
工具不要堆砌,优先保证产出物
工具只是载体,核心产出:需求、架构图、数据库、接口、测试用例、手册;哪怕用Mermaid画,信息不能丢。
- ToB工业软件重点关注工具能力
- 数据量大(大量台账导入核算):重视压力测试工具、Redis消息队列;
- 需要交付客户现场部署:优先Docker容器,降低现场部署麻烦。