写ERD的一点体会

最近在做一个新的项目，需要写ERD（全称是Engineering Requirement Document）。谈谈我的一些体会吧。

1. 什么是ERD？

高科技技术公司一般可分为Business Driven和Techinical Driven。在Business driven的公司里面，任何工程项目都是为了达成一定的商业目的，因为公司本质就是为了赚钱嘛，绝大多数公司都是属于这类。而在Teninical drive的公司里面，项目可能就是为了研究新技术，SUN就是典型的这样的公司。工程师应该很喜欢这样的公司，因为成天都在研究很新奇的技术。但是研究出来的技术也许很先进，但是用户不买单也没用，所以SUN被收购不足为奇了。

那么ERD是什么呢？简单地来讲，ERD就是在Business driven的公司里面，为了达成一定的商业目的，从工程的角度来讲应该实现哪些功能。工程是为商业服务的。如果一个功能对商业没有价值的话，其优先级也将被设定为低优先级，哪怕从工程的角度来看这个功能很好。

写ERD的注意事项和建议

1. ERD应只关注需求，避免深入细节
   工程师在写ERD的时候，经常不自觉地就考虑到一些实现细节。如果一个人在思考的时候，陷入这些细节，影响也还比较小。如果是几个人都这样了，就会陷入无休止的技术讨论中。
   比如，对同一个需求，可能有不同的实现或者部署方式，比如可以做成客户端，也可以做成Web的。但是两种方式都能满足需求，理论上不应在ERD里面关注实现或部署方式。而应该在ERD定下来后，再考虑不同的实现部署方式，评估每种方式是不是都能满足需求以及实现它们的成本。
2. ERD应只关注high-level的需求
   ERD应只关注high-levle的需求，比较软件支持哪些平台，能做什么事情。ERD不应关注UI上按钮摆在什么位置。
3. 建议：首先定义术语
   在开始一个新项目的时候，老板告诉你，你去做这个PAT的项目。也许，在ERD里面，你可能会大量的使用PAT这个术语，比如PAT要实现这个功能，实现那个功能。但是PAT本身是很抽象的名字，很多地方都可以用这个词。也许你认为PAT代表这个意思，别人却理解成另外的意思。这就造成了沟通中的误差。
   所以，建议首先定义好术语，比如PAT表示什么。如果这个项目有几个子模块，也把它们定义清楚。这样，一是可以避免沟通中的误差，而是在描述需求的时候可以避免涉及到具体实现细节。比如，ERD里面说PAT Interface要有这些功能，但是这里没有说死PAT Interface到底是一个客户端还是一个Web应用。

这就是我目前得到的一些体会，不足之处还请补充。