选人控件需求PRD
一、修订历史
二、项目概述
1、项目背景
7.0.11版本中：“按组织架构选人”的需求已实现，“全选”、“按部门”选人已具备实现条件，搜索结果连选已实现。在此基础上，完善以下功能：
（1）最大人数扩容
（2）全选且可选整个分支
（3）android版最近联系人列表修复
（4）选自己
（5）只能选单人且采用复选框情况下的选人控件优化
（6）搜索功能优化
（7）新增电话会议选人控件
（8）ios版消息转发功能优化
（9）选人控件底栏优化
2、项目意义
（1）解决用户在各个业务场景中使用选人控件时，支持选择的最大人数不够用的问题。
（2）满足用户对于全选和一次性选择整个分支的需求，使用户的操作更快捷。
（3）解决用户在各个业务场景中使用选人控件时，用户本人是否列出和是否支持选中的问题。
（4）新增电话会议选人控件，配合电话会议功能的上线。
（5）修复bug，优化用户体验。
三、业务场景
选人控件相关的业务场景如图1所示。
图1 选人空间相关业务场景
四、功能范围
1、最大人数扩容
表1 各场景最大人数扩容及人数超出提示
说明：
（1）人数超出时弹出的toast的文案统一按照上表修改。
（2）上述人数上限中，最大人数包含现有人数和控件已选人数，且包含用户自己。
2、全选且可选整个分支
（1）适用场景：群聊、任务执行人、日程参与者、审批抄送人、电话会议的组织架构
（2）进入组织架构后，每个页面最上方均提供“全选”导航条，如图2所示。
图2 “全选”导航条demo
（3）点击组织架构中每个分支左侧的复选框控件，点击该控件后该分支下属所有分支和成员均被选中；点击除复选框控件之外的其他区域，则展开该分支的下级。
（4）若因全选或选择整个分支导致所选人员超出最大容量，则不能选中并弹出toast“最多支持X人！”。
3、android版最近联系人列表修复
（1）针对场景：多人会话、转发、任务执行者、日程参与人、公费电话、电话会议。
（2）最近联系人展示范围：转发场景中展示消息列表中所有的个人与群聊，其他场景中展示消息列表中所有的个人。
（3）最近联系人展示顺序：按照会话时间从后往前。
4、选自己
表2 各场景是否列出自己
说明：
（1）上表中的“自己”同时针对组织架构、我的联系人和最近联系人中的自己。
（2） “√”表示是，“×”表示否，“-”表示不存在这种情况。
（3）上表中的“最近联系人中是否列出自己”指的是在消息列表中有自己的前提下是否列出自己。如果消息列表中有自己，则按照上表的规则；如果消息列表中本来就没有自己，则不必列出。即：有自己就显示，没自己就不显示，自己本来在哪个位置就在哪个位置。
（4）上表中“最近联系人”、“我的联系人”、“组织架构”的叫法，各端如有不统一之处请统一（如：ios端的“常用联系人”统一改为“最近联系人”）。
（5）不能选自己的地方选了自己时，弹出的Toast文案统一按照上表修改。
（6）我的联系人的页面中，上方是星标联系人，下方是按照字母排序的个人联系人。“我的联系人下的个人联系人中是否列出自己”仅针对个人联系人，星标联系人不受影响（星标联系人中有自己则列出，没有自己则不列出）。
（7）公费电话的手机通讯录中把自己屏蔽，电话会议的手机通讯录中不屏蔽自己。
5、只能选单人且采用复选框情况下的选人控件优化
（1）适用场景: 审批人、审批转交人。
（2）由于以上场景中分支不能被选中，故分支前面不采用复选框。
（3）重新进入时已选中的人显示已选中。
（4）选其他人时，原选中项自动取消选中，且无任何提示。
6、搜索功能优化
（1）选择任何一个搜索结果后，搜索输入框原关键字自动清空，如图3所示。
图3 搜索输入框关键字自动清空demo
7、新增电话会议选人控件
（1）支持的选人方式：组织架构、我的联系人、手机通讯录、最近联系人。
（2）增加手机通讯录，手机通讯录按照A-Z字母排序，且支持多选，如图4所示。
图4 电话会议选人控件中的手机通讯录demo
（3）将人选好后，并点击“完成”后，跳转到电话会议页面（详见电话会议需求PRD）。
（4）其他与任务执行者相同。
8、ios版消息转发功能优化
（1）转发对象：包括文字、图片、链接在内的所有能转发的消息类型，不含语音、位置等不支持转发的消息类型。
（2）支持转发到群聊，群聊按照会话时间从后往前的顺序列出（参见android客户端）。
9、选人控件底栏优化
（1）适用场景：所有场景。
（2）底栏取消展示用户图像，改为以文本形式展示已选用户数与部门数：“已选:X人,其中有Y个部门”，如图5所示。
图5 选人控件底栏demo
（3）多人会话与电话会议：底栏的人数以及点击底栏后打开的已选用户列表中，均不包含用户自己。
其他场景：根据实际情况展示，不做特殊处理。
五、词汇表
