权限系统组织管理—详细设计说明书

 前言：

   上次聚哥让写详细设计文档，自己也写了自己模块的，觉得写的挺好的。但是后来娥接手权限，我跟她说权限逻辑的时候，才发现很多东西在详细设计文档中都没有写出来，所以下一个人接手的话，又要跑来问好多逻辑的问题。每一次都要做很多重复性的工作。还有上次，做ＰＢ中期验收的毕业设计的时候，我没有下载到直接带着数据库的，但是材料中有数据库说明书，写的特别详细，所以我就按照别人的数据库说明书，搭建起来了，系统也成功跑起来了。这个时候觉得这些文档特别的有用。所以，我想，别人看了我的详细设计说明书，是不是也能够很清楚的了解这块的业务，快速的入手呢！因为我整理了一下ITOO 4.1 权限系统，组织管理模块。

                                 详细设计说明书（组织管理）
1引言
1.1编写目的
     目的是为了总结本模块的主要功能，然后给再次开发这个模块的人一个好的开始。
     预期读者：权限的系统开发人员
1.2背景
     说明：
         a． 待开发软件系统的名称：权限系统——后台组织管理
         b． 本项目的任务开发者：栗振娟
1.3定义
    组织：前台用户注册的学校，我们称之为组织。
    资源：高效云平台有五个系统，新生系统、权限系统等，这每个系统都叫做每个资源。称为资源。用户拥有哪些资源，就是用户可以有权利使用哪些功能。
1.4参考资料
    （1）、ITOO4.0 权限系统需求说明书
    （2）、ITOO4.0 权限系统详细设计说明书

2.模块功能说明

2.1本模块在整个系统中的地位
    组织组织在权限系统的作用：连接前台和后台的交互点，因为只有给组织分配了相应的资源，在前台库，才能够在页面中显示出来这个资源，这个资源才能够使用。所以给组织分配资源，是这个模块的主要作用。

2.2、与其他模块的关系:
       （1)、 左侧导航栏，显示的是注册模块注册的所有学校。（注册模块）对应表 TA_Organization
        (2)、资源树，显示的是后台资源管理模块添加的所有前台资源（后台资源管理）对应表TA_BackResource

2.3、模块重要逻辑

   因为高校云平台，面向的对象是所有的学校，所以每个学校注册之后，就会给这个学校分配一个新的数据库，包括权限、新生、考评、基础、成绩这个五个子数据库。以后这个学校所有的数据都会放入在这个自己的数据库中。比如：廊坊师范学院注册了ITOO云平台，我们就会给它建立5个库（新生库、权限库、考评库、成绩库、基础库），华航注册了ITOO云平台，那么同样我们也会给它建立5个库。这也就是注册模块说的动态建库。
动态切库，因为不同的学校拥有不同的数据库，所以分配资源的时候，首先需要根据组织ID去找到某个组织所拥有的数据库，然后去找到相应的表，最后才能够对其表进行操作。
   了解了以上的知识，再了解“给组织分配资源”这条线就变得非常容易了。

第一条线：给组织分配资源：

根据资源ＩＤ获取连接师范学院的数据库连接字符串¬—连接上师范数据库—找到权限库——找到权限库的TA_Resource表—将分配的新资源写入这个表。
第二条线：查询组织对应资源：

根据资源ID获取连接师范学院的数据库连接字符串—连接上师范数据库—找到权限库——找到权限库的TA_Resource表—就可以读取师范学院所拥有的所有资源

下面一张图可以描述具体过程：

3、数据库使用说明

 组织管理这个模块，共使用了4张表，下面是每张表中重点字段的说明。







4、遗留问题：
  （1）、 现在组织管理这个模块都是按照切库实现的情况下，写好的方法。但是因为切库还未搭建在ＩＴＯＯ上，所以还不能够动态的将资源添加到对应的某个学校的数据库中，同时也不能够根据资源ID动态的读取对应库中的数据。
  （2）、 因为现在只有一个前台权限库ITOO_Authority000000，所以所有的资源都是添加到这个库中，同时现在所有的组织都是读取的同一个库（ITOO_Authority000000）的资源，所以资源都是一样的。
  （3）、 分配资源这条线方法还有点问题，方法类型有待于在考虑一下，后台资源管理负责提供这个接口，可以跟他们协商。

5、对于这个模块，我的想法和建议：

 5.1. 界面优化：
左侧导航栏：现在学校少，看着还好，如果学校多了，找一个学校还得一个个找，而且看着好丑（这是重点）。可以分类做成树的形状，更建议分类汇总，添加搜索框。

 5.2、 点击组织，点击“更多”，才能够查看相应的学校信息和资源,一个陌生用户是不知道点击这里的是干嘛的，如何给与用户更好地提醒呢？
 5.3、分配权限的树，我已经拥有的资源，我还可以再选？虽然这条线，在具体实现的时候，我已经做了不让其重复添加，但是我觉得应该给个默认提示，标注哪些是我已经拥有的，这样我就不用选了，浪费感情啊。


5.4、 如果廊坊师范学院不交钱了，不想使用考评系统了，我应该给它删除这个资源。但是现在的系统，还没有加入这个需求，下一个版本可以考虑。

小结：

  现在越来越觉得文档的重要性，人可以走，但是得留下点东西嘛，这才是一个公司宝贵的财富，如果每个人接手系统，都得重头开始捋，这样每次系统都是在重复性的工作。希望我们的文档越写越好，真正发挥其作用。