虚拟组织架构管理需求规格说明书V1.0.9 20180815

软件需求规格说明书PAGE虚拟组织架构管理软件需求规格说明书版本：V1.0.89修订记录日期版本修订说明修订人2017.12.1V1.0.0新建文档增加部门映射管理、虚拟架构管理设计2种角色、完善虚拟组织架构设计何文华2017.12.6V1.0.1修改增加员工信息同步需求修改员工搜索交互、多选部门弹窗交互修改、何文华2017.12.11V1.0.2修改同步企业微信业务流程、系统示例图调整细节调整：部门映射界面按钮调整、选择何文华2017.12.18V1.0.3增加：创建虚拟组织架构，增加代码字段何文华2017.12.29V1.0.4修改虚拟架构维护页面顶级节点只有编辑功能合并“维护员工虚拟部门”按钮删除“是否部门领导”筛选项何文华2018.01.05V1.0.5修改虚拟架构维护页面1、删除“同步到企业微信”按钮何文华2018.01.29V1.0.61、完善需求：明确新增虚拟部门的逻辑何文华2018.03.14V1.0.7增加默认部门需求修改企业微信ID维护的需求何文华2018.07.25V1.0.8几乎重写整个文档：重构整个的权限设计、增加虚拟组织架构管理页面、丰富根据人事系统广播信息自动处理人员变动逻辑、支持OA账号管理、映射支持非末级部门何文华2018.08.15V1.0.9增加：映射管理过滤OA数据源的虚拟组织架构完善：数据维护人可以维护父节点及该父节点下所有节点的数据完善：员工异动自动处理的逻辑完善：明确虚拟部门维护的交互逻辑增加：操作日志记录内容完善：明确管理员权限的判断逻辑修改：虚拟部门从末级变非末级，则该部门映射均删除：本期规划的版本号修正何文华 第37页目录TOC\o"1-6"\h\u30679目录 1297591简介 353011.1文档概述 314641.2目的 3166851.3范围 346721.4术语/缩略语 4183981.5参考文档 4212332运行环境 4313962.1硬件环境 46902.2网络环境 480052.3软件环境 4217043产品概况 5220723.1用户定位 5248143.2产品规划 5299283.3本期规划 5146143.4系统功能结构 6222513.5总业务流程 6159353.6系统用户角色及权限设计 915313.6.1角色描述 9135813.6.2角色用例 9222014功能设计 10245754.1映射管理 10185594.1.1映射管理 10216244.1.1.1业务概述 10104454.1.1.2业务流程 10104924.1.1.3功能用例 11161504.1.1.4界面原型 11200364.1.1.5业务规则 12112534.2虚拟组织架构管理 14128334.2.1虚拟组织架构管理 145764.2.1.1业务概述 14249164.2.1.2业务流程 14220984.2.1.3功能用例 15237724.2.1.4界面原型 1510574.2.1.5业务规则 16233834.3部门及用户管理 17137194.3.1部门及用户管理 17292834.3.1.1业务概述 17224734.3.1.2业务流程 1763784.3.1.3功能用例 18295654.3.1.4界面原型 19297174.3.1.5业务规则 23170974.4企业微信ID维护 2684274.4.1企业微信ID维护 26134974.4.1.1业务概述 2620164.4.1.2业务流程 26223084.4.1.3功能用例 27291504.4.1.4界面原型 2782074.4.1.5业务规则 2847494.5后端逻辑 2969984.5.1企业微信定时服务 2966274.5.1.1业务概述 29262264.5.1.2业务规则 29121094.5.2员工异动自动处理 29295884.5.2.1业务概述 2927904.5.2.2业务规则 2957414.6公共接口 30178134.6.1公共角色接口 30123745非功能性需求与约束 31325345.1权限树结构 31160655.2系统示例图 3312588附录1：需求确认 3429637目录 197091简介 3171601.1文档概述 3218071.2目的 355751.3范围 352541.4术语/缩略语 496371.5参考文档 475262运行环境 4315412.1硬件环境 4325742.2网络环境 452992.3软件环境 4168563产品概况 5151833.1用户定位 5122663.2产品规划 5174143.3本期规划 5130803.4系统功能结构 682293.5总业务流程 6135413.6系统用户角色及权限设计 97343.6.1角色描述 9216193.6.2角色用例 9196174功能设计 10325154.1映射管理 10128154.1.1映射管理 10106284.1.1.1业务概述 109674.1.1.2业务流程 1071104.1.1.3功能用例 11259514.1.1.4界面原型 115154.1.1.5业务规则 12300124.2虚拟组织架构管理 14245334.2.1虚拟组织架构管理 14133604.2.1.1业务概述 1461104.2.1.2业务流程 14130614.2.1.3功能用例 1555454.2.1.4界面原型 15320954.2.1.5业务规则 16213874.3部门及用户管理 17134584.3.1部门及用户管理 1711624.3.1.1业务概述 1788114.3.1.2业务流程 17109084.3.1.3功能用例 1828114.3.1.4界面原型 19255304.3.1.5业务规则 23322184.4企业微信ID维护 27196044.4.1企业微信ID维护 27108894.4.1.1业务概述 2735684.4.1.2业务流程 2763604.4.1.3功能用例 2746014.4.1.4界面原型 28280244.4.1.5业务规则 2823114.5后端逻辑 29256344.5.1企业微信定时服务 29250024.5.1.1业务概述 29133074.5.1.2业务规则 29138164.5.2员工异动自动处理 30307544.5.2.1业务概述 301154.5.2.2业务规则 30177934.6公共接口 31156224.6.1公共角色接口 3182835非功能性需求与约束 33324795.1权限树结构 33223275.2系统示例图 342616附录1：需求确认 35简介文档概述这里编写的“虚拟组织架构管理”的需求规格说明书，主要是为了明确项目的需求，并以其作为项目计划、概要设计、系统测试等的一个依据，同样也为参与此项目开发的成员、管理的领导提供一个参考文档。本文档需要软件开发委托方确认系统的需求是否准确、全面。目的我们编写此规格说明书的目的就是要把前一个阶段的调研结果，即虚拟组织架构管理的业务需求，用户需求和软件功能需求作一个详细的列举，汇总，再在此基础之上进行提取，抽象，以抽取每一个单位所公有的对于这个信息期刊系统的需求，用于作本系统的概要设计的一个根据。范围此文档中所记录的各项业务适应于广州棒谷网络科技有限公司及下属单位人员了解问题跟踪系统详细功能。同时也适应于广州赛酷比软件有限公司开发设计人员进行了解详细需求，有助于开发设计。术语/缩略语术语/缩略语说明UPMS用户中心，用于保存人、部门、映射关系等数据人事组织架构人事系统维护的真实组织架构企业微信主要用在企业微信的虚拟组织架构参考文档运行环境硬件环境[描述该系统对服务器和客户端硬件配置要求，以保证系统能正常无误工作]网络环境[描述该系统客户端与服务端间网络要求]软件环境[描述该系统对操作系统、软件要求]产品概况用户定位维护公司虚拟组织架构用户群体，详细角色描述请查看“系统角色及权限设计”。产品规划因此产品已满足人事、OA账号维护需求，暂无后续规划，将根据使用反馈再进行产品规划。本期规划1.10.0版本核心需求：真实与虚拟架构部门映射管理虚拟部门数据管理：包括虚拟部门、人员企业微信数据同步人员异动功能开发1.1.10版本核心需求：企业微信ID维护人员入职、离职处理逻辑调整第三方接口提供1.2.0版本核心需求（当前版本）：1、支持“账号”（主要是OA账号）作为维护数据：获取OA的数据、展现OA的数据2、部门及用户管理：节点单独授权管理3、角色、权限重新梳理，划分三级权限：管理员、维护人、数据维护4、支持映射为非末级节点部门及相应数据处理5、根据人事系统广播信息，自动处理入职、离职、异动数据的映射虚拟部门系统功能结构总业务流程1、部门映射维护流程流程说明：用户登录站点容器，打开“映射管理”页面；选择需要映射的两棵组织架构树，必须一棵是真实，一棵是虚拟；选择需要映射的部门，勾选中映射部门；点击“保存映射数据”；服务端更新映射数据；流程结束。2、虚拟部门数据更新流程流程说明：用户登录站点容器，打开“部门及用户管理”页面；选择需要维护的虚拟组织架构树；选择维护的内容，是维护虚拟组织架构树部门，还是维护虚拟部门下的员工数据；判断操作的组织架构树是否“企业微信”如是，则更新完本地数据后，要同步到“企业微信”上；流程结束。系统用户角色及权限设计角色描述虚拟架构管理员：管理所有虚拟组织架构部门映射、虚拟组织架构数据人员，通过站点容器-权限系统控制权限虚拟架构维护员：维护特定虚拟组织架构部门映射、虚拟组织架构数据人员，通过站点容器-权限系统控制权限数据维护人：由虚拟架构维护人设置的账号，通过虚拟组织架构数据权限来控制，不在站点容器-权限系统控制权限角色用例功能设计映射管理映射管理业务概述能够管理真实人事组织架构与虚拟组织架构的映射关系。业务流程1、映射维护流程流程说明：用户登录站点容器，打开“映射管理”页面；选择需要映射的两棵组织架构树，必须一棵是真实，一棵是虚拟；选择需要映射的部门，勾选中映射部门；点击“保存映射数据”；服务端更新映射数据；流程结束。功能用例界面原型界面原型1、部门映射管理页面2、无虚拟组织架构树页面控件描述序号控件描述操作说明1全部部门/无映射部门筛选当前组织架构树下，有无映射的部门数据2保存映射数据保存当前选择的映射数据业务规则1、映射操作规则：A、允许末级虚拟部门对非末级真实部门映射B、映射操作交互设计：B1、当选中左侧末级部门，则展现并勾选右侧组织架构树的映射部门；B2、左侧组织架构树必须是虚拟的组织架构树（可以切换），右侧组织架构树必须是真实人事的组织架构树（不可切换）。B3、左侧虚拟组织架构树只支持选择末级节点，右侧真实的组织架构树控件可以支持选择末级、非末级部门B4、左侧虚拟组织架构树，过滤数据来源是“OA账号”的虚拟组织架构树；B45、中间“映射关系（右侧树节点）”内容的支持显示末级、非末级部门，如非末级部门，则在部门名称后显示“（父级）”两个字点击“保存映射数据”，则自动根据部门映射数据，自动将真实部门下的员工增加到虚拟部门上。如果父级部门的映射，需要将父级部门下的所有员工均映射到指定的虚拟架构末级部门下页面右侧显示操作指引内容，内容如下：操作指引：1、只支持末级虚拟部门映射末级/非末级真实部门如：虚拟末级部门A映射非末级真实部门B，则非末级部门B下所有子部门均自动映射虚拟末级部门A如：虚拟末级部门A已有映射，但是虚拟部门A从末级变成非末级，则映射自动失效2、一旦建立映射，当有员工新增、异动、离职时，会自动处理相关映射数据3、点击“无映射部门”可以筛选出当前两组织架构无映射的部门，方便排查映射关系4、操作后的映射关系，需点击“保存映射数据”，关系才会真正保存并生效。2、无映射部门/全部部门：根据当前选中的组织架构树下部门与对应组织架构树有无映射关系，筛选所有无映射的部门数据展现。3、权限管理：A、虚拟组织架构管理员能够查看并管理所有虚拟组织架构数据B、虚拟组织架构维护员只能查看并管理自己维护的虚拟组织架构数据，根据创建虚拟组织架构树时选择的维护员来确定权限C、真实的组织架构树不需要权限限制，所有角色均可查看。4、无虚拟组织架构数据，则页面上提示：当前账号暂无管理虚拟组织架构树，请创建虚拟组织架构树，或者联系管理员虚拟组织架构管理虚拟组织架构管理业务概述虚拟架构管理员可以维护虚拟组织架构树数据，包括新增、设置维护人等功能。业务流程1、虚拟部门数据修改功能用例1、用户用例界面原型界面原型1、虚拟组织架构维护页面2、添加/编辑虚拟架构业务规则1、新增/编辑虚拟组织架构：A、各字段字数限制：字段名逻辑限制虚拟架构名称20个字符虚拟架构标识符20个字符，编辑时，不可修改此项数据虚拟架构介绍60个字符顶级树节点名称60个字符虚拟架构维护人支持多个默认部门设置只有编辑的时候，才显示此选项，默认非必填项选择数据源下拉选择，“OA账号”、“人事数据”，默认空值，编辑时，不可修改此项数据B、“选择数据源”逻辑：C、新增虚拟架构各字段对应提示语：字段名提示语虚拟架构名称虚拟架构标识符纯英文+数字，用于接口调用时区分虚拟组织架构树虚拟架构介绍顶级树节点名称虚拟架构维护人可以管理制定的整颗虚拟组织架构树的人员默认部门设置设置默认部门后，所有账号都会添加指定的默认部门，默认部门不可删除选择数据源选择维护的账号数据源，只能选择一次，慎重选择！OA账号：指旧OA系统账号数据人事数据：指以“人”为单位的账号数据2、列表-搜索需求：字段逻辑限制标识符模糊搜索虚拟架构名称模糊搜索维护人模糊搜索部门及用户管理部门及用户管理业务概述能够管理虚拟组织架构的部门数据，包括部门新增、删除、修改，员工虚拟部门数据的管理。业务流程1、虚拟部门数据修改2、员工虚拟部门数据修改功能用例1、用户用例界面原型界面原型1、部门及用户管理：OA数据源2、部门及用户管理：人事数据3、部门及用户管理：企业微信4、编辑虚拟组织架构5、添加/编辑虚拟部门6、修改员工虚拟部门控件描述1、虚拟组织架构维护页面序号控件描述操作说明1维护员工虚拟部门维护员工在虚拟部门下数据2同步到企业微信只有“企业微信”虚拟组织架构树才有此按钮，可以人工操作同步企业微信虚拟组织架构、员工信息数据到企业微信3增加部门可以新增虚拟组织架构部门4编辑部门可以编辑虚拟组织架构部门5删除部门可以删除虚拟组织架构部门6搜索根据搜索条件查询信息7重置重置所有搜索条件内容8一键同步同步线上企业微信的组织架构数据到本地，只有“企业微信”虚拟组织架构才有此功能9设置虚拟架构树信息可以设置当前虚拟架构树的相关信息，只有虚拟架构树的维护人才有权限查看业务规则1、虚拟部门管理：A、新增、删除、编辑虚拟组织架构部门数据：A1、删除虚拟部门：不允许删除有员工的部门，非末级不能删除A2、编辑虚拟部门：不能编辑虚拟部门到有员工的末级部门；当新增部门或编辑上级部门时，判断相关部门是否从末级变成非末级，如是，则删除该部门所有映射关系，如否，则保留该部门的映射关系；如：A原是末级部门，在A下面创建B，A从末级变成非末级，则A的映射全删除；A是末级部门，B是另外一个末级部门，B编辑上级部门为A，A从末级变成非末级，A的映射全删除。A3、新增虚拟部门：新建虚拟部门的父级部门，不允许有员工数据存在，如有员工，则提示：“父部门下含有用户，不允许在其下增加子部门”A4、新增部门的各字段限制字段名是否必填字数限制上级部门否控件选择，显示当前虚拟组织架构树数据部门名称是20个字符部门顺序否20个字符，顺序从小到大值排序部门维护人否控件选择，允许多人，显示全公司员工数据此字段数据，控制能管理维护该虚拟部门数据的权限B、如果是“企业微信”虚拟组织架构，当虚拟组织架构上部门新增、删除、编辑后，同步修改数据到企业微信C、虚拟部门交互需求：C1、显示每个节点下部门人员总数C2、显示该部门的节点维护人员数据，如无，则不显示，如有且维护人少于不等于31个，则直接显示名字，如有且维护人多于等于32个，则显示（X维护员）X为维护人数量备允许多个顶级节点，企业微信的不允许，要看下怎么描述这个注：允许多个顶级节点，企业微信的不允许，要看下怎么描述这个2、“维护员工虚拟部门”数据：A、维护员工虚拟部门：可以将员工添加到当前虚拟组织架构下的部门，允许复制到多个虚拟部门B、删除部门数据：可以删除员工在虚拟组织架构的部门数据，如果选中一个员工，则展现该员工所有虚拟部门数据，进行操作；如果选中多个员工，则将多个员工虚拟部门数据的交集筛选出来，进行操作。D、如果是“企业微信”虚拟组织架构树，当人员复制、删除部门数据后，同步修改数据到企业微信。4、权限管理：A、此页面菜单不在权限系统做权限控制，所有人可查看页面，数据权限通过“虚拟组织架构管理”页面进行管理，如无权限操作及使用者，页面显示“如想使用此功能，请联系相关“虚拟组织架构管理员”添加组织架构树或者维护人权限”提示语B、虚拟组织架构管理员（通过“添加组织架构”权限项作为管理员权限判断）能够查看并管理所有虚拟组织架构数据，可以新增/编辑虚拟组织架构，查询员工在所有虚拟组织架构的数据B、虚拟组织架构维护员只能查看自己维护的虚拟组织架构树数据。C、数据维护人：此角色数据，通过虚拟部门的节点维护人数据来控制，此角色只能查看配置对应的虚拟组织架构树节点及该节点下所有节点的数据，可以维护指定节点的虚拟部门增删改、员工的虚拟部门信息维护5、员工信息表操作栏需求：A、根据虚拟组织架构树的数据来源不一样，显示不一样的搜索内容，搜索不一样的数据：A1、如果数据来源是“OA数据”，则显示“用户名”、“中文名”、“账号状态”、“OA邮箱”四个搜索条件，搜索的数据是OA系统的相关数据A2、如果数据来源是“人事数据”，则显示“员工姓名”、“人事岗位”、“人事部门”三个搜索条件，搜索的数据是人事系统的相关数据A3、如果数据来源是“人事数据”且是“企业微信”组织架构，则显示“员工姓名”、“人事岗位”、“人事部门”、“微信同步情况”四个搜索条件微信同步情况：默认空值，下拉选择，“信息一致”、“信息有误”（信息有误则筛选出所有有问题的数据）B、“导出数据”按钮需求：导出当前虚拟虚拟组织架构的组织架构及人员信息，导出字段如下：（该功能未开发未实现）B1、如果是“企业微信组织架构”则导出以下字段：字段名备注一级部门虚拟组织架构部门节点二级部门三级部门四级部门（自动根据虚拟组织架构扩展）员工姓名人事系统员工姓名人事岗位人事系统员工岗位人事部门路径人事系统员工部门路径是否领导负责人是、否手机号码企业微信上手机号码职位信息企业微信上职位信息性别企业微信上性别数据：男、女邮箱企业微信上邮箱数据启用/禁用企业微信上账号启用禁用数据：启用、禁用B2、如果是其他虚拟组织架构，则导出以下字段：字段名备注一级部门虚拟组织架构部门节点二级部门三级部门四级部门（自动根据虚拟组织架构扩展）员工姓名人事系统员工姓名人事岗位人事系统员工岗位人事部门路径人事系统员工部门路径是否领导负责人是、否7、员工信息表交互规则A、“虚拟部门信息”字段只显示虚拟部门的ID，点击则弹窗提示对应部门的删除提示：是否删除“150（部门ID）：第三方平台CRM中心/运营部/XX组（虚拟部门路径）”虚拟部门？B、“虚拟部门信息”字段，鼠标移动到上面，弹窗显示虚拟部门ID及对应的虚拟部门路径C、“微信同步情况”字段：只有“企业微信”虚拟组织架构树才有此字段，将线下数据与线上数据进行校验，显示线上与线下数据差异点。8、“默认部门”逻辑：A、编辑虚拟组织架构时，可以选择其中一个末级部门作为默认部门，默认部门非必选项B、所有人都在默认部门，且“默认部门”不可删除。如果点击删除，则提示“默认部门不可删除”企业微信ID维护企业微信ID维护业务概述能够维护企业微信ID与人事ID的关联关系。备注：此功能是临时人工干预功能，只允许极少数人操作，因为是维护ID与ID的关联关系，必须小心。业务流程1、修改关联人事ID功能用例1、用户用例界面原型（一）界面原型1、维护页面业务规则1、只有“虚拟架构管理员”才能登录此页面操作数据2、新建/编辑映射关系：A、新增关联关系：如果原本无企业微信ID，添加企业微信ID，则保存此映射关系B、编辑关联关系：直接在最后一列修改，判断是否企业微信ID是否有冲突，如有，则在下面显示冲突数据3、删除离职账号：A、一旦在这里执行删除操作，则删除企业微信线上的数据B、只允许删除禁用状态的账号数据，如果选中启用状态账号，则提示：不能删除启用中账号，请重新选择！C、未激活且已离职的，可以删除操作；未激活且在职的，不允许删除，提示：不能删除在职员工账号，请重新选择！4、页面搜索条件：A、员工姓名：模糊搜索，搜索人事系统，EmployeeName数据，搜索人事系统所有员工数据，包括在职、离职数据B、是否禁用：控件选择，“是”、“否”选项，搜索所有线上“企业微信”的禁用数据C、离职时间：控件选择，选择时间范围段，筛选离职时间是该范围段的所有人事系统的离职数据后端逻辑企业微信定时服务业务概述定时将本地更新的数据同步到企业微信上业务规则1、企业微信定时服务：每隔30分钟将本地变动的数据同步到企业微信上，包括员工新增、离职、异动信息。同步人事系统员工信息：将需要修改企业微信上面的员工账号数据，调人事接口获取相应的员工信息，同步数据过去企业微信，同步数据逻辑如下字段名逻辑备注userid用email字段数据name人事name+人事岗位，如，张三（买手）english_name不传数据mobile不传数据department用虚拟组织架构映射的虚拟部门数据，不超过20个order不传数据position人事岗位数据gender人事性别数据email行政的email数据行政系统的email数据，由行政系统提供telephone不传数据isleader人事部门领导数据人事系统提供avatar_mediaid不传数据enable默认1启用成员extattr不传数据员工异动自动处理业务概述监控人事系统广播的员工账号状态变化信息，相对应调整本地虚拟组织架构数据业务规则1、员工部门数据自动更新规则：根据人事系统广播信息，当有员工、部门数据变化时，自动更新相应的虚拟组织架构数据，具体逻辑如下：情景处理逻辑员工入职（账号创建）如入职真实部门有映射关系，采用真实部门对应映射的虚拟部门数据，并需要根据上级部门一级级映射虚拟部门；如入职末级真实部门无映射关系，则往该末级部门的上级部门进行查询，一级级映射虚拟部门；如入职末级所在部门及上面部门均无映射，且无默认部门，则只是创建账号，无映射部门数据。员工离职1、软删本地员工账号；2、如果是“企业微信”虚拟组织架构树，则将企业微信上该账号的状态改为“禁用”。员工异动如部门内异动，则虚拟部门数据保持不变；如跨部门异动，将更新员工的虚拟部门为新部门映射的虚拟部门数据（并需要向上映射虚拟部门）。备注：A、根据上级部门一级级映射虚拟部门：例子：A是父级部门，B是A的子级部门，B无映射部门，A有映射部门，当员工入职B时，将B、A的映射虚拟部门，都添加到该员工上。B、业务处理流程如下：当监控到员工信息有变动，则获取该员工的OAID、userid根据不同情景，分别处理相关数据。C、如该虚拟组织架构有设置“默认部门”且该部门无映射，则自动根据“默认部门”逻辑自动处理员工的相关数据。情景操作员工异动到新部门，该虚拟组织架构树有默认真实部门且有映射默认添加在“默认部门”，且根据部门的映射自动处理相关虚拟部门数据（删除旧虚拟