Chinaunix首页 | 论坛 | 博客
  • 博客访问: 180389
  • 博文数量: 19
  • 博客积分: 0
  • 博客等级: 民兵
  • 技术积分: 1182
  • 用 户 组: 普通用户
  • 注册时间: 2013-02-20 23:47
个人简介

如果人生是一条隐含马尔科夫模型,那维特比算法告诉我已经偏离最优路线了,但如果起点是现在呢?

文章分类

全部博文(19)

文章存档

2020年(2)

2014年(3)

2013年(14)

分类: 架构设计与优化

2020-08-16 00:44:08

本人目前从事餐饮SaaS系统的建设,前几天在观摩RD的设计文档,发现一句话很绕口的话,经过分析后发现涉及到语法结构以及结构所传递的信息,因此觉得有必要记录下来,以供后续借鉴之用

只有接单后的预订单和XX订单才能够进入云端订单中心,在此之前,云端无法查看这类订单

上面这句话真实传递的意思是when而非what,即强调订单流程转到接单状态后,才会执行上传云端的动作,但是上面这个写法看起来是在强调特定的业务订单做XX事情,把读者关注点带偏了,而且跟后半句也有些南辕北辙

具体寻找答案的过程就不说了,直接说结论,常见的语句结构有主谓宾、主系表,主谓宾是系统运行架构图里用的最多的结构,例如顾客通过接口提交了订单;主系表比较内涵一点,订单确认收货超时变成已完成,因此很明显RD的写法是用了主谓宾结构,即:

“只有接单后(定语)的预订单和XX订单(主语)才能够进入(谓语)云端订单中心(宾语)”

这个写法不是病句,但给读者传递的核心信息歪了,变成了主谓宾所描述的动作了,如果要表达when,应该这么写

“只有预订单和XX订单(主语)变成(系动词)接单(表语)后才能够进入云端订单中心(状语从句)”

通过系动词强调状态的变化,结果状语从句描述变成接单状态后对主语可能造成的影响,大家可以仔细品味一下上述两种写法的差异

可能有人会问这么做是不是有些咬文嚼字了,但本人认为为业务过程确定最合适的句法结构有利于还原真实场景,并指导设计实现,提升系统的可变性、可扩展性;举例来说,有如下好处:

1. 如果我们把描述方式换成了A become B,那很明显这是状态机模型,应该使用MQAsyncAPI等手段对结果状语从句所描述业务逻辑进行处理(因果关系里面“因”可能并不依赖“果”的返回)

2. 主系表结构常见的用法还有A is B,细心的读者可能会发现这其实是一种泛化,A是一种B,那么相邻领域的A’是不是也是一种B,如果是的两者是不是有共同的逻辑可以复用?

综上所述,我们在用文字描述业务流程时其实是需要有意识的去感知所使用的句法结构的,不仅对于teammate之间的高效信息传递具有保证作用,还能够迸发架构方面的idea,提升系统的可扩展性、可维护性

阅读(594) | 评论(0) | 转发(0) |
0

上一篇:oAuth与SSO是一回事吗

下一篇:没有了

给主人留下些什么吧!~~