zayac/zayac-admin
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
172 Commits 1 Branch 0 Tags 22 MiB
8743ed14d9
Commit Graph

78 Commits

Author SHA1 Message Date
Charles7c
efbcb9b39d style: 优化业务实现注释 2023-04-13 22:29:53 +08:00
Charles7c
18c54a74fc fix: 完善事务注解 2023-04-03 21:31:29 +08:00
Charles7c
e6f7429fa3 style: 使用常量优化部分魔法值 2023-03-31 23:31:30 +08:00
Charles7c
331491dd5d fix: 完善创建用户参数校验 2023-03-31 21:13:30 +08:00
Charles7c
8b955a0b1b 修复：补充校验 2023-03-29 23:47:48 +08:00
Charles7c
8a843ad94c 修复：修复在线用户缺失昵称信息的问题 2023-03-26 20:50:17 +08:00
Charles7c
d88d712d18 完善：完善用户相关业务验证 2023-03-26 14:18:36 +08:00
Charles7c
d5a398b7ad 优化：优化部分变量命名 2023-03-26 13:57:14 +08:00
Charles7c
28334f6c9a 优化：优化删除部门的代码逻辑 
1.如果存在下级部门，不允许删除
 2023-03-26 13:51:43 +08:00
Charles7c
59d9fd33e4 优化：优化修改部门的代码逻辑 
1.启用部门，其所有上级部门需要处于启用状态；禁用部门，其所有下级部门需要处于禁用状态
2.新增部门时，默认为禁用状态
 2023-03-26 11:46:26 +08:00
Charles7c
bc54acd60b 重构：重构获取登录用户信息的代码逻辑 
1.用户基本信息调整为实时获取
2.登录用户不再保存基本信息，降低维护成本
3.移除冗余的维护登录用户基本信息的代码
 2023-03-26 10:58:23 +08:00
Charles7c
267ad9be13 优化：优化修改角色的代码逻辑 
1.变更角色编码、功能权限或数据权限后，关联在线用户会自动下线
2.优化角色和菜单关联、角色和部门关联、用户和角色关联的业务代码（增加返回结果）
3.重构在线用户功能，抽取在线用户业务实现
 2023-03-26 00:14:05 +08:00
Charles7c
c5b748fe52 完善：发版前配置梳理 2023-03-24 00:40:49 +08:00
Charles7c
f57d15793a 优化：优化部分工具方法的使用 2023-03-23 23:40:45 +08:00
Charles7c
2e215ab320 优化：调整部门、菜单、角色、用户删除的代码逻辑顺序，先删除关联再删除主体 2023-03-23 22:20:51 +08:00
Charles7c
a09711c04e 完善：完善菜单相关代码逻辑，优化部分细节 2023-03-20 21:56:20 +08:00
Charles7c
6d3ba478e9 优化：优化校验工具类的使用及部分模板文本写法 
1.优化校验工具类，支持传入 {} 模板文本
2.校验工具类增加 throwIf 重载方法，适合于 boolean 类型参数的情况
3.优化一些模板文本的写法
4.优化一些其他细节
 2023-03-20 20:44:52 +08:00
Charles7c
139cb337d7 优化：用户新增类型字段，用于标识用户是系统内置或自定义 
1.系统内置用户不允许禁用、删除、变更所属角色
2.删除用户时，自动删除用户和角色关联
 2023-03-19 23:39:32 +08:00
Charles7c
ff24f3ba78 优化：角色新增类型字段，用于标识角色是系统内置或自定义 
1.系统内置角色不允许禁用、删除、修改角色编码和角色数据权限
2.删除角色时，自动删除角色和菜单关联、自动删除角色和部门关联
 2023-03-19 22:58:51 +08:00
Charles7c
b345e4450d 优化：部门新增类型字段，用于标识部门是系统内置或自定义 
1.系统内置部门不允许禁用、删除、修改上级部门
2.抽取 getAncestors 方法，用于复用获取祖级列表
3.删除部门时，自动删除角色和部门关联
 2023-03-19 22:10:37 +08:00
Charles7c
25e11ad9bc 优化：优化后端公共 CRUD 组件-修改接口，将 id 从请求体提取到路径变量，更符合 RESTful 风格 2023-03-11 00:26:18 +08:00
Charles7c
2d71af9efb 优化：优化 SQL 语句风格 
1.MySQL数据库>SQL语句>第10条：
【推荐】SQL 语句中表的别名前加 as，并且以 t1、t2、t3、...的顺序依次命名。
说明：
  1）别名可以是表的简称，或者是依照表在 SQL 语句中出现的顺序，以 t1、t2、t3 的方式命名。
  2）别名前加 as 使别名更容易识别。
正例：select t1.name from first_table as t1 , second_table as t2 where t1.id = t2.id
个人理解：使用 t1、t2、t3... 的表别名命名方式，在很多类似业务查询的场景会更方便复用；使用 AS 而不是 as 更容易阅读。
 2023-03-10 23:17:25 +08:00
Charles7c
d8ceda4654 新增：新增获取路由信息 API（默认前端动态路由处于关闭状态，可通过[页面配置]>[菜单来源于后台]开启） 
1.在页面导航栏中通过[页面配置]>[菜单来源于后台]临时启用，刷新后配置失效
2.在前端项目 src/config/setting.json 中，可通过 menuFromServer 配置永久启用
 2023-03-09 00:06:02 +08:00
Charles7c
fb0effed9a 新增：新增角色数据权限功能（基于 MyBatis Plus DataPermissionInterceptor 插件实现） 
1.基于 MyBatis Plus DataPermissionInterceptor 插件实现的数据权限功能
2.通过在指定 Mapper 接口层方法添加 @DataPermission 注解实现数据权限
 2023-03-07 23:55:24 +08:00
Charles7c
5f4a9abec6 修复：修复根据用户 ID 查询权限码报 ParseException 的问题（参考 GitHub：baomidou/mybatis-plus#5159） 
Caused by: net.sf.jsqlparser.parser.ParseException: Encountered unexpected token: "ur" <K_ISOLATION>
 2023-03-07 23:48:25 +08:00
Charles7c
405c821e2a 重构：🔥 基于阿里巴巴 Java 开发手册(黄山版)重构各表基本结构（简化列名） 
1.MySQL数据库>建表规约>第9条：
【强制】表必备三字段：id，create_time，update_time。
说明：其中 id 必为主键，类型为 bigint unsigned、单表时自增、步长为 1。create_time，update_time 的类型均为datetime 类型，如果要记录时区信息，那么类型设置为 timestamp。
个人理解：简化列名的目的是为了后续能抽取更多公共能力
2.MySQL数据库>SQL语句>第10条：
【推荐】SQL 语句中表的别名前加 as，并且以 t1、t2、t3、...的顺序依次命名。
说明：
  1）别名可以是表的简称，或者是依照表在 SQL 语句中出现的顺序，以 t1、t2、t3 的方式命名。
  2）别名前加 as 使别名更容易识别。
正例：select t1.name from first_table as t1 , second_table as t2 where t1.id = t2.id;
 2023-03-06 00:09:11 +08:00
Charles7c
95784e5c7d 修复：不再查询父 ID 为 0 的记录的父名称 2023-03-05 13:10:28 +08:00
Charles7c
47fa1422bb 优化：基于阿里巴巴 Java 开发手册(黄山版)优化部分变量和方法命名 
1.编程规约>命名风格>第14条：
【推荐】在常量与变量命名时，表示类型的名词放在词尾，以提升辨识度。
正例：startTime / workQueue / nameList / TERMINATED_THREAD_COUNT
反例：startedAt / QueueOfWork / listName / COUNT_TERMINATED_THREAD
2.编程规约>命名风格>第19条：
【参考】各层命名规约：
  A）Service / DAO 层方法命名规约：
  1）获取单个对象的方法用 get 做前缀。
  2）获取多个对象的方法用 list 做前缀，复数结尾，如：listObjects
  3）获取统计值的方法用 count 做前缀。
  4）插入的方法用 save / insert 做前缀。
  5）删除的方法用 remove / delete 做前缀。
  6）修改的方法用 update 做前缀。
个人理解及应用 🔥：
  1)在变量命名方面：
    a)方法体内局部变量，命名时表示类型的名词放在词尾，以提升辨识度；
      正例：nameList、nameArr。
    b)方法声明上参数（局部变量），命名时尽量采用复数形式，以和方法名保持一致；
      正例：List<String> listNameByIds(List<Long> ids);
    c)成员变量，命名时尽量采用复数形式。
  2)在方法命名方面：
    a)CRUD 类方法可以简化命名；
      正例：UserService：page、list、add、update、delete...;
      说明：UserService 是围绕 User 为核心的业务接口，简化命名的方法也很容易理解操作的是什么。
    b)其他方法，查询信息名词采用单数（与其纠结单数、复数，那就用单数，简单粗暴一点），以上述第2条要求为命名前缀。
      正例：RoleService：listNameByIds（根据 ID 查询名称列表）
           RoleService：listRoleCodeByUserId（根据用户 ID 查询角色编码列表）
           UserRoleService：listRoleIdByUserId（根据用户 ID 查询角色 ID 列表）
           UserService：getByUsername（根据用户名查询用户）
 2023-03-04 23:03:33 +08:00
Charles7c
25f6e3402b 优化：优化使用 MyBatis Plus ChainWrapper 的方式 2023-03-04 17:38:10 +08:00
Charles7c
4779d77265 优化：基于阿里巴巴 Java 开发手册(黄山版)优化方法排序及访问权限修饰符 
1.编程规约>OOP规约>第20条：
【推荐】当一个类有多个构造方法，或者多个同名方法，这些方法应该按顺序放置在一起，便于阅读，
此条规则优先于下一条。
2.编程规约>OOP规约>第21条：
【推荐】类内方法定义的顺序依次是：公有方法或保护方法 > 私有方法 > getter / setter 方法。
说明：公有方法是类的调用者和维护者最关心的方法，首屏展示最好；保护方法虽然只是子类关心，也可能是“模板设
计模式”下的核心方法；而私有方法外部一般不需要特别关心，是一个黑盒实现；因为承载的信息价值较低，所有
Service 和 DAO 的 getter / setter 方法放在类体最后。
3.编程规约>OOP规约>第26条：
【推荐】类成员与方法访问控制从严：
  1）如果不允许外部直接通过 new 来创建对象，那么构造方法必须是 private。
  2）工具类不允许有 public 或 default 构造方法。
  3）类非 static 成员变量并且与子类共享，必须是 protected。
  4）类非 static 成员变量并且仅在本类使用，必须是 private。
  5）类 static 成员变量如果仅在本类使用，必须是 private。
  6）若是 static 成员变量，考虑是否为 final。
  7）类成员方法只供类内部调用，必须是 private。
  8）类成员方法只对继承类公开，那么限制为 protected。
  说明：任何类、方法、参数、变量，严控访问范围。过于宽泛的访问范围，不利于模块解耦。思考：如果是一个
  private 的方法，想删除就删除，可是一个 public 的 service 成员方法或成员变量，删除一下，不得手心冒点汗吗？
  变量像自己的小孩，尽量在自己的视线内，变量作用域太大，无限制的到处跑，那么你会担心的。
 2023-03-04 10:41:43 +08:00
Charles7c
6da85463c9 优化：基于阿里巴巴 Java 开发手册(黄山版)优化部分空集合处理 
1.编程规约>集合处理>第7条：（个人理解：emptyList() 固然可以减少资源浪费，但未来由于不确定的需求变更，一旦增删元素必然会引发异常）
【强制】Collections 类返回的对象，如：emptyList() / singletonList() 等都是 immutable list，不可
对其进行添加或者删除元素的操作。
反例：如果查询无结果，返回 Collections.emptyList() 空集合对象，调用方一旦在返回的集合中进行了添加元素的操
作，就会触发 UnsupportedOperationException 异常。
2.编程规约>集合处理>第17条：
【推荐】集合初始化时，指定集合初始值大小。
说明：HashMap 使用构造方法 HashMap(int initialCapacity) 进行初始化时，如果暂时无法确定集合大小，那么指
定默认值（16）即可。
正例：initialCapacity = (需要存储的元素个数 / 负载因子) + 1。注意负载因子（即 loaderfactor）默认为 0.75，如果
暂时无法确定初始值大小，请设置为 16（即默认值）。
反例：HashMap 需要放置 1024 个元素，由于没有设置容量初始大小，随着元素增加而被迫不断扩容，resize() 方法
总共会调用 8 次，反复重建哈希表和数据迁移。当放置的集合元素个数达千万级时会影响程序性能。
 2023-03-03 23:41:01 +08:00
Charles7c
1257a4bc35 优化：基于阿里巴巴 Java 开发手册(黄山版)优化常量及包命名 
1.编程规约>常量定义>第4条：
【推荐】不要使用一个常量类维护所有常量，要按常量功能进行归类，分开维护。
说明：大而全的常量类，杂乱无章，使用查找功能才能定位到要修改的常量，不利于理解，也不利于维护。
正例：缓存相关常量放在类 CacheConsts 下；系统配置相关常量放在类 SystemConfigConsts 下。
2.编程规约>常量定义>第5条：
【推荐】常量的复用层次有五层：跨应用共享常量、应用内共享常量、子工程内共享常量、包内共享常
量、类内共享常量。
  1）跨应用共享常量：放置在二方库中，通常是 client.jar 中的 constant 目录下。
  2）应用内共享常量：放置在一方库中，通常是子模块中的 constant 目录下。
  反例：易懂常量也要统一定义成应用内共享常量，两个程序员在两个类中分别定义了表示“是”的常量：
  类 A 中：public static final String YES = "yes";
  类 B 中：public static final String YES = "y";
  A.YES.equals(B.YES)，预期是 true，但实际返回为 false，导致线上问题。
  3）子工程内部共享常量：即在当前子工程的 constant 目录下。
  4）包内共享常量：即在当前包下单独的 constant 目录下。
  5）类内共享常量：直接在类内部 private static final 定义。
 2023-03-03 22:34:19 +08:00
Charles7c
94be1f9553 新增：新增功能权限适配及校验 
1.后端 API 注解鉴权使用方式：@SaCheckPermission("system:user:add")
2.前端全局指令函数使用方式：v-permission="['system:user:add']"
3.前端权限判断函数使用方式：checkPermission(['system:user:add'])
 2023-03-02 23:39:22 +08:00
Charles7c
ac6d2918d9 删除：删除系统管理/岗位管理（过于偏向行政业务向） 2023-02-27 22:53:36 +08:00
Charles7c
d4fd76dcc1 重构：🔥 重构查询树列表相关 API，并抽取到后端 CRUD 公共组件中 
1.基于 Hutool TreeUtil 重构查询树列表相关 API
2.抽取查询树列表 API 到后端 CRUD 公共组件中，大大简化部门管理和菜单管理部分代码
 2023-02-27 22:03:27 +08:00
Charles7c
6723903c62 优化：优化部分空集合返回 2023-02-26 23:39:41 +08:00
Charles7c
72e5522952 优化：优化新增关键词 create => add 2023-02-26 22:26:17 +08:00
Charles7c
8200ea822f 新增：新增系统管理/岗位管理（列表、查看详情、新增、修改、删除、导出） 2023-02-26 00:19:56 +08:00
Charles7c
4071bb7f67 优化：优化部分 equals() 用法为 Objects.equals() 2023-02-25 14:26:15 +08:00
Charles7c
5519c209b1 新增：新增系统管理/用户管理重置密码、分配角色功能 2023-02-25 14:21:46 +08:00
Charles7c
91165e63e5 重构：重构查询角色树 API 为查询角色字典列表 
1.新增 LabelValueVO 通用字典数据结构
 2023-02-24 22:24:25 +08:00
Charles7c
efa8f4fcf5 新增：新增系统管理/用户管理（列表、查看详情、新增、修改、删除、导出） 2023-02-22 23:58:28 +08:00
Charles7c
297fbd3675 重构：重构系统管理/角色管理功能 
1. 使用抽屉代替对话框
2. 优化数据权限权限范围存储，新增角色和部门关联表
3. 新增角色和菜单关联表
4. 部分细节优化
 2023-02-20 00:14:14 +08:00
Charles7c
510f86031f 新增：新增系统管理/菜单管理（列表、创建、修改、删除、导出） 2023-02-16 23:01:26 +08:00
Charles7c
1319cb3264 优化：使用 MyBatis Plus ChainWrapper 优化部分 QueryWrapper 的写法 2023-02-16 21:00:12 +08:00
Charles7c
56449263d3 优化：优化校验注解提示信息的写法 2023-02-16 20:54:17 +08:00
Charles7c
fb740f2938 修复：删除部门及角色时，新增检测是否存在关联用户 2023-02-14 21:27:26 +08:00
Charles7c
03b57fb021 优化：🔥 深度优化后端 CRUD 公共组件，并抽取前端下载功能到 CRUD 公共组件 
1. 后端抽取导出功能到 CRUD 公共组件
2. 查询列表及导出接口支持排序参数
3. 深度优化 BaseServiceImpl 中的 CRUD 公共实现
4. 前端抽取公共下载组件
5. 优化部分细节并修复部分错误
 2023-02-13 21:15:06 +08:00
Charles7c
ebc7c2b3b0 优化：基于 ESLint 和阿里编码规约插件对部分代码规范进行优化 2023-02-10 20:45:15 +08:00
Charles7c
5251a484f2 新增：新增系统管理/角色管理（分页、查看详情、创建、修改、删除） 2023-02-09 23:15:16 +08:00