Huauauaa / cheat-sheet

https://huauauaa.github.io/cheat-sheet/
0 stars 0 forks source link

规范?最佳实践? #24

Open Huauauaa opened 2 years ago

Huauauaa commented 2 years ago
Huauauaa commented 2 years ago

前端技术设计文档模板

1. 概述

1.1 需求背景&价值

为什么要做这个需求,价值在哪里,背景是什么

1.2 前置概念

下文出现的一些词汇的概念解释

2. 相关文档

列举对理解此次需求和设计方案相关的文档,包括但不局限于以下内容,可进行补充。

3. 项目排期

3.1 任务拆解

项目拆解后的详细工时

3.2 项目里程碑

包括但不局限于以下内容,可进行补充。

事项 日期
需求评审 202x 年 xx 月 xx 日
技术评审 202x 年 xx 月 xx 日
版本提测 202x 年 xx 月 xx 日
交互走查 202x 年 xx 月 xx 日
版本发布 202x 年 xx 月 xx 日

4. 总体设计

4.1 参考规范

讲述开发遵循的技术规范,包括但不局限于以下内容,可进行补充。

序号 规范名称 规范地址
1 政采云前端开发规范 xxx
2 政采云接口规范 xxx

4.2 架构图

按需设计

5. 内部实现

各个模块的实现细节

5.1 模块一

5.1.1 功能说明

该模块的具体功能

5.1.2 流程说明

对功能流转进行说明,主要需包含正常流程和异常流程

5.1.3 模块详细设计

从技术的角度讲述功能的实现思路。流程、时序方面必须用图示

5.1.4 外部依赖

对接口、其它业务组件的依赖

6. 技术分析 Checklist

序号 技术分析自检项 技术分析自检项
1 本次改造对原有功能需求的影响范围,包括以前交互,视觉设计
2 是否可提取出公用组件
3 数据结构变更是否考虑老数据兼容
4 是否影响移动端
5 操作是否做了防重处理
6 兼容性(浏览器、分辨率、主题)
7 团队 Code Review Checklist
8 ....

7. 测试数据

涉及到的测试数据。譬如提前准备的商品、账号信息。

8. 测试重点

测试需要重点关注的部分, 对现有业务和组件的影响点