diff --git a/docs/admin.md b/docs/admin.md index a2cf37e1a38108151dd95a170b2c558b23a1aaac..1ccb3e1c7d594111ded5964de55ebeeebdc3e1e6 100644 --- a/docs/admin.md +++ b/docs/admin.md @@ -127,15 +127,21 @@ uni-admin的`一键部署`，会自动上传云函数、创建数据库，并将 ![download-admin](https://qiniu-web-assets.dcloud.net.cn/unidoc/zh/cloud-init.png) - - #### 运行 1. 进入 admin 项目 -2. 在 `uniCloud/cloudfunctions/common/uni-config-center/uni-id/config.json` 文件中填写自己的 `passwordSecret` 字段 (用于加密密码入库的密钥) 和 `tokenSecret` 字段 (为生成 token 需要的密钥，测试期间跳过本条也可以) -3. 右键 uniCloud目录 运行云服务空间初始化向导，初始化数据库和上传部署云函数（如已创建并绑定云服务空间，则跳过此步） -4. 点击HBuilderX工具栏的运行【Ctrl+r / cmd+r】 -> 运行到浏览器。如果是连接本地云函数调试环境，上一步可以不上传云函数，但数据库仍需初始化。 -5. 从启动后的登录页面的底部，进入创建管理员页面（仅允许注册一次管理员账号） +2. 右键 `uniCloud` 目录关联空间（如果已经关联则跳过第2步） +3. 在 `uniCloud/cloudfunctions/common/uni-config-center/uni-id/config.json` 文件中填写自己的 `passwordSecret` 字段 (用于加密密码入库的密钥) 和 `tokenSecret` 字段 (为生成 token 需要的密钥，测试期间跳过本条也可以) +4. 右键 `uniCloud/cloudfunctions` 目录 上传部署云函数、公共模块 + +![download-admin](https://web-ext-storage.dcloud.net.cn/unicloud/uni-admin/514.png) + +5. 右键 `uniCloud/database` 目录 初始化数据库（HBX的版本需要≥3.9，同时自HBX4.2版本起，执行初始化向导时就会初始化数据库，故如果数据库里已有数据，则不需要再执行数据库初始化) + +![download-admin](https://web-ext-storage.dcloud.net.cn/unicloud/uni-admin/513.png) + +6. 点击HBuilderX工具栏的运行【Ctrl+r / cmd+r】 -> 运行到浏览器。 +7. 从启动后的登录页面的底部，进入创建管理员页面（仅允许注册一次管理员账号） **注意**： @@ -703,7 +709,7 @@ _使用步骤:_ 1. 从[插件市场](https://ext.dcloud.net.cn/)导入插件 2. 在 HBuilder X 3.1+ 中选择添加插件的项目 -3. 在插件的 db_init.json 文件上右键，点击“初始化云数据库” +3. 右键项目根目录的 database 目录，点击“初始化云数据库”（HBX的版本需要≥3.9) 4. 在菜单管理中的添加【待添加菜单】 5. 刷新 admin 即可在菜单栏看到新增的菜单 @@ -726,8 +732,7 @@ _admin 插件的目录结构：_ ├── uniCloud │ ├── cloudfunctions # 云函数 │ └── database -│ ├── xxx.schema.json # 数据库schema文件 -│ └── db_init.json # 数据库初始化文件 +│ └── xxx.schema.json # 数据库schema文件 ├── js_sdk # js sdk ├── pages # 页面 │ └── your-page # 你的页面 @@ -765,7 +770,7 @@ pluginId 为你上传插件市场时填的插件id（插件市场每个插件都 包含%pluginId%-menu.json的插件导入项目后，运行起来uni-admin，菜单管理模块会自动读取这个json文件中的菜单配置，生成【待添加菜单】，配置与 admin【管理动态菜单】同理。插件作者可以在界面上可视化的点击确认添加，即可把菜单加入到他的项目下。 -虽然也可以通过`db_init.json`来进行菜单初始化，但不建议这么操作。很容易发生和用户的数据库的冲突。仍然推荐使用%pluginId%-menu.json方式。 +虽然也可以通过`database`目录来进行菜单初始化，但不建议这么操作。很容易发生和用户的数据库的冲突。仍然推荐使用%pluginId%-menu.json方式。 **关于uni-admin和uni-cloud-router公共模块** uni-admin自带了一个单路由框架，uni-cloud-router，然后自带了一个uni-admin云函数使用了这个uni-cloud-router。但插件作者的插件，不能写在uni-admin的目录下。插件的云函数，要有插件id前缀，如果你想把你的插件的所有云函数合并成一个云函数，可以新建一个你自己的云函数，在里面引用uni-cloud-router公共模块。 @@ -811,7 +816,7 @@ uni-admin框架运行的基础路径默认为`/admin/`，部署到前端网页 ## 常见问题 -### 使用uni-admin新建用户无法登录，会提示“该账号暂无权限登录” ？ +### 使用uni-admin新建用户无法登录，会提示“该账号暂无权限登录” ？@q1 用户登录逻辑：登录时系统检测没有菜单会提示“暂无权限登录”，需要给新账号绑定角色，角色有菜单方可登录 @@ -831,7 +836,20 @@ uni-admin框架运行的基础路径默认为`/admin/`，部署到前端网页 2. 前往uniCloud web控制台 - 云数据库 - 打开uni-id-users表 - 找到刚注册的test账号，复制其password字段的值，修改admin账号的password跟test账号的password一致。 3. 此时admin账号的密码就已经重置为123456了 +### uni-admin创建超级管理员报错 Invalid uni-id config file@q3 + +请查看 `/uni_modules/uni-config-center/uniCloud/cloudfunctions/common/uni-config-center/` 目录下是否有这些目录和文件，如果没有，请先尝试下载 uni-config-center 模块 + +![](https://web-ext-storage.dcloud.net.cn/unicloud/uni-admin/515.png) + +确保下载后的目录是下图这样的，如果下载后还是没有，则需要下载最新版uni-admin，然后从下载的项目中复制过来 + +![](https://web-ext-storage.dcloud.net.cn/unicloud/uni-admin/511.png) + +最后再重新上传 uni-config-center 模块 +![](https://web-ext-storage.dcloud.net.cn/unicloud/uni-admin/516.png) +注意：uni-id 配置文件为标准的 json 文件，里面不可以写注释。