diff --git a/docs/uniCloud/_sidebar.md b/docs/uniCloud/_sidebar.md index 1f481c2b16821270758ffb115a5338c08c2f12d5..9c228d2e1219a83e85a9b2b9b64e193c2500a84c 100644 --- a/docs/uniCloud/_sidebar.md +++ b/docs/uniCloud/_sidebar.md @@ -19,6 +19,7 @@ * [腾讯云权限管理](uniCloud/policy-tcb.md) * 扩展能力 * [uni-id](uniCloud/uni-id.md) + * [admin](uniCloud/admin.md) * [uni-clientDB](uniCloud/uni-clientDB.md) * [DB-Schema](uniCloud/schema.md) * [unipay](uniCloud/unipay.md) diff --git a/docs/uniCloud/admin.md b/docs/uniCloud/admin.md index bec968f5811935685e9642d4e03c814179bd4397..282a4222963495710dd3333482991d6a7408d187 100644 --- a/docs/uniCloud/admin.md +++ b/docs/uniCloud/admin.md @@ -1,6 +1,38 @@ # uni-template-admin -> 基于 uni-app,uniCloud 的 admin 管理项目模板,前端工程师完成页面开发的同时,也可以用 JS 开发服务端 api,轻松搞定前后台整体业务。 +### 什么是uniCloud Admin + +uniCloud Admin,是基于uni-app和uniCloud的应用后台管理框架。 + +- 它使用uni-app的宽屏适配,可自动适配PC宽屏和手机各端。了解[宽屏适配](https://uniapp.dcloud.io/adapt) +- 它基于uniCloud,是serverless的云开发。了解[uniCloud](https://uniapp.dcloud.io/uniCloud/README) +- 它基于uni-id,是uniCloud之上的用户账户、权限系统。了解[uni-id](https://uniapp.dcloud.io/uniCloud/uni-id) + +> 它只是一个框架,具体业务需要开发者自己开发或从插件市场导入相关插件 + +### uniCloud Admin内置的功能包括: + +- 管理员账户初始化、登录、修改密码 +- 顶部topWindow的设置:比如logo更换、右上角部分连接更换。详见项目根目录的`admin.config.js`文件 +- 左侧leftWindow的菜单设置:菜单包括两类,一类是动态菜单,具备业务和权限功能,在数据库的`opendb-admin-menu`表中增加删除菜单;另一类是静态菜单,不会根据登录用户角色变化,在项目根目录的`admin.config.js`文件中配置 +- 开发模式下的 debug 功能,帮助开发者及时发现报错和搜索错误信息,可在`admin.config.js`文件中配置 + +### PC 宽屏和移动端上的 UI 表现 + +
+
+
+ +
+

PC端

+
+
+
+ +
+

移动端

+
+
### 使用 @@ -75,7 +107,7 @@ $top-window-text-color: #999; /* 文字颜色 */ > 源码 [windows/leftWindow.vue](https://github.com/dcloudio/uni-template-admin/blob/master/windows/leftWindow.vue) -1. 通过 [admin.config.js](https://github.com/dcloudio/uni-template-admin/blob/master/admin.config.js) 配置侧边栏内容 +1. 通过 [admin.config.js](https://github.com/dcloudio/uni-template-admin/blob/master/admin.config.js) 配置侧边栏内容,侧边栏的菜单包括根据用户角色动态显示的动态菜单,也有所有角都能看到静态菜单。 ```js export default { @@ -117,15 +149,15 @@ $menu-text-color-actived: #409eff; /* 菜单激活前景色 */ ### 权限系统 -> 基于 [uni-id](https://uniapp.dcloud.io/uniCloud/uni-id?id=rbac-api) 角色权限 +> 基于 [uni-id](https://uniapp.dcloud.io/uniCloud/uni-id?id=rbac-api) 角色权限, uni-id 是 uniCloud之上的用户账户、权限系统 -1. 角色表 +1. 角色表 `uni-id-roles` > [详情](https://uniapp.dcloud.io/uniCloud/uni-id?id=%e8%a7%92%e8%89%b2%e8%a1%a8) -2. 权限表 +2. 权限表 `uni-id-permissions` > [详情](https://uniapp.dcloud.io/uniCloud/uni-id?id=%e6%9d%83%e9%99%90%e8%a1%a8) -3. 菜单表 +3. 菜单表 `opendb-admin-menu` | 字段 | 类型 | 必填 | 描述 | - | ---------- | --------- | ---- | -------------------------------------- | + | ---------- | --------- | ---- | ------- | | \_id | Object ID | 是 | 系统自动生成的 Id | | name | String | 是 | 菜单文字 | | icon | String | 否 | 菜单图标 | @@ -135,7 +167,9 @@ $menu-text-color-actived: #409eff; /* 菜单激活前景色 */ | permission | Array | 否 | 菜单权限(只有没有子菜单的菜单项可以配置) | | status | Integer | 是 | 菜单状态:0 禁用 1 启用 | | created_date | Timestamp | 是 | 创建时间 | -4. 权限验证 +4. 用户表 `uni-id-users` + > [详情](https://uniapp.dcloud.io/uniCloud/uni-id?id=%e7%94%a8%e6%88%b7%e8%a1%a8) +5. 权限验证 ```html