Merge branch 'master' of github.com:yuzd/AntMgr

yuzd · yuzd · commit 5215fa287fba · 2019-06-28T19:07:36.000+08:00
diff --git a/README.md b/README.md
@@ -0,0 +1,123 @@
+
+
+# AntMgr
+基于netcore2.0  mvc 开发的 快速搭建具有如下特色的后台管理系统
+
+# 特色：
+1. 用户管理
+2. 菜单管理
+3. 角色管理
+4. 权限管理[精确到按钮]）
+5. 代码生成器
+
+
+# 如何使用
+代码克隆到本地 用vs2017或以上版本 打开工程。
+
+### 项目结构如下：
+
+![image](https://images4.c-ctrip.com/target/zb0315000000yq3me600A.png)
+![image](https://images4.c-ctrip.com/target/zb0u15000000yoc9r273B.png)
+
+### 找到DbModel下面的初始化db脚本
+![image](https://images4.c-ctrip.com/target/zb0315000000yq3p05596.png)
+
+里面包含4张表的schema和初始化数据，你可以新建一个db，也可以导入到你现有的db
+
+1. system_users           系统用户表
+2. system_menu            系统菜单表
+3. system_role            系统角色表
+4. system_page_action     按钮权限表
+
+
+
+![image](https://images4.c-ctrip.com/target/zb0b15000000yqrkk687D.png)
+
+
+### 导入db成功后在项目配置文件里面修改成正确的db链接字符串
+
+![image](https://images4.c-ctrip.com/target/zb0o15000000yn8889DA6.png)
+
+
+### F5启动应用 会进入登录页面
+
+![image](https://images4.c-ctrip.com/target/zb0915000000yqsrzD697.png)
+
+如果是按照上面初始化db脚本的话
+初始化的登录名 zdyu 密码 123456
+
+
+登录成功如下图：
+
+### 首页
+![image](https://images4.c-ctrip.com/target/zb0v15000000yzg3xAD3E.png)
+
+
+### 菜单管理
+![image](https://images4.c-ctrip.com/target/zb0g15000000yp3b5F941.png)
+
+### 权限管理
+![image](https://images4.c-ctrip.com/target/zb0e15000000yr5fyC8C3.png)
+
+### 角色管理
+![image](https://images4.c-ctrip.com/target/zb0815000000yolhh6D74.png)
+![image](https://images4.c-ctrip.com/target/zb0o15000000yn8sd0269.png)
+
+### 系统用户
+![image](https://images4.c-ctrip.com/target/zb0715000000z534t2E42.png)
+
+### 代码自动生成
+![image](https://images4.c-ctrip.com/target/zb0k15000000ysl2f602B.png)
+
+
+### 权限如何设计的
+-  一个菜单(system_menu)对应一个view页面【1：1】
+-  一个用户(system_user)只能有一个角色(system_role)【1:1】
+-  一个角色(system_role)可以配置多个菜单权限(view页面)
+    和view页面里面的功能模块(ru按钮) 【1：N】
+-  每个菜单(view页面)下的功能模块(如按钮)配置实际该功能用到的接口【1：N】
+
+### 约定>配置 权限设计其实很简单
+权限主要拦截器代码实现在：
+![image](https://images4.c-ctrip.com/target/zb0c15000000yr2jg2D37.png)
+
+用户登录态是记录在cookie的 默认的keyName:cbeid
+可以在这个里面更改
+![image](https://images4.c-ctrip.com/target/zb0t15000000yoh6fE3C8.png) 
+
+
+#### 约定一
+具有权限拦截的Controller类上面统一打上[API("controller作用描述")] 方法上面打上  [API("方法作用描述")]
+
+#### 约定二
+
+在页面里面写需要权限控制的按钮的时候
+
+```
+<button type="button" action-id="role-add" action-name="新增角色" style="display: none" >新增角色</button>
+
+```
+
+标签名称 | 含义
+---|---
+action-id  | 表示这个权限按钮的id 在当前view唯一
+action-name  | 权限按钮的作用描述
+display  | 默认使用 none 隐藏
+
+
+只要遵守如上2个约定开发好页面和controller后，按照如下步骤进行配置权限
+
+1. 在菜单管理加入新增的页面
+2. 在权限管理配置功能按钮对应用到的接口
+3. 在角色管理修改对应的角色
+
+
+### 其他说明
+
+后台用到了的Orm框架：
+
+https://github.com/yuzd/AntData.ORM
+
+配合ORM框架的vs一键生成dbmodel 插件：
+
+https://marketplace.visualstudio.com/items?itemName=nainaigu.AntDataVS
