手机版师讯通设计方案

1 手机 版 师讯 通 设计方案 手机移动办公平台设计需求 景 北京灵泰克对平台主要是针对教育行业的一款综合性办公平台，为了提供更加灵活的办公模式，现增加安卓手机、 苹果手机 办公功能。辽宁 实验学校（简称辽实）现提出制定自己的 个 性 化移动 版，包括苹果、安卓两个版本的师讯通和家校通 客户 端。 求故事 录 设计 要求： （ 1） 安装后第一次登录，填写服务器信息 ， 如果已有设置信息，则直接进入登录界面。 （ 2） 页 面 设计 要求： （ 1） 前三个（ 实验 新闻。）固定 在 上面，下面有信息滚动时，不跟着滚动。 （ 2） 每 个人有新信息时，图标右上角有一个数量提示。 （ 3） 有 最新信息的排上面，没有的排下面， （ 4） 2 二、设计约束 体设计约束 （ 1） 服务器端与辽实对接的所有 件 均放在 /录 下。 （ 2） 原则上 向 客户端提交的数据均为 式 ,码 。 （ 3） 采取原型法设计，双方不要影响进度 ， 由客户 端 开发团队提出需 求、 接口、美工实现，双 方再实现 设计 。 （ 4） 分两阶段上线， 让 用户感知我们的进度。 每 期先实现师讯通，再实现家校通，实现联调、测试成功 后 进入下一期。 （快速 原型法设计模式 ） （ 5） 原则上采取第三方免费的插件库，如果包括本公司的，应有详细说明。 （ 6） 所有文档均以保存在群 文件 中的为准。代码、文档 （ 尤其是每天工作日志）要求日提交。 （ 7）必须 考虑完整不 同 的情况 和 容错机制。 （ 8）推送 内容 界 定： a)聊 天信息、 提醒信息 用于 推送 ，通过消息内容解析实现具体的业务。 b)向用 户服务 器推送 采取 两 种方式： 一 是 通过 第三方转发给用户服务器， 二 是客户端直接发送给用户服务器。 C） 表示 聊天 文字（ 图文）信息， 2：聊 天中的声音， 3： 聊天中的视频。 4： 文件， 5： 提醒消息。 容 描述。 如果是声音文件等，此处是网址。 师讯 通会有一个产品 于确认不同的应用；有一个 确认不同的人；有一个组于群发；消息内容，分为图文、声音、视频、 卓版设计 要求： 上版 本， 开发环境基于 17 版 本。 3 过 扫描 的方式下载，安装到本地。 发 版本号的方式。从 1、 2、 开 始 ，每 一 个 升级 增加一个版本号。 可能对 外会有一个 另 一个版本说法。 如 中 称： 导出源 代码包时， 最 后 加 一 个 X 代 表开 发版本号。 果版 设计要求 ： 以上。 过 扫描 的方式下载，安装到本地。 打 包时，采取企业级帐号打包、 分 发的方式。 发 版本号的方式。从 1、 2、 开 始 ，每 一 个 升级 增加一个版本号。 可能对 外会有一个 另 一个版本说法。 如 中 X 代表上面的开发版本号。 称： 导出源 代码包时， 最 后 加 一 个 X 代 表开 发版本号。 台接口测试 ： 6688 问 方式： 测试 件 ?6688&它 能数根据需要填写 如 ： 4 三、 详细设计 台提供的测试平台及平台地址。 学 校版 开 发测试服务器网址 测试环境： 试帐号： 部门 ： 三 年级教研组， 姓名 ： 刘 测试， 帐 号： 密码 ： 111111； 部门 ： 职能 部门， 姓名 ：魏总， 帐 号： 密码 ： 111111； 测试流程： 交流 测试： 通过 办公平台访问： ， 使用帐号登录后，进行消息管 理 ： 发消息时直接全选。 发送 的消息的接收的消息均可在 办 公平台看到。 发 送通知 ： 号具有发通知权限， 在 选择人员 处 选择三年级教研处的 刘 测试即可。 5 计原则 师讯通） 只针对教师人员。 这些操作都是在后台进行控制，与手机端无关。 是 是网页数据（ 三 是 交，不 要 使用字符集转换或进行十六进制转换， 对 于 则需要进行转换 ，以 防止出现特殊字符 ，但 转换后会出现字符集问题 ， 原则上向服务器提交应 使用 端所有访问的文件均在 / 以同时登录 ，信息 双方同时获取 ， 根据已阅读的标记，直接标记为已读，只是本地进行保存。 P 或域名开头，可以加上端口和相对路径，080/项在设置处进行管理。 7、 8条 ，暂不采取，采取 9条 方案。客户端采取定时查询机制，服务器端将根据用户的 情况返回一个应该返回的列表，客户端再根据具体情况进行分别获取的机制。 计为 5S 向服务器查询一次。其中根据时间和反馈信息采取可变时长等的策略，最长为 15S，最短为 3S，在电脑上网且不是免打扰方式，则延长轮询时间。 6 消息采取 第 三方 推送 方案。 第 三方 信息 ： 。（ 写 出基本的几个要求 ：钟 老师补充）。 迭代的方式，一是页面根据要求，设计完整的 。功能 实现可采取静态的方式，比如登录，可直接点击 确定 ，进入下 一 级页面。 二 是静态数据补充的 补充 要完整。 12:所 有 返回 均为 数据中应有一个 ，如果此标记 不存 在 或 大于 0，则表示为成功 ， 小于 0为 有问题。 除 登录外， 表示 为空 ； 表示 是合法值。 录 及用户状态 登陆设计 （ *） 访问文件： /XX&XX&交信息：帐号、密码、手机串号 密码需要加密，加密文件见附件 返回信息： 名 ； 人唯一码，整数； 人识别码，其值 包括 了 传送 的 后生成的一个值。 安卓版本版本号，是一个整数，每升级一个版号则加 1； 果 版本版本号，是一个整数，每升级一个版号则加 1； 返回信息说明： 一个唯一的数字 户名、密码、手机串号为空。 户名或密码错误。 机串号不正确。 机账号未开通。 台手机版未开通。 前用户密钥。 7 设计要求： 登录界面应该可以设置访问平台的网址、是否保存密码等选项。 传递 机串号。 退出 登录： /XX&强制 退出登录后，系统 应 处理不运行状态，并非 处于 后台运行状态。 版本 升级设计 每 一个 客户 端 中 均记录了一个本客户端的版本号，版本号是按 1、 2、 3 形式顺 序 递增 的 。 安卓 和苹果 各 自保留自己的版本号。 客户 端在获取服务器端版本信息后，向指定地方获取新的 序 。 版 本升级是采取登录 及 定 时 检测是否有新版本的方式，并根据安卓和苹果的特点，进行相应的处理。 返回 版本有两个地方： （ 1） 登 录 返回处，会 返回 不同的 版本。 7 7 2 1 1 注 ： 新 版本中已不使用。 （ 2） 在获取 人员状态处，会 返回 不同的 版本。 师讯 通： 校通： 更新版本时，均要 同 步 变更 此版本。 获取部门人员列表 访问页面： /递参数： 员编号 钥 返回信息： 8 部门标 号 ； 部门名称； 级部门 标 号 人员信息表； 员 名； 先显示 码 ； 所属 部门 线 状态； 像编 号； 像 文件 ； 机登录状态 ； 级 部门信息； 门编 号 ； 门名称； 上级部门编 号 ； 人员信息 。 属性同上； 级 部门信息，内容同上级部门信息。 说明： 级部门 级部门 级部门 级部门编号，顶级部门的上级部门编号为 0 员信息标 签，包括： 门编号 门名称 员编号 员姓名 在线交流功能 员显示序 号 ，人员排序按照 是 否在线，序号大的优先，同序号9 的 按 姓名的方式。 头像 更新 实现原理： （ 1）如果教师张三登录后，获得用户列表，手机端程序根据获取的人 员列表果 同或者 访问 载或者更新本地的文件。单个文件更新。 获取 教师状态 ： 师讯 通在当前 界 面下，应定时获取服务器的 教 师在线信息，获取后 重 新排序，将 在 线的教师显示在上面，不在线的显示在下面。对于 特殊 要求的，根据先 显示。 （ 1） 通过 获取教师状态信息，及 时 了解师讯通版本的变化，如果有新版本，将自动升级。 （ 2） 获取 教师状态信息后， 变更手机 中产门的人员列表状态，并 重 新排序：排序原则， 排 序原则比较复杂。一、 前 面全部是在线、后 面 全部是不在线。 二、 在 在 线人员列表中，或者不在线人员列表中，先按 到小 进 行排列，三、在 同的情况下，按姓名 进 行排列。 （ 3） 网页： /递参数： 前用户编号 录校验码 返回信息： 交参数传递不完整； 示提交的 表中不存在，或者没有自定义头像； 示 应的头像文件已不存在。 头像文件描述 ： 10 员 先 显示码； 否在线 ， 1： 在线， 0： 不在线； 手机是否在线 下载自定义头像： 网页： /递参数： 前用户编号 录校验码 获取头像的用户的编号。 返回信息： 交参数传递不完整； 示提交的 表中不存在，或者没有自定义头像； 示 应的头像文件已不存在。 正确 情况下： 头像文件流。 条件 查找联系人 ： 客 户端提 交 不 少 于 2 个 字的姓名关键字，用于搜索 教 师和学生。 网页： /递参数： 前用户编号。 录校验码。 名 关键字 。 员范围 ,1,仅 限教师， 2： 仅限学生，为空表示师生均可。 返回信息： 交参数传递不完整； 示提交的 表中不存在，或者没有自定义头像； 运行出错。 11 提 交 关键字小于 2 个 字符。 群中 增加人员 ： 将某 一 批 人员增加到一个群组中。 网页： /递参数： 前用户编号。 录校验码。 编 号 。 增加人员 人用逗号分隔。 返回信息： 交参数传递不完整； 示提交的 表中不存在，或者没有自定义头像； 运行出错。 空值。 理短消息 消息推 送 方案 ，采取使用极光 推送 的方案，具体网址： ： 客 户端不负责 推送 ，只需要将 消息 发送服务端 ， 由服务器端接收到消息后向极光接口推送。 等 完整实现功能后，测试客户端直接 推送 的可行性。 客 户端实现 推送 消息接收 ， 只包括 消息 类别（如 短 消息、提醒消息等）、 消息 条数。接 收到推送 消息 后 向服务器 获取具体 消息内容。 X v 1,+1, “ 师 讯通提醒 , 1, 321 , , +1, 321 , , 3600 , 60, 12 获取未读短信息数量 访问网页： /递参数： X&X 返回信息： 回未读短消息的数量，如： 11， 此信息用于告诉客户端还有多少条消息未读 。 获取短信息列表 访问接 口 ： /XX&递参数： 前页码，从 1 开始， 目前统一设 置 为 1； 发送人姓名； 发送人 如果此 本人的 说明是自己的电脑发送的 信息 。 服务器上 记录 的 短 消息 发送消息 时间 ； 手机是否已接收该消息，此标记 暂 不使用。 一个数字， 消息重要程度，一般或者重要，非常重要等； 件信息，“ ;”分割附件名称和下载地址；“ #”分割不同的附件。 在 设计时，获取消息后，则将这些消息提 交 到服务器上， 以 免服务器上重复发送。 更新个人未读信息状态 访问网页： /X&X&X， 返回信息：将此人在平台中的未读信息更新成已读状态 说明 ：为了防止重复提醒，此处的 设计 是如果服务器上已把消息 传递 给手机，则表示手机已经 接 收 ， 则自动转为 已 读状态 ， 引操作应在手 机 端获取 消息 列表后，立即处理。 13 有消息 的 通过 逗号分隔。 发送新消息 一 、点对点 交流 访问网页： /递参数：使用 员编号 钥 息内容 信人 ，使用“ ,”分割，如： 10001,10002 数： 递参数不完整 户验证失败 送失败 1：发送成功 二 、 组 发信息： 指 在 一 个组中发送信息，具体发送的内容与点对点发信息相同，但要增加一个组号参数。 接 口文件： 递参数：使用 员编号 钥 息内容 编号，为一个数字 返回参数： 递参数不完整 户验证失败 送失败 1：发送成功 三 、 部 门发信息： 14 指 在 一 个 部 门中发送信息，具体发送的内容与点对点发信息相同，但要增加一个组号参数。 接 口文件： 递参数：使用 员编号 钥 息内容 编号，为一个数字 返回参数： 递参数不完整 户验证失败 送失败 1：发送成功 发送文件 一 、点对点 发 送文件 访问网页： /递参数： 员编号 钥 息内容 信人 ，使用“ ,”分割，如： 10001,10002 还 有 附 件 文件。 返回信息： 递参数不完整 户验证失败 送失败 1：发送成功 二 、 组发 送文件 15 访问网页： /递参数： 员编号 钥 息内容 编号，为一个数字 还 有 附 件 文件。 返回信息： 递参数不完整 户验证失败 送失败 1：发送成功 三 、 部门发 送文件 访问网页： /递参数： 员编号 钥 息内容 编号，为一个数字 还 有 附 件 文件。 返回信息： 递参数不完整 户验证失败 送失败 1：发送成功 16 理通知信息 （ 1）手 机端定期接收 （ 1 分钟 ）通 知 信息， 如果师讯 通 不 是当前运行状态，则 给出提示 “收 到 师 讯 通 发送 通知 消息 ”；并 将 接 收信息保存在数据库中 。 获 取 未 读 通 知 消 息 ：/XX&过先 读取是否有新通知， 一 是 减少 数据流量 ， 二是便于师讯通提醒。 （ 2） 如果是运行状态，则 在 通知处显示接收列表 （ 从数据库中读取） ； （ 3） 点击某个具体的通知，则显示 通知 的详细内容 ， 当点击某一个 内容时 ，服务器会自动标记为已读 。 客 户 端也需要进行此处理。 访问文件： /X&X& X&X&X 传递参数： 通知 内容 ， 是通过 码的 获取接收通知的列表。通知按照阅读状态和发布时间排序。未读、已读，时间倒序。 布通知的人姓名。 布通知人员的 知编号，唯一标识码。 布通知的时间。 读状态（是否阅读）。 整标题。 列表的标题可以返回截取固定长度的内容，鼠标悬浮，显示完整标题。 17 点 击 【 阅 读 】， 访 问 网 页 ： xx&xx&X 传递参数： 表的 ， 读状态。 附件信息保存在通知内容中，通知内容是 式，手机端需要转换，显示成 式。如果通知中有附件可以下载附件（单个文件下载和打包下载）。 讯录功能， 暂不用 公共通讯录部门表 访问页面： /递参数： 前登陆用户唯一标识码 ； 陆密钥 。 返回信息 返回信息为两层嵌套： 门编号， 门名称 公共通讯录， 暂不用 访问页面： /递参数： 前登陆用户唯一标识码 ； 陆密钥 。 门编号； 返回信息 返回信息 联系人信息： 名； 位电话； 机号 庭电话 子邮箱 个人通讯录， 暂不用 访问页面： /递参数： 前登陆用户唯一标识码 ； 陆密钥 。 码，页显示条数。 返回信息 几页， 的记录数 名； 位电话； 机号 庭电话 子邮箱 位名称 19 20 公 功能 21 获取周程 信息 此 文件改为使用网页文件 。 周 程信息是一个 据 ，按显示效果显示出来 即 可。 访问页面： /递参数： 前登陆用户唯一标识码 ； 陆密钥， 前日期 ， 如果不填，默认为当天 程相关功能， 暂不用 获取日程数量信息 访问页面： /递参数： 前登陆用户唯一标识码 ； 陆密钥， 前月份，如果不填，默认为当前日期所在月份，格式 前年份，格式 选 。 返回信息 说明： 期，格式为 应日期的日程条数。 获取日程列表信息， 暂不用 访问页面： /递参数： 前登陆用户唯一标识码 ； 陆密钥， 期，格式 选； 份，格式 选 。 如果有 数，则返回该月的所有日程信息。 22 如果有 数，则返回该天的所有日程信息。 如果两个参数都没有，返回当前日 期的所有日程信息。 码 页行数 返回信息 返回信息说明： 程唯一编号。 题 要等级 始时间， H： mm 束时间，同上 态， 度，百分比。 述信息 获取日程详细信息， 暂不 用 访问页面： /递参数： 前登陆用户唯一标识码 ； 陆密钥； 程编号 。 返回信息 23 说明： 程唯一编号。 题 要等级 始时间， H： mm 束时间，同上 态， 度，百分比。 述信息 程类别，个人或工作。 进度描述：当前进度的描述信息 变更日程状态， 暂不用 访问页面： /递参数： 前登陆用户唯一标识码 ； 陆密钥 。 返回信息 返回信息为两层嵌套： 门编号， 门名称 提交日程信息， 暂 不用 访问页面： /传递参数： 前登陆用户唯一标识码 ； 陆密钥 。 返回信息 返回信息为两层嵌套： 24 门编号， 门名称 用语管理， 暂 不用 访问网页： /递参数： 前登陆用户唯一标识码 ； 陆密钥 。 返回信息： 人云 盘设计 ： 个 人 云 盘包括：个人 文件 夹、公共文件夹、接收文件夹、部门文件夹。 不 同的文件 夹 具有不同的权限 ： 个 人文件 夹 ：具有下 载 、上传、移动、改 名 、删除 、 转发权限 等 权限； 公共 文件 夹 ： 具 有下载权限； 接 收文件 夹 ：具有下载 权限 。 个人文件夹 访问网页： 递参数： 选参数， 不选为 根 目录 ） 返回信息： 件类型， 1 文件夹， 2 文件 件名称（或文件夹名称） 改时间 件大小（如果是文件夹，为 0） 果是文件，则是下载地址，如果是文件夹，没有意义 文件路径，打开下一级文件夹使用；如：打开我的网盘，里面有一个 文件夹，如果要访问这个文件夹，则访问： ss&8&5 公共文件夹 访问网页： 件上 传 访问网页： 数： 回： 1 成功， 0 失败 重命名 访问网页： /递参数： 前所处路径，使用 法加密； 件类型， 1 文件夹， 2 文件。 重命名的文件的新名称（如果是文件要包含后缀），使用 法加密； 重命名的文件的旧名称（如果是文件要包含后缀），使用法加密； 返回内容： 空参数； 统错误，重命名失败； 的文件名在此目录下已经存在； 1：重命名成功； 删除 访问网页： /递参数： 前所处路径，使用 法加密； 删除的文件名（包含后缀），使用 法加密； 件类型， 1 文件夹， 2 文件。 26 返回内容： 说明：返回值分别代表不同的含义 空参数； 统错误； 1：删除文件夹成功； 2：删除文件成功； 复制 访问网页： /递参数： 前所处路径，使用 法加密； 制前文件所在目录，使用 法加 密； 制前文件的名字，使用 法加密； 选参数，删除标记，是否删除源文件， 1 删除，为空或其他，不删除。 返回内容： 说明：返回值分别代表不同的含义 空参数； 统错误； 能复制目录到其子目录中； 录名：复件 _旧目录名已经存在 件大小超过了 200M，单个文件只能复制 200M 以下的文件； 件名已存在； 1：复制成功。 新 建文件夹 新建文件夹： 访问网页： /递参数： 前所处路径，使用 法加密； 27 新建的文件夹名，使用 法加密； 返回参数： 空参数； 统错误； 1：创建成功； 接收 文件夹 访问网页： /递参数： 检索的文件名，使用 法加密；可以没有此参数。 返回参数： 一编号 送人，（返回的是姓名）； 件名称； 建时间； 载路径 删除接收文件接口： 访问网页： /递参数： 删除的接收文件的 号。 1. 1：删除成功； 2. 败； 上传 文件 访问网页： /递参数： 28 发送的文件名，使用 法加密，必填。 收人标号字符串，如： 20797,20824, 使用英文逗号分隔。 述，使用 法加密，可选 返回参数： 数不完整 1：成功； 败； 误日志上传， 暂 不用 访问网页： /递参数： 错误日志文件。 返回参数： 1：成功； 传失败； 校 交流 家 校交流主要有 教 师 （ 含学校教师和班主任）与家长 点 对点交流 ， 群发消息，留作业等功能。 （ 1） 获取 所 教班级 、家 长、 学 生列表 设计描述：在目前的界面最后面增加“家校”项，点击 后列出所有所教班级、如果只教一个班，则直接显示该班的学生及家长。 显示 效果同 通讯 录，第一级是班级，二级是该班学生 及 家长。 点击 家长后进入 聊 天界面，同教师间交流 ，接收消息的 应的是家长的 访问页面： /递参数： 前登陆用户唯一标识码 ； 陆密钥 . 返回信息 29 说明： 级编号，唯一编码； 级全称； 否是该班的班主任， 0：否， 1：是； 能为空，学科编号 ;学科名称；多个学科使用 #分隔，如 1;语文 #2;数学。 解析的时候，要分开存储。分成 特殊说明：可能存在一种情况，一个教师既是 A 班的班主任，又是学科教师。 生 生姓名 长 长姓名 访问结果如下图所示： （ 2）群发 消息 设计描述：在 家校 界 面， 在 右上角增加一个 “ 群发 ” 按钮， 点击 后，选择该班的所有家长列表， 然后 可以选择，选择后发送 消息， 此功能基本上教师的群发消息 相 同。 搜索条缩短，右侧增加群发消息按钮。 30 发送方法同师讯通群发消息功能，只是选择接收人员的地方改成提取所教的班级家长（ /息，可多选。 发送接口内容。 群发消息接口： /发文件 /布当 天作业 发布作业接口： 有教学学科的教师才能够发布作业（即 为空的班级），如果老师只教授该班一个学科，则 直接进入输入界面，如果 以前已留过，应 先 读取以前的作业，再 输入作业内容，点击提交即可。如果老师教授该班多个学科，需要让老师在发布作业的时候必须选择一个学科，然后才能提交。 接口文件： /递参数： 师的 号； 师的校验码； 科编号； 级编号； 业内容。 返回信息： 1：发送成功 递参数不完整 31 户验证失败 送错误 获取当 天作业 接 口文件： /递 参数： 前登陆用户唯一标识码 ； 陆密钥； 班级编号 ； 科编号。 返回 信息： 天作业内容，通过 码转 过的。 为空， 表示没有。 描述 ：教师获取某班作业，可用于重复修改。 注意：目前 的设计， 增加和获取只能是当天的作业。 32 四、安卓 版 师讯通目前存在的问题 014 年 12 月 22 日星期日 1. 通知，无法查看下一页，只能查看第一页显示出来的通知； 问题 2. 查看通知内容，下载附件和打开链接没有问题，下载通知内容中上传的附件，提示“师讯通已停止运行”，然后退出。 3. 交流，发送图片或者拍照，选择裁剪发送，裁剪后点击提交，返回交流窗口，没有发送成功。 小米手机和华为手机不行，联想手机可以 4. 交流，收到的未读交流信息显示的顺序不正确，如下图 5. 通讯录，不显示部门结构。 不稳定，偶尔显示，华为手机不行，联想手机可以 6. 群发消息不能发送。无法选择人员。 部门不显示就不能群发消息 7. 群发消息： 人员选择处未展开的也可以选中。 8. 720*