租户维护

租户维护功能用于开发者或运营者在后台创建租户或审核新注册的用户申请成为企业。

“租户”对开发者或运营者可以称为租户，对外一般称为企业，所以后续提到租户或企业都指的是“租户”。

涉及的表

• def_tenant

  租户

• def_tenant_ds_c_rel

  租户的数据源

• def_tenant_application_rel

  租户的应用

• def_tenant_resource_rel

  租户的资源

• def_tenant_application_record

  租户应用授权记录

• def_user_tenant_rel

  员工（用户-租户关系表）

  字段模式没有该表。字段模式的base_employee表就相当于数据源模式的def_user_tenant_rel表。

重要字段解释

1. code：租户编码，又称企业编码。

2. name： 租户名称，又称企业名称。企业的完整名称。

3. register_type：注册类型。CREATE: 后台创建的企业；REGISTER：用户自行注册的

4. connect_type：连接类型。SYSTEM：系统内置数据源；CUSTOM：自定义任意ip的数据源

5. state：状态。true：启用；false：禁用。

   企业禁用后，该企业下员工，将不能切换到此企业。

   提示

   用户禁用、员工禁用、企业禁用之间的关系

   1. 用户禁用后，不能登录系统
   2. 员工被某个企业禁用后，员工不能切换到该企业
   3. 企业被禁用后，该企业不再可用，且企业下的所有员工，不能切换到该企业

6. status：审核状态。05-正常 10-待初始化结构 15-待初始化数据源 20-已撤回 25-待审核 30-已拒绝 35-已同意。

   后端服务启动时，会扫描05、15这2种状态的数据，并进行数据源初始化工作。

7. readonly_：是否内置数据。

8. expiration_time：过期时间。过期时间内可以访问，null表示永久可用

9. 其他字段看数据库表结构中注释。

功能讲解

1. 新增： 向 def_tenant 表新增一条租户信息

   

2. 修改： 修改 def_tenant 表的租户信息

3. 删除：后端提供了2个删除接口，系统默认调用的是接口1，接口2非常的危险，可以根据自己公司的实际情况自行选择使用那个接口或自行修改删除逻辑。

   • 接口1：(DELETE /defTenant ) 仅删除租户主数据、租户附件数据、租户配置的数据源数据。

   • 接口2：(DELETE /detTenant/deleteAll) 除了删除上述删除接口的数据外，还会物理删除租户的数据库、数据库内的数据、动态删除服务链接的数据源

4. 查看：查看租户的基本信息、租户拥有的应用、租户拥有的员工。

   • 企业的应用：可以取消授权
   • 企业的员工：可以解绑员工

5. 初始化数据：只有待初始化结构的租户才有此按钮，调用租户服务的接口，并执行以下处理逻辑

   

   • 创建租户自己的数据库 （链接类型是本地才会创建数据库，是远程需要事先确保数据库已经创建好）
   • 动态添加租户服务的数据源
   • 在此租户的数据库自动运行lamp-system-server/src/main/resources/目录下的 schema/mysql/lamp_base.sql 脚本创建表。
   • 在此租户的数据库自动运行lamp-system-server/src/main/resources/目录下的 data/mysql/lamp_base.sql 脚本插入内置的数据。
   • 修改租户状态为待初始化数据源

6. 初始化链接：点击列表页的初始化链接按钮，会弹出链接数据源页面，此页面会将所有的后台服务以及是否已经正常创建的此租户的数据源状态。

   

   • 未链接：表示后台服务尚未链接到此租户的数据库，可以点击立即链接按钮，动态创建数据库链接。

   • 已链接：表示后台服务已经正常的链接到此租户的数据库，可以正常的操作此租户的数据库了。

7. 审核：普通用户注册后登录系统，可以申请成为企业，填好企业信息后，租户状态处于待审核状态。此时运营者可以对其审核，审核通过后，会自动执行初始化数据按钮的逻辑（创建库，创建表，创建数据），但还需要运营者手动点击初始化链接，并绑定租户管理员后，普通用户才会成为此企业的租户管理员

   

8. 绑定租户管理员：查询全局的用户表，不属于此企业的用户，可以绑定为此租户的租户管理员。

   

申请成为企业流程

大致流程为：申请成为企业->审核（初始化租户数据库表结构和初始数据）->初始化其他服务的数据源

1. 普通用户注册账号，并登录系统。

2. 普通用户进入我的企业菜单，点击申请创建自己的企业，填写企业信息。 填写完成后，企业状态变成 待审核状态。

   • 申请

     

   • 待审核状态

     

3. 运营者登录系统，进入租户维护页面，点击审核按钮，弹出审核页面，选择同意并提交，企业审核成功后变成待初始化数据源状态

   

4. 审核同意后，还需要执行初始化其他服务的数据源操作。

   

5. 点击初始化其他服务的数据源弹出操作界面，将未链接状态的服务点击立即链接按钮，使lamp-base-server和lamp-oauth-server服务连上数据源。

   

6. 待所有服务的状态的变成已链接后，说明此租户已经可以正常使用了。

   

7. 此时租户下还尚无账号，需要给其绑定一个租户管理员。点击绑定租户管理员按钮弹出操作框后，选择一个用户，将其设置为此租户的管理员。

   

8. 绑定成功后，即可通知用户登录系统