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

41 Commits

Author SHA1 Message Date
Charles7c
76c65463c2 refactor: 移除所有的 @Accessors(chain = true)，并全局配置禁止使用 2023-08-11 23:59:44 +08:00
Charles7c
bb6f47cfd2 feat: 新增系统工具模块（存放系统工具模块相关功能，例如：代码生成、文件管理等） 2023-08-05 00:08:41 +08:00
Charles7c
668124591e Merge branch '1.0.x' into dev 
# Conflicts:
#	continew-admin-common/src/main/java/top/charles7c/cnadmin/common/base/BaseController.java
 2023-07-19 23:17:39 +08:00
Charles7c
76f04dd38f fix: 优化分页总记录数数据类型 2023-07-05 22:07:59 +08:00
Charles7c
ae8d294705 refactor: 优化 springdoc-openapi 对象型参数处理 
1.使用 default-flat-param-object 全局设置对象型参数展示形式。此设置是在 springdoc-openapi v1.6.11 版本开始添加的新特性（详情请参阅：https://github.com/springdoc/springdoc-openapi/pull/1805），在此之前，只能在所有需要处理的对象型参数类上使用 @ParameterObject，工作量较大。
2.作者在使用上方这个配置时还遇到了一个 Bug，那就是只要在对象型参数前使用了注解，例如：@Validated PageQuery pageQuery，这个配置就不会生效了。此问题已在 GitHub 提交了相应 issue（详情请参阅：https://github.com/springdoc/springdoc-openapi/issues/2181），并且 springdoc-openapi 社区某个小伙伴儿已在当前最新发布的 v2.1.0 和 v1.7.0 中修复。
注意：由于当前使用的 Knife4j 版本其内部引入的 springdoc-openapi 相关依赖非最新版本，所以为了解决配置不生效问题，暂时将部分对象型参数移除了 @Validated 注解（除了 PageQuery，其他类当前也未实际添加校验，所以直接移除了）。当然如果不想移除的话，也可以从依赖上功夫，即移除 Knife4j 内引入的 springdoc-openapi 相关依赖，然后自行添加 springdoc-openapi 相关依赖并指定最新版本即可。
 2023-04-09 01:13:23 +08:00
Charles7c
2d2a7e7c8e fix: 修复分页查询条件默认值未生效的问题 
Spring MVC 对于对象型参数的属性赋值，如果属性值为 null 则不会调用其对应 set 方法，所以在 set
方法中添加默认处理逻辑无效
 2023-04-09 00:40:28 +08:00
Charles7c
bc54acd60b 重构：重构获取登录用户信息的代码逻辑 
1.用户基本信息调整为实时获取
2.登录用户不再保存基本信息，降低维护成本
3.移除冗余的维护登录用户基本信息的代码
 2023-03-26 10:58:23 +08:00
Charles7c
fb0effed9a 新增：新增角色数据权限功能（基于 MyBatis Plus DataPermissionInterceptor 插件实现） 
1.基于 MyBatis Plus DataPermissionInterceptor 插件实现的数据权限功能
2.通过在指定 Mapper 接口层方法添加 @DataPermission 注解实现数据权限
 2023-03-07 23:55:24 +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
4cd4ad1f82 优化：优化分页查询条件 2023-03-05 20:24:40 +08:00
Charles7c
5f1f39d968 完善：完善部分类实现序列化接口 2023-03-04 16:38:44 +08:00
Charles7c
89a327920e 优化：基于阿里巴巴 Java 开发手册(黄山版)优化常量 
1.编程规约>常量定义>第1条：
【强制】不允许任何魔法值（即未经预先定义的常量）直接出现在代码中。
 2023-03-04 14:35:45 +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
dc751fc3ec 优化：基于阿里巴巴 Java 开发手册(黄山版)优化部分方法使用 
1.编程规约>OOP规约>第12条：
【强制】禁止使用构造方法 BigDecimal(double) 的方式把 double 值转化为 BigDecimal 对象。
说明：BigDecimal(double) 存在精度损失风险，在精确计算或值比较的场景中可能会导致业务逻辑异常。
如：BigDecimal g = new BigDecimal(0.1F)；实际的存储值为：0.100000001490116119384765625
正例：优先推荐入参为 String 的构造方法，或使用 BigDecimal 的 valueOf 方法，此方法内部其实执行了 Double 的
toString，而 Double 的 toString 按 double 的实际能表达的精度对尾数进行了截断。
BigDecimal recommend1 = new BigDecimal("0.1");
BigDecimal recommend2 = BigDecimal.valueOf(0.1);
2.编程规约>OOP规约>第19条：
【推荐】使用索引访问用 String 的 split 方法得到的数组时，需做最后一个分隔符后有无内容的检查，
否则会有抛 IndexOutOfBoundsException 的风险。
说明：
  String str = "a,b,c,,";
  String[] ary = str.split(",");
  // 预期大于 3，结果等于 3
  System.out.println(ary.length);
 2023-03-03 23:14:15 +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
8200ea822f 新增：新增系统管理/岗位管理（列表、查看详情、新增、修改、删除、导出） 2023-02-26 00:19:56 +08:00
Charles7c
91165e63e5 重构：重构查询角色树 API 为查询角色字典列表 
1.新增 LabelValueVO 通用字典数据结构
 2023-02-24 22:24:25 +08:00
Charles7c
56449263d3 优化：优化校验注解提示信息的写法 2023-02-16 20:54:17 +08:00
Charles7c
03b57fb021 优化：🔥 深度优化后端 CRUD 公共组件，并抽取前端下载功能到 CRUD 公共组件 
1. 后端抽取导出功能到 CRUD 公共组件
2. 查询列表及导出接口支持排序参数
3. 深度优化 BaseServiceImpl 中的 CRUD 公共实现
4. 前端抽取公共下载组件
5. 优化部分细节并修复部分错误
 2023-02-13 21:15:06 +08:00
Charles7c
8085edbfe6 优化：优化响应时间戳数据值 2023-02-08 22:11:05 +08:00
Charles7c
c44503b7ea 新增：部门管理对接用户信息（新增所属部门），并完善查看部门详情（增加上级部门显示） 2023-02-07 22:04:22 +08:00
Charles7c
c5d4e8ae21 重构：重构部门管理前端代码；新增修改部门、批量删除部门、查看部门详情功能（后端主要基于 CRUD 通用组件提供 API） 2023-02-01 23:25:36 +08:00
Charles7c
3075038067 优化：优化模型类命名（为数据模型类添加 DO 后缀），并优化所有模型相关变量命名 2023-01-30 21:00:30 +08:00
Charles7c
d7851bc811 重构：初步封装后端 CRUD 公共组件（BaseController、BaseService、BaseServiceImpl） 2023-01-29 23:40:29 +08:00
Charles7c
dab3e597c2 优化：优化部分校验类型（业务验证迁移到 Service 层，使用 CheckUtils 来验证） 2023-01-25 23:07:25 +08:00
Charles7c
693e825144 新增：新增系统管理/部门管理/修改状态及删除功能（后续几天开始对现有代码进行优化，尤其要开始初步封装前后端 CRUD 组件，并针对现在使用的部分规范发起长期投票） 2023-01-25 12:59:30 +08:00
Charles7c
bdf8eeb1b4 新增：新增系统管理/部门管理/查询列表功能，并将所有描述字段名从 notes 调整为 description，将部分前端方法名前缀从 query 调整为 get，以及去除部分冗余代码 2023-01-23 19:00:47 +08:00
Charles7c
3116fd3eae 新增：新增系统监控/在线用户功能，并优化部分注释规范 2023-01-21 14:15:00 +08:00
Charles7c
c57383abad 新增：新增系统监控/登录日志功能，优化日志表结构，并新增记录错误信息（非未知异常不记录异常详情，只记录错误信息） 2023-01-17 23:16:37 +08:00
Charles7c
aa726fc6b6 新增：新增系统监控/操作日志功能，优化日志表结构 2023-01-16 23:00:54 +08:00
Charles7c
f4ea2d44d6 新增：个人中心新增查询操作日志功能，优化日志表结构，并支持关闭记录内网 IP 操作 2023-01-16 00:18:53 +08:00
Charles7c
8b82557883 新增：新增修改邮箱功能，并优化部分以往代码（引入 spring-boot-starter-mail 用于发送邮件验证码） 2023-01-14 01:05:39 +08:00
Charles7c
21f5aceccf 优化：使用枚举存储性别、状态等信息（采用 MyBatis Plus#通用枚举扩展），常量类则专注于存储全局变量，例如：缓存键、默认值等 2023-01-02 00:19:56 +08:00
Charles7c
1d21019813 修复：解决 Jackson2ObjectMapperBuilderCustomizer 配置不生效的问题，同时优化所有 Date 类型为对应 Java 8 日期、时间类型 2022-12-29 21:48:50 +08:00
Charles7c
727850933f 新增：新增系统监控模块（存放系统监控模块相关功能，例如：日志管理、服务监控等），新增操作日志引擎，记录 HTTP 请求信息 2022-12-25 13:16:15 +08:00
Charles7c
78e84e8941 完善：完善用户登录 API，优化部分包结构（引入 MyBatis Plus、多数据源、P6Spy、Liquibase 等依赖，详情可见 README 介绍） 2022-12-25 12:35:35 +08:00
Charles7c
00e2b44d0e 新增：新增用户登录和退出 API（引入 Sa-Token 依赖，详情可见 README 介绍） 2022-12-22 19:39:27 +08:00
Charles7c
79891e8b5a 新增：新增接口文档配置（基于 Spring Doc OpenAPI，使用 Knife4j 作为增强解决方案） 2022-12-11 22:32:18 +08:00
Charles7c
1e5eaab9d3 新增：新增获取图片验证码 API（引入 Redisson、Hutool、Easy Captcha 依赖，详情可见 README 介绍） 2022-12-11 15:06:21 +08:00