1.概述
在开发实践中,一般开发过程是过程是:
- 产品或项目负责人,负责分析需求和设计。
- 负责人将需求交给开发人员,开发人员拿到需求后,负责人会将一些业务和需求及大概的设计和开发人员进行沟通。
- 开发人员需要将需求进行分析和设计,然后和负责人,团队成员,测试人员一起对设计进行评审,一起估算开发时间,并制定开发计划。
本文旨在描述一下,开发人员在拿到需求后,需要提交的开发和设计的详细文档,及文档的主要包含的内容。
该文档的作用在于
- 开发人员首先通过深入思考如何实现,并和负责人进行沟通,这样不容易走偏。
- 在产品交互时,也可以作为开发文档的一部分进行交付。
2.文档需要包含内容
2.1 需求描述
在这里对需求和业务场景进行描述,需要解决什么问题。
2.2 实现过程分析
这里主要写一下实现的过程,可以使用序列图或流程图对需求进行分析和分解。
2.3 界面原型
这里可以使用原型工具对界面进行初步的设计,可以和UI进行沟通。
2.4 数据库设计
这里可以使用POWERDESIGN对数据库进行设计。
3. 案例
下面以平台中的一个审计日志为例子大致描述一下这个文档如何写。
3.1 需求描述
在平台中有些情况下,我们需要记录审计日志,比如登录,退出登录,删除数据,保存数据等等这种,方便运维人员对平台用户系统中的用户操作进行分析和跟踪。
3.2 实现逻辑
我们可以使用流程图加文字进行描述
比如我们访问一个控制器方法。这个方法需要记录审计日志,那么我们需要在这个方法上增加注解。
记录日志流程
- 访问一个控制器方法。
- 判断是否有日志注解
- 如果有那么就产生一个审计日志对象
- 日志发送接口会将审计日志对象发送到队列。
- 通过消息队列记录日志。
3.3 数据库设计
文档更新时间: 2022-04-24 22:29 作者:zyg