1.1、关于SmartAdmin 2.X

11/6/2022

# 前言

SmartAdmin2.X 由河南·洛阳 1024 创新实验室 (opens new window)使用SpringBoot2.x 和 Vue3.2 Setup标签、 Composition Api (同时支持JavaScript和TypeScript双版本) ,开发出的一套简洁、易用的中后台解决方案!

我们开源一套漂亮的代码和一套整洁的代码规范,让大家在这浮躁的代码世界里感受到一股把代码写好的清流!同时又让开发者节省大量的时间,减少加班,快乐工作,保持谦逊,保持学习,热爱代码,更热爱生活!

star fork GitHub stars GitHub forks MIT

# 理念与思想

  • 我们分享的不是徒劳无功的各种功能,而是必须有的功能,如:数据变动记录、系统说明文档、版本更新记录、意见反馈、日志、心跳、单号生成器等等。
  • 我们分享的还有经过上百家公司验证过的前端、后端、vue3等代码规范,好的规范能让我们敲下的每行代码更铿锵有力!
  • 我们推崇高质量的代码,身为开发,代码即利剑,键盘上一套行云流水,宛如侠客,事了拂衣去,深藏身与名。
  • 我们推崇团队的高度配合默契、互相帮助,从不加班,而不是一看到别人的代码就头皮发麻,留其 996.ICU (opens new window)
  • 我们主动思考,保持谦逊,保持学习,热爱代码,更热爱生活。
  • 我们希望你,希望你能花费3分钟认真阅读下面的每一个点,让你感受从未有过的技术体验!

# 演示图

# 技术体系

  • 前端:Vue3.2 + Vue-Router + Pinia + Ant Design Vue 3.X + Vite3
  • 后端:Java8 + SpringBoot2.X + Mybatis-plus + jwt + druid + mysql

# 功能特点

  • 表格:持久化表格自定义列、国际化、水印 等
  • OA办公:公司信息(发票、银行、员工等)、通知公告(阅读记录、次数等)
  • 文档:系统手册、意见反馈、更新记录 等
  • 监控:心跳监控、数据库监控
  • 日志:登录日志、操作日志(IP、浏览器、操作系统等设备信息)
  • 系统:员工、部门、角色、权限、菜单 等
  • 工具:文件管理、系统参数、数据字典、单号生成 等
  • 代码生成: 基于每个表的配置、在线预览代码、下载 等

# 前端特点

  • vue3.2 Composition 模式中如何正确的写好并组织好代码
  • 提供 js 和 ts 双版本,清晰的代码结构
  • 漂亮的 UI,菜单栏、标签页,体验、交互更好用的员工、部门、角色、菜单管理等等
  • 多种布局layout模式
  • 前端常量维护: vue-enum,拒绝出现魔法数字,常量枚举不可维护的现象
  • main.js 中正确的加载方式
  • 漂亮的首页、很好的帮助文档功能、等等,太多好的细节需要你的发现......

# 后端特点

  • 高质量的 Java 代码、分包结构、和代码注释
  • 业内独创的请求返回码维护,非常值得一看
  • 四层架构(controller, service, manager, dao)
  • 配合前端 vue-enum 的 swagger 文档注解
  • 心跳服务,让你发现有哪些机器再跑,哪些人在偷偷的跑你的 Job
  • smart-reload,为系统预留钩子,动态加载,在不重启程序前提下执行一些代码,你懂的
  • 以上只是一些举例,更多灿若繁星的惊喜和细节,等待着你的发现!

# 前端代码规范

  • vue3 项目目录结构如何划分
  • Composition setup 模式下如何编写代码
  • 文件、文件夹、目录结构、组件、变量等等怎么命名
  • router 和 store ( pinia ) 该怎么划分扩展性更好
  • 网络请求 axios 如何封装
  • 以及更多,数不胜数让你觉得实用,同时身心愉悦的规范

# 后端代码规范

  • 四层架构(controller, service, manager, dao) 是什么,为什么要有四层
  • 各个层的代码该怎么写才能让团队配合默契,高度一致
  • vo, bo, form, entity ,各种 javabean 怎么区分和使用
  • spring 的 @Transactional 你用对了吗
  • 方法参数个数、注释、todo 这些也要有规范,你遵守过吗
  • 数据库列如何命名等等
  • 以上举例,只是沧海一粟,更多的细节等待你的发现!

ps:以上规范基础都是以团队出发,让团队开心快乐的写代码,而不是为了代码规范而规范,不喜勿喷!谢谢。

# 联系我们

1024创新实验室-主任:卓大 (opens new window),混迹于各个技术圈,研究过计算机,熟悉点 java,略懂点前端。
1024创新实验室(河南·洛阳) (opens new window) 致力于成为中原领先、国内一流的技术团队,以技术创新为驱动,合作各类项目。

加 主任 “卓大” 微信
拉你入群,一起学习
关注 “小镇程序员”
分享代码与生活、技术与赚钱
请 “1024创新实验室” 喝咖啡
支持我们的开源与分享

告白气球 (钢琴版)
JESSE T