多身份详细设计.docVIP

基线多身份详细设计方案 修订记录 版本编号 *变化 变更内容 日期 变更人 批准日期 批准人 1.0 A 初始版本 2017/8/17 杨峻峰 1.0 M 多身份切换流程 2017/8/21 张汪德 1.0 M 基础数据设置多身份的流程、数据结构设计 2017/08/21 周东 *变化状态：A——增加，M——修改，D——删除 科大讯飞 教育产品事业部 目录 TOC \o 1-3 \h \z \u 基线多身份详细设计方案 1 1. 引言 3 1.1 编写目的 3 1.2 项目背景 3 1.3 预期读者 3 1.4 阅读建议 3 1.5 缩写与术语 3 1.6 参考资料 4 2. 程序模块描述 5 2.1 模块上下文 5 2.1.1 多身份设置 5 2.1.2 多身份切换 5 2.2 模块描述 6 2.2.1 基础数据管理平台 6 2.2.2 多身份切换 6 2.3 关键技术【算法、优化等】 6 2.4 流程/逻辑 6 2.4.1 基础数据管理平台 6 2.4.2 多身份切换 7 2.5 数据结构设计 7 2.6 接口设计 8 2.6.1 基础数据管理平台 8 2.6.2 openapi-login 8 2.6.3 basis-data-api 8 2.6.4 store-api 9 2.6.5 desktop-api 9 2.7 测试特别关注事项 9 2.8 其他 9 引言 编写目的 平台需要支持对身份，部分应用系统如桌面对同一用户不同的身份所显示的页面内容会有所不同，则需要进行身份切换。同时区域基线不同的子系统需要形成统一的身份切换解决方案。 项目背景 区域解决方案基线： 基础数据管理平台——管理用户基础数据（多身份设置） 多身份设置功能，及多身份设置接口开发 基础数据同步，包括中心及乐知行基础数据同步 EDCL平台 提供多身份切换功能 改造基础服务接口 平台应用商店改造 区域应用 多身份切换 部分区域应用系统业务改造 预期读者 区域基线开发人员 阅读建议 注意基础数据同步方案 注意多身份切换方案 缩写与术语 基线——区域解决方案基线 EDCL——区域应用集成平台 数据交换平台（basedata-exchange）——cycore用户服务同步基础数据至乐知行的数据交换平台 otter同步——区域用户服务同步至中心用户服务 portal——桌面管理平台或乐知行门户平台 store —— 区域应用商店 乐知行dubbo服务—— basis-data-api、store-api、desktop-api 桌面——个人桌面应用（desktop-web） 导航—— 个人桌面提供的平台统一导航 区域应用——基线自研M应用（如微课学习中心、安全监管、资源中心等应用的统称） sso —— 平台单点登录服务 openapi —— 平台开放接口 乐知行区库 —— edc35_cloud 乐知行校库 —— 智校应用校级数据库（每开通一个云校会创建一个校库） 参考资料 无 程序模块描述 模块上下文 多身份设置 基线平台由基础数据管理平台统计进行多身份基础数据的设置，其他如有设置多身份的需求（如桌面）则统一调用基础数据管理的http接口。 多身份切换 多身份切换操作统一由桌面导航进行，区域应用直接嵌入桌面导航js即可。 模块描述 基础数据管理平台 能够完成用户多身份设置，及对平台桌面提供多身份设置接口。 需要完成多身份基础数据对中心及乐知行的同步，完成数据同步。 多身份切换 能够完成平台身份的统一切换，并提供集成方案给区域应用进行集成。 关键技术【算法、优化等】 流程/逻辑 基础数据管理平台 1、多角色数据流程图的设计 2、桌面设置老师和家长身份流程 多身份切换 首页登录流程 a)、用户登录首页，请求sso登录，获取全局会话标识。 b)、选取用户默认角色。 c)、以全局会话标识为key值，将角色及单位id信息存入到redis中。 d)、导航栏中写入用户角色信息，并将用户角色信息写到cookie中。 首次进入应用 a)、进入应用，进行sso登录验证，获取全局会话标识。 b)、通过login-api获取redis默认角色信息。 c)、生成应用session。 d)、将角色信息写到导航栏。 应用内进行用户角色切换 a)、设置用户角色单位ID到redis。 b)、修改cookie角色信息。 c)、修改导航中角色信息。 打开的多个应用页面 a)、导航栏中设置定时器，对比导航中角色信息与cookie中的角色信