app设备信息采集详细设计文档.doc

app设备信息采集详细设计文档项目名称文档类别文档编号版 本密 级版本修订记录版本日期描 述作者审核V1.02016/05/16初始版本张宗君1 引言1.1 参考资料请提供本文档编写过程中所有主要参考资料列表（文档或者链接）文档编号文档名称作者发布日期链接1.2 运行环境JDK1.7相关软件配置如下：软件版本备注JDK1.7基于jdk1.71.3 项目依赖 ID项目名称项目描述项目负责人（技术负责人）1.4 需求风险和假设请列举目前系统面临的风险点和可能碰到的瓶颈。风险和假设具体计划可能性0%2 详细设计2.1 需求规定 设计目标 目标#参数描述吞吐率响应时间数据存储量2.1.1 功能需求会员后台需要指定会员做app消息推送，因此需要根据会员Id找到会员设备的deviceToken。因此在此需求之前，我们要收集会员和会员app设备deviceToken之间的关系。数据统计项目也需要收集app设备信息。2.1.2 质量需求2.2 设计说明在适配层adapter设计appInfo表存储app用户的设备信息（可以是会员，也可以不是注册会员）。app用户一开打app，就可以将ukey（注册会员，并登录后才有） 和 如下信息通过HTTP接口采集到适配层：ukeyString用户每次登陆app后生成，每次都不一样，注册会员，并登录后才有；与以下信息是0:N的关系否uuidString设备唯一码*是设备唯一码(和设备硬件、系统有关）deviceTokenString设备推送token*是做消息推送需要使用该字段，和uuid是1:1对应的appVersionString应用版本否eg.V2.4.0platformString系统否IOS|AndroiddeviceModelString设备型号否eg.iphone 6sosVersionString系统版本否eg.IOS8.4channelString渠道否eg.appStore | 应用宝latitudeString设备纬度否longtitudeString设备经度否然后各个模块按需获取：可通过dubbo接口获取。2.2.1 系统物理部署图提测之前提供2.3 服务接口设计适用于当前系统中服务接口设计及其调用应用系统集成。2.3.1 适配层新增http接口 (供前端调用)：app设备信息通知接口： notifyAppInfo用户打开app(IOS/Android) 设备后调用此接口，将app信息采集到系统适配层。服务名：notifyAppInfoukeyString用户每次登陆app后生成，每次都不一样，注册会员，并登录后才有；与以下信息是0:N的关系否可为空uuidString设备唯一码*是设备唯一码(和设备硬件、系统有关）deviceTokenString设备推送token*是做消息推送需要使用该字段，和uuid是1:1对应的appVersionString应用版本否eg.V2.4.0platformString系统否IOS|AndroiddeviceModelString设备型号否eg.iphone 6sosVersionString系统版本否eg.IOS8.4channelString渠道否eg.appStore | 应用宝latitudedouble设备纬度否longtitudedouble设备经度否以上所有的参数都以json的形式放入到data参数中post提交JSON 样例：data = ukey : asde22sdq212ds1d201,uuid : “asdsa23owieuu29323”, deviceToken : “asd12sad121asda56sda122”,appVersion: ”V2.4.0”,platform : ”ios”, deviceModel: “iphone 6s”, osVersion: “ios8.4”, channel: “appStore”, latitude : “12.11”, longtitude: “89.11”返回类型说明必填备注dataObjectdata = ukey : asde22sdq212ds1d201,uuid : “asdsa23owieuu29323”, deviceToken : “asd12sad121asda56sda122”,appVersion: ”V2.4.0”,platform : ”ios”, deviceModel: “iphone 6s”, osVersion: “ios8.4”, channel: “appStore”, latitude : “12.11”, longtitude: “89.11”*是codeint1. 成功， 非1：失败是messageString成功，失败，失败描述否JSON 样例： code : ”1”,message : ”成功”,data : ukey : asde22sdq212ds1d201,uuid : “asdsa23owieuu29323”, deviceToken : “asd12sad121asda56sda122”,appVersion: ”V2.4.0”,platform : ”ios”, deviceModel: “iphone 6s”, osVersion: “ios8.4”, channel: “appStore”, latitude : “12.11”, longtitude: “89.11”2.3.2 适配层新增dubbo接口 (供会员中心调用)：会员中心查询会员最近一次登录app对应的deviceToken 以便做app消息推送。服务名：getPartyLastDeviceToken入参类型说明必填备注ukeyString前端传递ukey，后端转化为custId来处理会员逻辑*是返回类型说明必填备注ukeyString*是lastDeviceTokenString最近一次登录app对应的deviceToken*是codeint1. 成功， 非1：失败是messageString成功，失败，失败描述否3 数据模型设计3.1 数据量增长3.2 数据流程图3.3 数据逻辑结构设计会员ukey: 用户每次登陆后生成，每次都不一样，注册会员登录后才有；与ukey以下信息是0:N的关系.3.4 数据物理结构设计3.5 数据库集群设计3.6 缓存设计3.6.1 缓存使用场景 Redis3.6.2 缓存容量规划3.6.3 缓存高可用需求3.6.4 数据结构说明数据字段key名称定义数据类型字段值定义备注4 定时任务和批处理应用设计4.1 定时任务/批处理任务目的4.2 容量规划请列举批处理应用程序运行的频率。4.3 批处理应用使用框架4.4 批处理应用逻辑/算法描述4.5 异常处理以及对系统的影响5 监控设计5.1 列出需要监控的重要业务指标5.2 业务指标的监控如何实现6 安全性设计在产品设计、开发过程中必须满足产品设计与开发安全红线要求：6.1 网络安全类别详细说明访问控制系统是否提供外部用户访问？并说明用户类型或来源 系统是否存在与第三方系统交互的情况？ 6.2 应用安全类别详细说明1) 认证说明业务系统认证方式、接口认证方式、后台管理认证方式、及认证失败处理措施2) 授权1）系统是否实现权限分离：系统管理、普通管理、审计等权限分离（采用最小授权原则，分别授予不同用户各自为完成自己承担任务所需的最小权限，并在它们之间形成相互制约的关系）；2）是否接入中央授权系统3) 审计对关键操作行为记录是否包括日期和时间、类型、主体标识、客体标识、事件结果等信息，记录不可被篡改、删除。4) 账号是否使用了网站会员系统，如果是则确认是否接入了FDS系统5) 容错是否对输入的数据进行有效性检验 6) 资源控制1）是否允许同一用户账号在同一时间内并发登录？2）是否设置登录终端的操作超时锁定和鉴别失败锁定；7) 内容安全是否存