数据库以及API文档要求

1.首先记住文档优先级高于代码。

一个好的API文档,可以让人的思路瞬间清晰,让人看完文档就知道要实现什么功能,使用那些接口,以及接口的所需要的参数。

一个好的数据库文档,可以让人眼前出现数据库的全部样貌,出现数据库的数据基本类型,让人一眼就看的出来该数据库的设计,逻辑等。

2.数据库文档格式:

1.概念结构设计:

将表名规范化,让人一眼就知道这个表是干什么的,

2.逻辑结构设计(关系模型) 如:

1系统数据

1.1 单词表(单词编号,单词,是否为新)

1.2 报警级别(编号,编码,级别名称)

2用户数据

2.1 关键字(编号,关键字,关键字分组,创建时间,搜索结果条数)

2.2关键字对应字典表(编号,单词编号,关键词编号)

3.视图

这个可以省略因为在mysql上更多的是left join on 来完成

3.表结构设计

 

三。API文档 

猜你喜欢

转载自blog.csdn.net/qq_33188563/article/details/81367277
今日推荐