@ -1,21 +1,45 @@ |
|||
# Databasir |
|||
## 简介 |
|||
|
|||
**Databasir** 是面向团队的**关系型数据库模型文档管理平台**,旨在通过自动化的方式解决模型文档管理过程中维护成本高、内容更新不及时以及团队协作复杂等问题。 |
|||
|
|||
## 简介 |
|||
平台文档:https://doc.databasir.com |
|||
|
|||
问题反馈:https://github.com/vran-dev/databasir/issues |
|||
|
|||
平台演示:[https://demo.databasir.com](http://121.4.67.27/) |
|||
|
|||
| 账号 | 密码 | 角色 | |
|||
| ---- | ------- | ---------- | |
|||
| demo | demo123 | 系统管理员 | |
|||
| dev | dev123 | 普通 | |
|||
|
|||
## 特性 |
|||
|
|||
1. 兼容市面多数数据库:支持所有拥有 JDBC 驱动的数据库,mysql、postgresql 开箱即用 |
|||
2. 丰富的文档管理功能:支持文档自动同步,版本历史回溯,版本差异对比,文档讨论,UML 生成, 文档导出等,应有尽有 |
|||
3. 面向团队的专业能力:扁平化的角色管理,支持 Github \ Github Enterprise \ Gitlab 的 OAuth2 登录,日志审计 |
|||
|
|||
更多内容请到 https://doc.databasir.com 查看 |
|||
|
|||
- 文档页面展示 |
|||
|
|||
**Databasir** 是一款集中式的数据库文档管理工具,提供了自动化、版本化、扁平化的数据库文档管理能力,主要功能如下 |
|||
![](docs/README/document-diff.gif) |
|||
|
|||
1. 支持所有实现 JDBC 协议的数据库(如 mysql、postgresql、sqlserver等) |
|||
2. 支持 Markdown 文档、Excel 文档(TODO)、UML 图片导出 |
|||
3. 支持 Github / Github Enterprise / Gitlab 的 OAuth2 登录配置 |
|||
4. 支持文档自动同步、历史版本查看、团队讨论、字段描述等 |
|||
5. 扁平化的团队管理模式,灵活适应不同团队组织架构 |
|||
更多规划功能,敬请期待 |
|||
|
|||
更多内容,请查看[官网](https://blog.cc1234.cc/databasir) |
|||
1. 文档导出格式 |
|||
- [x] UML 图片 |
|||
- [x] Markdown |
|||
- [ ] Excel |
|||
- [ ] Word |
|||
2. 邮件通知 |
|||
- [ ] 新增讨论 |
|||
- [ ] 版本变更 |
|||
|
|||
## 联系作者 |
|||
|
|||
## 功能展示 |
|||
![](docs/qrcode.jpg) |
|||
|
|||
- 文档页面 |
|||
## License |
|||
|
|||
![uml](docs/README/document-uml.gif) |
|||
Apache License 2.0 |
@ -1,61 +1,46 @@ |
|||
## 简介 |
|||
|
|||
# 简介 |
|||
![](databasir.png) 是面向团队的**关系型数据库模型文档管理平台**,旨在通过自动化的方式解决模型文档管理过程中维护成本高、内容更新不及时以及团队协作复杂等问题。 |
|||
|
|||
**Databasir** 是一款集中式的数据库文档管理工具,提供了自动化、版本化、扁平化的数据库文档管理能力,主要功能如下 |
|||
平台文档:https://doc.databasir.com |
|||
|
|||
1. 支持所有实现 JDBC 协议的数据库(如 mysql、postgresql、sqlserver等) |
|||
2. 支持 Markdown 文档、Excel 文档(TODO)、UML 图片导出 |
|||
3. 支持 Github / Github Enterprise / Gitlab 的 OAuth2 登录配置 |
|||
4. 支持文档自动同步、历史版本查看、团队讨论、字段描述等 |
|||
5. 扁平化的团队管理模式,灵活适应不同团队组织架构 |
|||
问题反馈:https://github.com/vran-dev/databasir/issues |
|||
|
|||
平台演示:[https://demo.databasir.com](http://121.4.67.27/) |
|||
|
|||
## 功能规划 |
|||
| 账号 | 密码 | 角色 | |
|||
| ---- | ------- | ---------- | |
|||
| demo | demo123 | 系统管理员 | |
|||
| dev | dev123 | 普通 | |
|||
|
|||
- [x] 用户操作审计日志 |
|||
- [x] 文档自动同步日志 |
|||
- [ ] Excel 文档导出 |
|||
- [x] Markdown 文档导出 |
|||
- [x] Github OAuth2 登录模式 |
|||
- [x] Gitlab OAuth2 登录模式 |
|||
- [x] 模型 UML 生成 |
|||
- [x] UML 图片导出 |
|||
|
|||
## 特性 |
|||
|
|||
## 功能展示 |
|||
1. 兼容市面多数数据库:支持所有拥有 JDBC 驱动的数据库,mysql、postgresql 开箱即用 |
|||
2. 丰富的文档管理功能:支持文档自动同步,版本历史回溯,版本差异对比,文档讨论,UML 生成, 文档导出等,应有尽有 |
|||
3. 面向团队的专业能力:扁平化的角色管理,支持 Github \ Github Enterprise \ Gitlab 的 OAuth2 登录,日志审计 |
|||
|
|||
- 文档页面 |
|||
- 图片展示 |
|||
|
|||
![uml](README/document-uml.gif) |
|||
<img src="README/document-diff.gif" height="500px" width="800px"> |
|||
|
|||
- 分组创建 |
|||
## 规划 |
|||
|
|||
![](README/group-create.gif) |
|||
1. 文档导出格式 |
|||
- [x] UML 图片 |
|||
- [x] Markdown |
|||
- [ ] Excel |
|||
- [ ] Word |
|||
2. 邮件通知 |
|||
- [ ] 文档新增讨论 |
|||
- [ ] 文档版本变更 |
|||
|
|||
- 项目创建 |
|||
## 更多 |
|||
|
|||
![](README/project-create.gif) |
|||
交流群:暂无 |
|||
|
|||
- 项目同步 |
|||
邮箱:vran_dev@foxmail.com |
|||
|
|||
![](README/project-sync.gif) |
|||
公众号 |
|||
|
|||
- 协作讨论 |
|||
|
|||
![](README/document-discussion.gif) |
|||
|
|||
- 分组成员 |
|||
|
|||
![](README/group-member.gif) |
|||
|
|||
- 用户创建 |
|||
|
|||
![](README/user-create.gif) |
|||
|
|||
- 用户详情 |
|||
|
|||
![](README/user-detail.gif) |
|||
|
|||
- 操作日志 |
|||
|
|||
![](README/log-list.gif) |
|||
![](qrcode.jpg) |
After Width: | Height: | Size: 1.4 MiB |
After Width: | Height: | Size: 23 KiB |
After Width: | Height: | Size: 31 KiB |
After Width: | Height: | Size: 36 KiB |
@ -0,0 +1,41 @@ |
|||
# 分组与项目 |
|||
|
|||
分组(Group)和项目(Project)是 Databasir 中最基础的概念,它们之间的关系如下图所示 |
|||
|
|||
![group-and-project](img/group.png) |
|||
|
|||
## 分组(Group) |
|||
|
|||
![group-and-project](img/group-sample.png) |
|||
|
|||
分组是由项目和成员共同组成,它们之间有着非常明确对应关系 |
|||
|
|||
- 一个分组下有多个成员(用户) |
|||
- 一个分组下有多个项目 |
|||
|
|||
每个成员(用户)在所属分组可以承担两种角色,分别是 |
|||
|
|||
- 组长:拥有该分组下的所有读写权限 |
|||
- 组员:拥有该分组下的部分写权限,全部读权限 |
|||
|
|||
对于每个用户来说,他可以加入多个分组,在不同的分组承担不同的角色。 |
|||
|
|||
Databasir 并没有将分组和企业中的组织或开发中的环境做强行的绑定,你可以灵活的使用它,推荐的做法是 |
|||
|
|||
- 如果你的项目数不多,可以使用分组作为环境管理,比如创建 dev、qa、prod 三个分组 |
|||
- 如果你所在团队很大,可以将分组对应到不同的业务线,比如公共设施组、电商平台组、物流平台组等 |
|||
|
|||
## 项目(Project) |
|||
|
|||
![img.png](img/project-sample.png) |
|||
|
|||
`Database per Project` 是 Databasir 中的基本概念,见名知意,也就是一个项目其实对应一个数据库。 |
|||
|
|||
项目必须建立在某个指定的分组下面,不能独立存在,它是 Databasir 管理的最小单位,主要维护了以下信息 |
|||
|
|||
- 对应数据库的连接信息 |
|||
- 文档同步规则,比如:字段过滤条件、定时同步时间等 |
|||
- 数据库模型文档所有历史版本数据 |
|||
- 数据库模型文档的讨论 |
|||
|
|||
项目支持手动和自动同步,每次同步时 Databasir 会与项目当前最新版本文档做对比,如果没有结构变更,则不会生成新的版本。 |
After Width: | Height: | Size: 39 KiB |
After Width: | Height: | Size: 24 KiB |
@ -0,0 +1,28 @@ |
|||
# 邮箱设置 |
|||
|
|||
Databasir 很多通知会通过邮件的形式进行发送,比如 |
|||
|
|||
- 项目版本变更 |
|||
- 项目新增讨论 |
|||
- 重置密码 |
|||
|
|||
这些通知只有在管理员为系统设置了默认邮箱时才能正常使用。 |
|||
|
|||
## 新增邮箱 |
|||
邮箱的设置入口如下图所示 |
|||
|
|||
![img.png](img/email-menu.png) |
|||
|
|||
点击就可以进入邮箱配置页面,目前支持使用 SMTP 协议进行配置。 |
|||
|
|||
![img.png](img/email-setting.png) |
|||
|
|||
验证邮箱配置是否成功可以在用户管理列表页中点击**重置密码**,如果邮箱配置正常,那么对应用户的邮箱会收到重置后的新密码 |
|||
|
|||
## 重置邮箱 |
|||
|
|||
如果想关闭系统的推送,可以**重置邮箱**,这样系统的邮箱配置就会回到初始状态。 |
|||
|
|||
重置功能位于邮箱配置页面,点击**重置按钮**即可完成 |
|||
|
|||
![img.png](img/email-setting.png) |
After Width: | Height: | Size: 52 KiB |
After Width: | Height: | Size: 49 KiB |
After Width: | Height: | Size: 50 KiB |
After Width: | Height: | Size: 52 KiB |
After Width: | Height: | Size: 64 KiB |
After Width: | Height: | Size: 65 KiB |
After Width: | Height: | Size: 61 KiB |
After Width: | Height: | Size: 46 KiB |
After Width: | Height: | Size: 49 KiB |
After Width: | Height: | Size: 83 KiB |
After Width: | Height: | Size: 58 KiB |
@ -0,0 +1,95 @@ |
|||
# 分组管理 |
|||
|
|||
如果你还不清楚 Databasir 中分组的概念,可以先阅读[分组与项目](/README/group-and-project/index.md)一节 |
|||
|
|||
## 创建分组 |
|||
|
|||
Note:**只有系统管理员才可以创建分组** |
|||
|
|||
在成功登入 Databasir 后就会默认进入**分组列表页**,该页面将会以卡片的形式展示平台中已创建的所有分组。 |
|||
|
|||
![](img/group-add1.png) |
|||
|
|||
点击左上角蓝色的 + 号就可以弹窗分组创建页,需要填写三个信息 |
|||
|
|||
- 名称:即列表页展示的组名 |
|||
- 描述:简要描述分组信息 |
|||
- 组长:该分组的负责人,支持通过名称、邮箱搜索 |
|||
|
|||
![](img/group-add2.png) |
|||
|
|||
信息填写完成以后点击确定即可创建成功 |
|||
|
|||
![](img/group-add3.png) |
|||
|
|||
|
|||
|
|||
## 删除分组 |
|||
|
|||
Note:只有系统管理员和组长可以删除分组 |
|||
|
|||
在分组列表页,将鼠标移到想要删除的分组上面就会在名称左边显现出一个编辑图标 |
|||
|
|||
![](img/group-delete1.png) |
|||
|
|||
点击该按钮进入分组编辑页 |
|||
|
|||
![](img/group-delete2.png) |
|||
|
|||
点击**确认删除分组**后再次弹出一个警告框,最终确认以后就成功删除该分组了 |
|||
|
|||
![](img/group-delete3.png) |
|||
|
|||
## 添加移除成员 |
|||
|
|||
Note:只有系统管理员和组长可以添加移除成员 |
|||
|
|||
成员的管理有两种方式 |
|||
|
|||
**一、在分组编辑页管理** |
|||
|
|||
在分组的编辑页面上可以添加或删除组长(仅可增删组长) |
|||
|
|||
添加的过程和前面创建分组时一样,在搜索框搜索用户然后点击即可添加,完成以后记得保存方可生效。 |
|||
|
|||
删除分组的话只需要点击组长标签右侧的 x 按钮即可,同样,完成以后记得保存方可生效。 |
|||
|
|||
![](img/group-member1.png) |
|||
|
|||
**二、在成员管理页管理** |
|||
|
|||
通过点击分组列表页中的组名可以跳转到分组详情页中,该页面有两个 Tab |
|||
|
|||
- 项目列表 |
|||
- 分组成员 |
|||
|
|||
![](img/group-member2.png) |
|||
|
|||
|
|||
|
|||
点击分组成员即可进入成员管理 Tab 页,在该页面我们可以通过点击**移除**按钮将用户移出该分组 |
|||
|
|||
![](img/group-member3.png) |
|||
|
|||
|
|||
|
|||
通过点击左上角的**添加成员**按钮就可以进入成员选择页面进行添加,可以作为组员添加,也可以作为组长添加,按需选择。 |
|||
|
|||
在该页面我们可以通过点击**移除**按钮将用户移出该分组。 |
|||
|
|||
![](img/group-member4.png) |
|||
|
|||
|
|||
|
|||
## 修改成员角色 |
|||
|
|||
Note:只有系统管理员和组长可以修改成员角色 |
|||
|
|||
如果我们想修改一个用户在分组内的角色,只需要在分组成员 Tab 页进行切换就可以 |
|||
|
|||
- 如果该用户是组员,则会出现**升为组长**的按钮 |
|||
- 如果该用户是组长,则会出现**设为组员**的按钮 |
|||
|
|||
![](img/group-role1.png) |
|||
|
|||
组长拥有所属分组的所有读写权限,包括修改其他组长的角色,但是组长无法修改自己的角色 |
After Width: | Height: | Size: 102 KiB |
After Width: | Height: | Size: 108 KiB |
After Width: | Height: | Size: 120 KiB |
After Width: | Height: | Size: 108 KiB |
After Width: | Height: | Size: 123 KiB |
After Width: | Height: | Size: 48 KiB |
After Width: | Height: | Size: 77 KiB |
After Width: | Height: | Size: 71 KiB |
After Width: | Height: | Size: 49 KiB |
After Width: | Height: | Size: 81 KiB |
After Width: | Height: | Size: 79 KiB |
After Width: | Height: | Size: 86 KiB |
After Width: | Height: | Size: 90 KiB |
After Width: | Height: | Size: 48 KiB |
After Width: | Height: | Size: 82 KiB |
After Width: | Height: | Size: 54 KiB |
After Width: | Height: | Size: 60 KiB |
After Width: | Height: | Size: 76 KiB |
After Width: | Height: | Size: 86 KiB |
After Width: | Height: | Size: 76 KiB |
After Width: | Height: | Size: 78 KiB |
After Width: | Height: | Size: 88 KiB |
After Width: | Height: | Size: 58 KiB |
After Width: | Height: | Size: 37 KiB |
After Width: | Height: | Size: 104 KiB |
@ -0,0 +1,196 @@ |
|||
# 项目管理 |
|||
如果你还不清楚 Databasir 中分组的概念,可以先阅读[分组与项目](/README/group-and-project/index.md)一节 |
|||
|
|||
## 创建项目 |
|||
|
|||
项目必须创建在指定分组下面,所以在创建项目前需要先创建分组。 |
|||
|
|||
在所属分组中,组员和组长都拥有创建项目的权限,在分组详情页中我们可以点击**新建**按钮开始创建项目 |
|||
|
|||
![](img/project-create1.png) |
|||
|
|||
点击以后我们就可以进入项目创建表单页,页面是一个 Tab 页,有**基础配置**和**高级配置**两个 Tab |
|||
|
|||
- 基础配置 Tab:项目的名称、数据库连接等配置 |
|||
- 高级配置 Tab:项目的定时同步规则、忽略表和列配置 |
|||
|
|||
我们先只关注**基础配置**,这个页面分为两个部分 |
|||
|
|||
- 基础信息 |
|||
- 连接配置 |
|||
|
|||
![](img/project-create2.png) |
|||
|
|||
表单大部分内容都不用多说,可能数据库名称和 Schema 名称会让人有点迷惑,我以 mysql、postgresql、sqlserver 为例来说明这两者的区别 |
|||
|
|||
| | 数据库名称 | Schema 名称 | |
|||
| ---------- | --------------------------------------------------- | --------------------------------------------------- | |
|||
| Mysql | 创建数据库时指定的名称 | 对于 Mysql 来说,schema 名称和数据库名称是一样的 | |
|||
| Postgresql | 创建数据库时指定的名称 | 如果在 DDL 中没有指定,Postgresql 默认使用 `public` | |
|||
| Sqlserver | 如果在 DDL 中没有指定,sqlserver 默认使用 `Master` | 创建 Schema 时指定的名称 | |
|||
|
|||
填完连接信息以后可以通过**测试连接**按钮验证是否能成功连接到数据库,当然,即使连接不成功你也可以先保存下来。 |
|||
|
|||
![](img/project-create3.png) |
|||
|
|||
保存完成以后就可以在列表页看见该项目了 |
|||
|
|||
![](img/project-create4.png) |
|||
|
|||
|
|||
|
|||
## 删除项目 |
|||
|
|||
在所属分组内,组长和组员都用有删除项目的权限。 |
|||
|
|||
删除项目很简单,只需要在项目列表页的**更多**菜单中点击**删除项目**即可 |
|||
|
|||
![](img/project-delete1.png) |
|||
|
|||
删除需要二次确认,请谨慎操作 |
|||
|
|||
![](img/project-delete2.png) |
|||
|
|||
|
|||
|
|||
## 关注项目 |
|||
|
|||
由于每次查看文档都需要先在分组列表页确定分组,然后在项目列表页确定项目,最后才能查看到文档。 |
|||
|
|||
对于每个用户来说,80% 的时间可能都只是在查阅 20% 的项目文档,所以缩减浏览路径将会大大的提升用户体验。 |
|||
|
|||
**关注项目**这个功能就是在这样的背景之下产生,它位于首页 Tab,平台会记住用户最近在项目分组和关注项目这两个 Tab 的选择。 |
|||
|
|||
比如这次点击了关注项目这个 Tab,下次回到首页以后那么默认选中的就是关注项目 Tab 页 |
|||
|
|||
![](img/project-fav1.png) |
|||
|
|||
|
|||
|
|||
那么如何关注项目呢? |
|||
|
|||
只需要在项目列表页的**更多**菜单中点击对应项目的**关注项目**按钮即可 |
|||
|
|||
![](img/project-fav2.png) |
|||
|
|||
关注完成以后,项目名称前面会多一个 ☆ 标记,回到首页的关注项目 Tab 页,此时也能看到我们的关注项目了。 |
|||
|
|||
![](img/project-fav3.png) |
|||
|
|||
|
|||
|
|||
通过点击关注项目列表中的分组名称可以快速回到该项目所属的分组详情页中去。 |
|||
|
|||
如果要取消关注,只需要在更多中点击**取消关注**即可 |
|||
|
|||
![](img/project-fav4.png) |
|||
|
|||
## 手动同步 |
|||
|
|||
项目创建完成以后,就可以进入文档页面同步并生成文档了,在更多中点击**查看文档**按钮,或者你也可以直接点击项目名称快捷跳转 |
|||
|
|||
![](img/project-sync1.png) |
|||
|
|||
初次进入文档页面时,会显示空内容,这时我们需要手动点击一下 |
|||
|
|||
![](img/project-sync2.png) |
|||
|
|||
同步完成以后,系统会自动刷新数据,如下图所示 |
|||
|
|||
![](img/project-sync3.png) |
|||
|
|||
|
|||
|
|||
在该页面仍可以点击同步按钮同步文档,**但 Databasir 会自动与当前最新版本的文档做对比,如果没有结构变更,不会创建新的版本内容。** |
|||
|
|||
## 定时同步 |
|||
|
|||
每次手动同步文档需要依赖人做操作,这可能造成文档更新的不及时,定时同步则可以解决这个问题。 |
|||
|
|||
目前 Databasir 支持按项目配置定时同步规则,时间周期配置使用 cron 表达式。 |
|||
|
|||
配置页面位于项目编辑页,该页面有**基础配置**和**高级配置**两个 Tab 页,选择高级配置切换页面后就可以看到定时同步的切换按钮,该功能默认是关闭的 |
|||
|
|||
![image-20220321095725657](img/project-schedule1.png) |
|||
|
|||
启用以后会要求再输入一个 cron 表达式,比如我这里配置一个每十分钟执行一次的表达式:`0 0/10 * * * ? `,配置完成后点击保存就生效了 |
|||
|
|||
![](img/project-schedule2.png) |
|||
|
|||
同步记录可以在项目日志里面查看 |
|||
|
|||
![](img/project-schedule3.png) |
|||
|
|||
## 忽略表、列同步 |
|||
|
|||
模型文档同步中经常需要过滤某些表或字段,在 Databasir 中我们可以通过正则表达式的方式来进行规则配置。 |
|||
|
|||
配置页面位于项目编辑页,该页面有**基础配置**和**高级配置**两个 Tab 页,选中高级配置即可看见忽略配置项 |
|||
|
|||
![](img/project-ignore1.png) |
|||
|
|||
下面我配置了几个忽略规则 |
|||
|
|||
表忽略规则 |
|||
|
|||
- `flyway.*` : 忽略以 flyway 开头命名的表 |
|||
- `demo.*`:忽略以 demo 开头命名的表 |
|||
- `.*[1-9]$`:忽略以数字 1~9 结尾的表名,这种情况常用于分库分表的场景 |
|||
|
|||
列忽略规则 |
|||
|
|||
- `create_at.*`:忽略以 create_at 开头命名的列 |
|||
|
|||
![](img/project-ignore2.png) |
|||
|
|||
点击保存即可完成配置 |
|||
|
|||
## 文档导出 |
|||
|
|||
Databasir 支持多种类型的文档格式导出,该功能位于文档详情页面to,通过项目列表中点击指定项目的**查看文档**进入 |
|||
|
|||
![](img/project-export1.png) |
|||
|
|||
|
|||
|
|||
进入文档页面以后,鼠标指向**导出**按钮即可显示出目前支持的文档导出格式 |
|||
|
|||
![](img/project-export2.png) |
|||
|
|||
|
|||
|
|||
## 版本差异对比 |
|||
|
|||
如果成功同步了多个版本的文档,你可以随意的选择版本进行差异对比。 |
|||
|
|||
在文档页面,点击**显示版本差异**按钮 |
|||
|
|||
![](img/doc-diff1.png) |
|||
|
|||
启用以后会出现一个对比版本的下拉框,选择我们要对比的版本,默认情况下基础版本是最新的,也就是在对比新版本比老版本有什么变化 |
|||
|
|||
![](img/doc-diff2.png) |
|||
|
|||
选中版本以后就自动出现了差异标记 |
|||
|
|||
- 绿色:标识新增 |
|||
- 红色:标识删除 |
|||
- 黄色:标识修改 |
|||
- 灰色:标识无变化 |
|||
|
|||
![](img/doc-diff3.png) |
|||
|
|||
比如下图 |
|||
|
|||
- 删除了 document_remark 表 |
|||
- 修改了 table_column_document、table_document 表 |
|||
- 新增了 table_foreign_key_document 表 |
|||
|
|||
![](img/doc-diff4.png) |
|||
|
|||
切换到修改表的地方,可以查看具体的修改内容,比如下图就展示了 |
|||
|
|||
- type 字段的类型由 text 改为了 varchar |
|||
- comment 字段的类型由 text 改为了 varchar |
|||
|
|||
![](img/doc-diff5.png) |
After Width: | Height: | Size: 58 KiB |
After Width: | Height: | Size: 62 KiB |
After Width: | Height: | Size: 67 KiB |
After Width: | Height: | Size: 66 KiB |
After Width: | Height: | Size: 85 KiB |
After Width: | Height: | Size: 54 KiB |
After Width: | Height: | Size: 76 KiB |
After Width: | Height: | Size: 73 KiB |
After Width: | Height: | Size: 66 KiB |
@ -0,0 +1,58 @@ |
|||
# 用户管理 |
|||
|
|||
用户管理模块只有系统管理员有权限执行操作 |
|||
|
|||
![](img/user-management.png) |
|||
|
|||
|
|||
|
|||
## 新增用户 |
|||
|
|||
在用户中心,点击左上角的 + 号即可创建一个新用户 |
|||
|
|||
![](img/user-create1.png) |
|||
|
|||
进入表单页后,需要填写用户的基础信息,并为该用户设置一个密码,默认状态下是未启用状态,需要手动启用。 |
|||
|
|||
Databasir 目前不会校验邮箱的真实性,请确保邮箱填写正确 |
|||
|
|||
![](img/user-create2.png) |
|||
|
|||
点击保存以后就可以在列表页看见刚刚新增的用户了 |
|||
|
|||
![](img/user-create3.png) |
|||
|
|||
|
|||
|
|||
## 用户详情 |
|||
|
|||
有时候会想查看某个用户加入了哪些分组以及他的一些详细信息,这时候可以通过用户详情查看,该功能位于用户列表页 |
|||
|
|||
![](img/user-detail1.png) |
|||
|
|||
点击邮箱即可看到详情页,里面会展示用户的详细信息,包括加入的分组,在所属分组承担的角色等。 |
|||
|
|||
通过点击分组还可以快捷跳转到分组详情页面 |
|||
|
|||
![](img/user-detail2.png) |
|||
|
|||
|
|||
|
|||
## 修改密码 |
|||
|
|||
Databasir 目前支持两种修改密码的方式 |
|||
|
|||
- 第一种:系统管理员为指定用户重置密码,新密码通过邮件下发 |
|||
- 第二种:登录用户通过旧密码确认来修改 |
|||
|
|||
第一种方式位于用户中心页面,只有系统管理员才可以进入并有权限执行**重置密码** |
|||
|
|||
![](img/user-pwd1.png) |
|||
|
|||
第二种方式位于个人主页,可以通过右上角的头像进入,也可以通过侧边栏进入 |
|||
|
|||
![](img/user-pwd2.png) |
|||
|
|||
进入个人主页以后,点击修改密码,就可以通过旧密码验证的方式修改为新密码了 |
|||
|
|||
![](img/user-pwd3.png) |
@ -1,18 +1,65 @@ |
|||
# 用户角色说明与配置 |
|||
## 角色列表 |
|||
# 用户角色与权限 |
|||
|
|||
在 Databasir 中拥有四个角色 |
|||
## 角色说明 |
|||
|
|||
Databasir 将用户分为了 4 种角色,它们分别是 |
|||
|
|||
- 系统管理员 |
|||
- 组长 |
|||
- 组员 |
|||
- 游客 |
|||
|
|||
为了保持系统的开放性,每一个登录系统的用户,默认就是**游客**角色,该角色拥有分组、项目文档的读取权限。 |
|||
每个角色的说明以及可配置数量见下面表格 |
|||
|
|||
| 角色 | 说明 | 数量 | |
|||
| ---------- | ------------------------------------------------ | ------------------ | |
|||
| 系统管理员 | 拥有平台所有权限 | 任意 | |
|||
| 组长 | 拥有对应分组下所有读写权限 | 一个分组最多 20 个 | |
|||
| 组员 | 拥有对应分组下部分写权限,所有读权限 | 任意 | |
|||
| 游客 | 登入用户的默认角色,能够看见所有分组以及项目文档 | 任意 | |
|||
|
|||
## 默认权限 |
|||
|
|||
由于创建分组、数据库扩展等功能只有系统管理员才有,建议为平台设置多位系统管理员。 |
|||
|
|||
- 分组模块各角色权限详情 |
|||
|
|||
| 功能 | 组员 | 组长 | 游客 | 系统管理员 | |
|||
|----------| ---- | ---- | ---- | ---------- | |
|||
| **分组模块** | 部分 | 全部 | 只读 | 全部 | |
|||
| 查看分组 | √ | √ | √ | √ | |
|||
| 编辑分组 | x | √ | x | √ | |
|||
| 删除分组 | x | √ | x | √ | |
|||
| 查看组员 | √ | √ | √ | √ | |
|||
| 添加组员 | x | √ | x | √ | |
|||
| 删除组员 | x | √ | x | √ | |
|||
|
|||
- 项目模块各角色权限详情 |
|||
|
|||
| 功能 | 组员 | 组长 | 游客 | 系统管理员 | |
|||
|----------| ---- | ---- | ---- | ---------- | |
|||
| **项目模块** | 部分 | 全部 | 只读 | 全部 | |
|||
| 查看项目 | √ | √ | √ | √ | |
|||
| 创建项目 | √ | √ | x | √ | |
|||
| 删除项目 | √ | √ | x | √ | |
|||
| 编辑项目 | √ | √ | x | √ | |
|||
| 查看讨论 | √ | √ | √ | √ | |
|||
| 新增讨论 | √ | √ | x | √ | |
|||
| 删除讨论 | x | √ | x | √ | |
|||
| 编辑描述 | √ | √ | x | √ | |
|||
|
|||
- 其余模块只有系统管理员才有 |
|||
|
|||
| 功能 | 组员 | 组长 | 游客 | 系统管理员 | |
|||
|----------| ---- | ---- | ---- | ---------- | |
|||
| **用户模块** | x | x | x | √ | |
|||
| **数据库管理** | x | x | x | √ | |
|||
| **系统邮箱管理** | x | x | x | √ | |
|||
| **登录设置** | x | x | x | √ | |
|||
| **系统日志** | x | x | x | √ | |
|||
|
|||
|
|||
|
|||
系统管理员就不多说了,该角色拥有系统的所有读写权限。 |
|||
|
|||
组长的话,拥有所属分组、以及分组下所有项目的读写权限。 |
|||
|
|||
组员拥有所属分组下所有项目的读写权限,相对于组长,组员缺少对分组的管理权限。 |
|||
|
|||
|
After Width: | Height: | Size: 1.1 KiB |
After Width: | Height: | Size: 6.8 KiB |
After Width: | Height: | Size: 27 KiB |