其他分享
首页 > 其他分享> > 一份完整齐全的技术方案文档

一份完整齐全的技术方案文档

作者：互联网

2022年-[归一计划三期-用户中心三期第二阶段]技术方案

部门：基础架构部

时间：2022.02.25

1、背景

描述技术方案的背景

由于历史原因，旧服务存在很多代码不规范、冗余度高、扩展性差等问题，为了解决此类问题，以及将功能进行清晰的模块化划分，为以后用户中心隔离打好基础，需要将旧服务用户相关的功能或接口进行重构，下沉至新用户中心

旧服务用户相关旧接口：

接口地址接口描述调用方3个月内请求量2周内请求量开发阶段顺序
checkOrganizationState查询店铺异常C端（小程序）
addAllGoodsAdditionPrice一键加价（全局）B端（小程序、APP）
/weiXinUser/addWechatUserGroup记录用户所属用户群C端（小程序）
/user-tag/get-tags.action用户标签C端（小程序、APP）

接口地址接口描述调用方3个月内请求量2周内请求量开发阶段顺序
/weiXinAgreement/grantUserAgreement用户协议同意C端（小程序）314169169686584
/weiXinAgreement/getUserAgreementInfo查询用户协议是否同意C端（小程序）1562389863210
/weiXinUser/initWeiXinUserInfo微信用户授权初始化C端（小程序）390172125239
/weiXinUser/updateAllIsShowStoreGoodsGroup全局设置店铺是否显示分组B端、C端（小程序、APP）74632352
/weiXinUser/checkRealIDCard身份证实名认证检测B端、C端（小程序）13875102605118

2、业务流程图

用图描述此技术方案的实现处理过程

检查店铺是否异常接口

一键加价

记录用户所属微信群

用户标签

用户同意协议接口

用户初始化

设置全局的是否展示分组

身份证实名认证检测

3、领域模型

列出需求对象、关键属性和对象之间的关系

4、数据库设计

4.1 表关系图（对应：领域模型）

ER图

2 表设计

表的数据字典设计

无

4.3 SQL语句设计

SQL语句设计，例如索引技术、分区字段使用等。如没有，则写无

BTREE

无

5、技术要点

5.1 核心内容

简要体现后续工作的主要内容和难易程度，目的在于让文档阅读人员快速抓住重点。

5.2 系统架构图

整个架构最终的输出模型状态。如果是部分重构或新增部分，可以用不同颜色区分新旧部分

5.3 相关UML图

有多种状态需要说明的，则附加，例如泳道图等。如没有，则写无

以下新序列图按方案一编写，方案二相对于方案一少了新服务的调用，暂不单独出图

5.3.3 查询店铺是否异常

（旧）

不支持在 Docs 外粘贴 block

(新)

不支持在 Docs 外粘贴 block

5.3.4 一键加价

(旧)

不支持在 Docs 外粘贴 block

(新)

5.3.5 记录用户所属微信群

（旧）

（新）

6、接口设计

用户中心swagger
（为了规范参数名字的命名，下面的红色参数为改动的参数，字段意思不变，只是修改了参数名字，表示店主id）

入口(小程序、APP)

接口名称

旧接口 (plus)

旧接口入参

新接口入参

新接口 (weeget-bullet-user-rest)

小程序

查询店铺是否异常

/weiXinUser/checkOrganizationState

{

"organizationId" : 135700927

}

{

"organizationId" : 135700927

}

/user/organization/checkOrganizationState

小程序

一键加价

/weiXinUser/addAllGoodsAdditionPrice

{

"organizationId":135700927,

"additionPrice":123836168,

"groupId" : 111

}

{

"organizationId":135700927,

"additionPrice":123836168,

"groupId" : 111

}

/user/organization/addAllAdditionPrice

小程序

记录用户所属微信群

/weiXinUser/addWechatUserGroup

{

"organizationId":135700927,

"userId":123836168,

"encryptedData",

"iv": "asd123jk4j32",

"openGId" : 1,

"userGroupName": "aaacde"

}

{

"organizationId":135700927,

"userId":123836168,

"encryptedData",

"iv": "asd123jk4j32",

"openGId" : 1,

"userGroupName": "aaacde"

}

/user/saveUserGroup

小程序

用户标签

/user-tag/get-tags

{

"userTagId": 0

}

{

"userTagId": 0

}

/user-tag/getUserTag

入口(小程序、APP)

接口名称

旧接口 (plus)

旧接口入参

新接口入参

新接口 (weeget-bullet-user-rest)

小程序、APP

用户同意协议

/weiXinAgreement/userAgreementInfo

{

"agreement" : 1,

"userId" : 1,

"application" : 1

}

{

"agreement" : 1,

"userId" : 1,

"application" : 1

}

/weiXin/userAgreementInfo

小程序、APP

微信初始化接口

/weiXinUser/initWeiXinUserInfo

{

"userId" : 1,

"organizationId" :135700927，

"wechatName": 微信名称,

"portraitUrl": 头像地址,

"inviteUserId": 拉新活动分享用户,

"isPushInvitation": 是否推送,

"encryptedData": 加密数量,

"iv": iv

}

{

"userId" : 1,

"organizationId" :135700927，

"wechatName": 微信名称,

"portraitUrl": 头像地址,

"inviteUserId": 拉新活动分享用户,

"isPushInvitation": 是否推送,

"encryptedData": 加密数量,

"iv": iv

}

/weiXin/initWeiXinUserInfo

小程序、APP

设置全局店铺是否显示分组

/weiXinUser/updateAllIsShowStoreGoodsGroup

{

"organizationId":135700927,

"groupId" : 111,

"isShowStoreGoodsGroup":是否显示店铺分组,

"isShowSystemSecommendation": 是否系统推进店铺分组

}

{

"organizationId":135700927,

"groupId" : 111,

"isShowStoreGoodsGroup":是否显示店铺分组,

"isShowSystemSecommendation": 是否系统推进店铺分组

}

/weiXin/updateAllIsShowStoreGoodsGroup

小程序、APP

身份证实名认证检测

/weiXinUser/checkRealIDCard

{

"idNo": 身份证号码,

"name": 身份证姓名

}

{

"idNo": 身份证号码,

"name": 身份证姓名

}

/weiXin/checkRealIDCard

6.2 C端：接口性能指标

2021-性能测试基准v1.0
目标值：指压测前初步评估值
实际值：指经过压测后实际值

压测接口汇总.xlsx

指标项

目标值

实际值

接口平均耗时

200ms以内

压测：单pod支撑QPS值（4C8G）

200QPS

接口成功率

99.99%

压测：总QPS值

pod数等压测结果来确定

旧接口qps值，查看阿里云arms的5分钟，全部pod的QPS总值，QPS总值 / 300 = 每秒总QPS值

单pod 的 qps = 每秒总qps / 云pod总数量

plus：25个pod，4C20G

接口地址接口描述每秒请求数rt（ms）大促QPS大促rt
/weiXinUser/checkOrganizationState.action查询店铺异常3
/weiXinUser/addAllGoodsAdditionPrice.action一键加价0.5
/weiXinUser/addWechatUserGroup.action记录用户所属用户群0.2
/user-tag/get-tags.action用户标签0.03

找一下大促的数据

发截图

7、非功能性设计

注：研发人员在做接口设计或功能设计是需要考虑如下点来进行设计。

7.1 扩展性设计

至少需要考虑未来一年的存储容量、并发等的扩展支持。如没有，则写无
前端：拆分可复用的组件、封装工具库等，如不需要，则写无

7.2 兼容性设计

接口应该兼容旧版应用，向下兼容；系统兼容、数据结构兼容等。如没有，则写无
前端：微信/浏览器api兼容性处理，屏幕/机型兼容性处理，ES语法兼容性处理等，如没有，则写无

7.3 一致性设计

例如缓存与数据库数据的一致性等

l2cache缓存框架来实现

7.4 并发问题设计

超领、超卖等。如没有，则写无

分布式锁

7.5 幂等性设计

重复请求、重复消息等。如没有，则写无

无

7.6 高性能设计

高可用、高并发设计说明，如缓存、SQL索引技术、分页等。如没有，则写无

无

7.7 异常处理

超时处理，已知异常处理，未知异常处理。如没有，则写无
前端：接口异常处理、页面超时提醒、内存溢出、CPU占用过高等，如没有，则写无

7.8 异常恢复

回滚方案，异常恢复方案 。如没有，则写无
前端：超时触发刷新页面，刷新无效重定向首页等，如没有，则写无

无

7.9 禁用设计

业务开关、功能开关等，非必要功能同时应用在高并发场景下必须。如没有，则写无

设计接口切换开关，测试一下新接口有问题，立刻切换旧接口

设计开关切换，nacos配置格式

存放开关文件: controller/common/SwithController.java

user.switch.part3v2:true

默认ture 新接口 ，设置false表示使用旧接口

nacos配置如下:

user:

switch:

part3v2: true

注：part3v2 ， 表示part3 代表期数也就是3期，v2表示2阶段

7.10 N+1设计

系统中的每个组件都应做到没有单点故障。如没有，则写无

7.11 监控设计

在设计阶段就要考虑监控的手段 。如没有，则写无。
超领、超卖等业务监控。
前端：页面超时上报，JS报错上报，接口异常上报等，如没有，则写无

7.12 资源隔离设计

应避免单一业务占用全部资源。如没有，则写无

7.13 安全性设计

支付安全、防篡改、数据安全等。如没有，则写无

7.14 模块化、组件化设计（前端技术方案专用）

通用的功能组件，比如分页组件，Loading组件，ModalDialog组件。通用的业务组件，比如站点通用头部，通用footer，通用分享组件。

详见：

7.15 弱网络处理策略（前端技术方案专用）

离线缓存，HTTP Cache，Service Worker 和 Cache Storage API，Workbox

详见：

7.16 移动端适配方案（前端技术方案专用）

  1. vw vh: postcss-px2viewport
  2. rem: postcss-px2rem

详见：

7.17 静态资源处理（前端技术方案专用）

图片资源CDN上传，，如没有，则写无

详见：

7.18 用户体验设计(前端技术方案专用)

首屏数据秒出(默认数据占位+复用数据显示)，耗时不超过250ms(过度动画)，如不需要，则写无
滑动帧率维持60 fps，如达不到，则写出原因
选择正确的图片尺寸，如不需要，则写无

详见：

7.19 数据影响范围

  1. 对新增数据是否有影响？对历史数据是否有影响？
  2. 历史数据影响的数据量是多少？

详见“5.4 老旧数据兼容、迁移方案”

8、系统资源评估

列出系统用到的微服务和阿里云中间件，或新增资源，或复用现有资源。如没有，则写无

8.1 系统流量评估

主要对流量大的服务做一个评估，服务清单及各负责人见：

8.1.1 总体流量评估

流量的变化可能增加(+)也可能减少(-)，如果是重构项目，旧服务有些接口已经逐步废弃，流量预估变化是：-xxxQPS

8.1.2 C端接口流量评估（包括本服务的接口和调用其他服务的接口）

流量的变化可能增加(+)也可能减少(-)，如果某个接口接入的业务场景减少了，流量预估变化是：-xxxQPS；如果接口流量变化预估超过5QPS的，都要写下来。包含但不限于整个全链路的请求评估

说明：减少的QPS主要是基于发表评价和查询评价的内容独立到新的服务，所以原服务此部分流量减少，发表评价和查询评价实际QPS极低，10QPS属于粗略评估

接口所属服务

服务负责人

接口url

流量预估变化

8.2 数据库资源

9、生产服务部署 （前端项目可以写构建方案、打包方案等）

上线后云服务器数量和配置等。如没有，则写无。
注：Pod数不能出现单点，即不能只部署1个Pod，至少3个+

忽略

10、人力计划排期

10.1 预计所需人力：

FTO：@王

10.2 时间计划：

事项

时间

涉及部门

主负责人

配合人员

技术方案

架构部

王

框架搭建 + 基础设施

架构部

后端开发时间

2021.12.23 ~ 2021.12.31

架构部

王 合并 两个开发版本一起提测

前端开发时间

前端部

前后端联调

架构部

前端部

功能测试

边界测试

破坏性测试

安全检测

2022.03.14 ~ 2022.03.15

架构部

前端部

测试部

压测测试

架构部

前端部

测试部

集成测试

2022.03.16

架构部

前端部

测试部

预发布验收

2022.03.17

产品部​

系统上线

2022.03.17

架构部

前端部

测试部

2021-12-22 14:30:00 会议初步确认，以及一些纪要：

2022-02-15 15:00 会议纪要:

标签：前端,用户,接口,完整,文档,weiXinUser,设计,齐全,user
来源： https://blog.csdn.net/wm31898/article/details/123134147