134 lines
4.0 KiB
Markdown
134 lines
4.0 KiB
Markdown
|
## GVA 组织管理功能
|
|||
|
|
#### 开发者：奇淼
|
|||
|
|
### 本插件支持自动安装
|
|||
|
|
|
|||
|
|
### 图例
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
### 手动安装方法
|
|||
|
|
|
|||
|
|
1.解压zip获得organization文件夹
|
|||
|
|
2.将 organization/web/plugin/organization 放置在web/plugin下
|
|||
|
|
3.将 organization/server/plugin/organization 放置在server/plugin下
|
|||
|
|
|
|||
|
|
#### 执行如下注册方法
|
|||
|
|
|
|||
|
|
### 注册（手动自动都需要）
|
|||
|
|
|
|||
|
|
#### 1. 前往GVA主程序下的initialize/router.go 在Routers 方法最末尾按照你需要的及安全模式添加本插件
|
|||
|
|
PluginInit(PublicGroup, organization.CreateOrganizationPlug())
|
|||
|
|
到gva系统，角色管理，分配角色的菜单权限和api权限即可，插件会自动注册菜单和api，需要手动分配。
|
|||
|
|
### 2. 配置说明
|
|||
|
|
|
|||
|
|
#### 2-1 全局配置结构体说明
|
|||
|
|
|
|||
|
|
无配置
|
|||
|
|
|
|||
|
|
#### 2-2 结构说明
|
|||
|
|
|
|||
|
|
// 组织基础结构
|
|||
|
|
type Organization struct {
|
|||
|
|
global.GVA_MODEL
|
|||
|
|
Name string `json:"name" form:"name" gorm:"column:name;comment:;"`
|
|||
|
|
ParentID uint `json:"parentID" form:"parentID" gorm:"column:parent_id;comment:父节点ID;"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 组织用户关系表
|
|||
|
|
type OrgUser struct {
|
|||
|
|
Organization Organization `json:"organization"`
|
|||
|
|
OrganizationID uint `json:"organizationID,omitempty" form:"organizationID" `
|
|||
|
|
SysUserID uint `json:"sysUserID,omitempty" form:"sysUserID"`
|
|||
|
|
IsAdmin bool `json:"isAdmin" form:"isAdmin"`
|
|||
|
|
SysUser system.SysUser `json:"sysUser"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 组织内用户操作结构
|
|||
|
|
type OrgUserReq struct {
|
|||
|
|
OrganizationID uint `json:"organizationID,omitempty"`
|
|||
|
|
ToOrganizationID uint `json:"toOrganizationID,omitempty"`
|
|||
|
|
SysUserIDS []uint `json:"sysUserIDS,omitempty"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
|
|||
|
|
// 搜索组织功能（未使用）
|
|||
|
|
type OrganizationSearch struct {
|
|||
|
|
organization.Organization
|
|||
|
|
request.PageInfo
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 搜索组织内用户功能
|
|||
|
|
type OrgUserSearch struct {
|
|||
|
|
organization.OrgUser
|
|||
|
|
UserName string `json:"userName" form:"userName"`
|
|||
|
|
request.PageInfo
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
### 3. 方法API
|
|||
|
|
|
|||
|
|
无，后续维护会增加便捷查询当前用户所属组织，所属组织子组织以及成员等便捷方法，根据反馈添加。
|
|||
|
|
|
|||
|
|
### 4. 可直接调用的接口
|
|||
|
|
|
|||
|
|
POST /org/createOrganization // 新建Organization
|
|||
|
|
入参为 Organization 结构体
|
|||
|
|
|
|||
|
|
DELETE /org/deleteOrganization // 删除Organization
|
|||
|
|
入参为 ID int
|
|||
|
|
|
|||
|
|
|
|||
|
|
DELETE /org/deleteOrganizationByIds // 批量删除Organization
|
|||
|
|
入参为 IDS:[]int
|
|||
|
|
|
|||
|
|
|
|||
|
|
PUT /org/updateOrganization // 更新Organization
|
|||
|
|
入参为 Organization 结构体
|
|||
|
|
|
|||
|
|
|
|||
|
|
POST /org/createOrgUser // 人员入职
|
|||
|
|
入参为 OrgUserReq 结构体
|
|||
|
|
|
|||
|
|
|
|||
|
|
PUT /org/setOrgUserAdmin // 管理员设置
|
|||
|
|
入参为 {
|
|||
|
|
sysUserID: 用户id,
|
|||
|
|
isAdmin: 是否管理员 bool
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
|
|||
|
|
GET /org/findOrganization // 根据ID获取Organization
|
|||
|
|
入参为 { ID: 组织id }
|
|||
|
|
|
|||
|
|
|
|||
|
|
GET /org/getOrganizationList // 获取Organization列表
|
|||
|
|
无需入参
|
|||
|
|
|
|||
|
|
|
|||
|
|
GET /org/findOrgUserAll // 获取当前组织下所有用户ID
|
|||
|
|
入参为 { organizationID: 组织id }
|
|||
|
|
|
|||
|
|
|
|||
|
|
GET /org/findOrgUserList // 获取当前组织下所有用户（分页）
|
|||
|
|
入参为 OrgUserSearch 结构体
|
|||
|
|
|
|||
|
|
|
|||
|
|
DELETE /org/deleteOrgUser // 删除当前组织下选中用户
|
|||
|
|
入参为 { sysUserIDS:用户id []int, organizationID: 当前组织id }
|
|||
|
|
|
|||
|
|
|
|||
|
|
PUT /org/transferOrgUser // 用户转移组织
|
|||
|
|
入参为 sysUserIDS: 需要操作的用户的ids []int,
|
|||
|
|
organizationID: 原始组织ID int,
|
|||
|
|
toOrganizationID: 目标组织ID int,
|
|||
|
|
|