2018-05-17-OAA-一种mermaid脚本驱动的软件项目模块图形化表述思路
2024-04-06 12:56:12
layout: post
title: 2018-05-17-OAA-一种mermaid脚本驱动的软件项目模块图形化表述思路
key: 20180517
tags: OAA flow chart sequence diagram 泳道图 时序图 图表 OAA PM Master
modify_date: 05-17
OAA-一种mermaid脚本驱动的软件项目模块图形化表述思路
说明：
正文：
- 说明：这里记录了如何使用mermaid脚本语言来作图，从而更清晰明了的表述软件项目的模块关系及信令数据交互流程，作为软件工程和管理的一种必备手段和方法论建议。
OAA
目的
- “OAA”即“One Picture Above All”，含义是“一张图，胜千言”。
- 我们期望用脚本语言来画图，并方便观看，而图是描述信令流和数据流的好方法。
- 我们只考虑两种图：“flow chart”流程图和“sequence diagram”时序图（也叫“泳道图）。
- “flow chart”：描述组网拓扑结构和模块实体间的关系；
- “sequence diagram”：描述多个网元之间回合制的信令和数据交互的时序信息；
- 结合使用这两张图，一般就能描述绝大多数的工程和项目场景。
- 我们只考虑两种图：“flow chart”流程图和“sequence diagram”时序图（也叫“泳道图）。
- 用mermaid脚本语言还有格外的好处如下：
- 脚本语言，容易编辑和维护，比二进制的诸如word/powerpoint，及图形JPG要方便；
- 基于字符串，方便合并，观察，版本维护，放入GIT/SVN非常的小；
- 文件小，方便随意的黏贴，拷贝，交互，传输，讨论和修改；
- 总之，OAA是一种态度和方法论，用不用随你项目和人力而定，建议使用；
说明
- 本项目是作为脚本作图语言mermaid的一个使用的例子，方便使用者继续创作脚本图；
- 信息：
- mermaid官网；
- mermaid在线测试
- mermaid源码@github（可惜的是release发布到7.0.0只有就没了，作者似乎不在github维护了！）
- mermaid源码@https://unpkg.com/mermaid@xxx/dist/，请自行选择版本；
- 其中“dist”目录用于JS当中的CDN方式引用“mermaid.min.js”等；
- 其中“src”目录用于查看源码（比如github上不维护的版本新！已经到了8.X版本了！）
- 另外，源码中作者用scss的格式存放可编译的css的源码，scss文件可以通过指定的编译器生成为目标css。
- CDN调用方式如下：
<script src="https://unpkg.com/mermaid@8.0.0-rc.8/dist/mermaid.min.js"></script>
使用
- 请从OAA@Gitee项目查看具体情况，建议项目经理PM或敏捷开发Master可以了解下。
Example
- 详见具体上面开源项目
END
最新文章
- linux 查找文件或目录
- Flex4的可视化显示对象
- Android GUI系统
- MySQL关键字（保留字）列表
- 在Navicat for MySQL中打开视图时，提示视图没有主键的问题
- 关于bootstrapValidator提交问题的解决
- ASP.NET中后台注册js脚本攻略（转）
- 提示29. 怎样避免延迟加载或Load()阅读器问题
- web前端开发分享-css,js进阶篇
- nosql学习一
- 洛谷 P3367 【模板】并查集
- HDU 4649 Professor Tian
- 我用过的linux命令--安装Hadoop
- 2016"百度之星" - 资格赛（Astar Round1） Problem C
- 在基于TypeScript的LayaAir HTML5游戏开发中使用AMD
- ajaxSetup设置Ajax请求的默认值
- Injection of autowired dependencies failed
- JS操作数组-2
- 海纳百川而来的一篇相当全面的Java NIO教程
- Unity Shader-后处理：简单的颜色调整（亮度，饱和度，对比度）