如何书写标准化的数据字典和详细设计文档.docx

如何书写符合标准的数据字典与详细设计文档 先让我们以开发过程为主线，看一看各主要文档在开发过程中的作用。首先，我们有了一个需求（当然，这个需求根据不同的实际情况，它的详细程度会有较大的出入），我们通过这个需求，对需求进行认真的分析，并出据了《需求分析说明书》。我们通过对需求的分析，可以初步总结出该需求包括几个模块，模块之间的边界，各模块的功能、系统重点、系统难点等，从而形成《概要设计》。（《概要设计》完成以后，可以开始着手进行UI设计。）通过《概要设计》与《需求分析》抽像出这个需求由哪些对象组成，每一个对象由哪些属性组成等。我们需要把对“对象”的说明进行记录，记录后形成的文档是《数据字典》。数据字典中记录某个需求包括哪些对象，这些对象包括哪些属性，每个属性的性质等内容从而形成了数据库的表结构和程序中的bean对象。然后是完成《详细设计》文档。在详细设计文档的整理过程中我们会发现更多的细节问题，这些细节会导致数据字典的变更，也有可能会导致之前已完成的部分《详细设计》文档的变更。这时，我们都应实时的对应这种变更。这也是为什么在详细设计完成之前不能进行实质性的开发的一个因素。有了详细设计后，我们就可以进行代码开发了，与此同时也可以开始进行测试用例的整理工作，从而使今后的开发与测试均源于同一个详细设计，从而使软件的测试效果在理论上得以保障。同时，在条件允许和项目需要的情况下，我们也应开发一套业务逻辑演示程序，与客户进行沟通，从而进一步提高咱们所开发出来的系统与客户的愿望的一致程度。（但，这从时间说来得急吗？等客户有了反馈后，咱们可能早就作了大量的开发工作了。这是可以解决，请往下看。） 家德瑞根据多年的经验，总结出一套尽量简单、尽量适应于更多的情形、符合国际标准的详细设计模板。用户可以根据详细设计模板进行模仿、套用。 在本文我们将重点关注数据字典与详细设计这两个文档。下面就如何编写符合家德瑞标准的数据字典与详细设计进行详细说明。 当有了《数据字典》后，家德瑞可以通过其Maker工具直接生成以“对象（即数据库中的表）”为目标的标准化程序（针对于目标对象的增、删、改、查等功能），并可以达到直接运行的程度。从而大大提升了软件开发的速度。 程序开发经历了非可视化开发到可视化开发，现在家德瑞提出了自动生成的标准化开发。有了家德瑞，程序是想出来的，而不是写出来的。 家德瑞自带的自动生成工具Maker在工程管理的标准化与软件开发的标准化的思想下可以帮助我们自动完成以下内容： 通过数据字典自动生成数据库的相关脚本 通过数据字典自动生成相关数据表的增、删、改、查等功能，并达到了生成后可以直接运行状态。 通过数据字典自动生成与标准程序相对应的详细设计文档。 通过自定义的详细设计文档生成符合实际业务流程的主干程序。 家德瑞的自动生成工具Maker可以在  HYPERLINK /detail/home_dear/4028211 /detail/home_dear/4028211 进行免费下载。更多关于Maker工具的相关信息，可以参考《家德瑞入门教程及实例源码》（/detail/home_dear/4029277）一文。 家德瑞的《数据字典》的编写是有一定的标准的，下面就将具体编写中需要注意的事项进行说明。 为了能提高大家编写数据字典的效率，家德瑞提供了一个《数据字典》样例，它是一个Maker可以识别的excel文件，我们可以进行免费下载，具体下载地址是： HYPERLINK /detail/home_dear/4028511 /detail/home_dear/4028511。 数据字典的书写很容易，需要注意的问题有： 我们应首先将项目分成几个模块，一个模块中的表放到一个数据字典中，建议一个数据字典文件的表个数不要超过30个，否则反而会将加大整体的复杂性。 一个表就是数据库中的一个表，同时也是程序中的一个bean。 “所有表信息”sheet面中的每一行就是一个表，注意这里的表名必须与后面的某个sheet页的名字相一致。在那个名字一致的sheet页中会具体说明这个表的属性信息。 “一对一关系信息”记录表的一对一关系信息。免费下载的试用版不支持此功能。 “一（多）对多关系信息” 记录表的一对多或多对多关系信息。免费下载的试用版不支持此功能。 最需要注意的是表名、字段名以及与之对应的对象名、属性性、包名等的命名规则。具体命名规则在 HYPERLINK /detail/home_dear/4029277 /detail/home_dear/4029277中有详细说明。 详细设计文档的书写相对复杂一些，但也无防，家德瑞的Maker工具不仅提供了从《数据字典》转成标准化程序的功能，同时它也提供了，从《数据字典》生成标准化程序所对应的详细设计文档功能，