diff --git a/README.md b/README.md index 6167e0ac..3b1f981e 100644 --- a/README.md +++ b/README.md @@ -1,26 +1,23 @@ -### SmartAdmin 2.0 (即 vue3 的 js版本和ts版本 )已经更新了最新代码，当前正在完善文档，欢迎持续关注 ！ -#### 简介 -SmartAdmin由河南·洛阳 [1024创新实验室](https://www.1024lab.net/)团队研发的一套互联网企业级的通用型中后台解决方案！使用最前沿的前后台技术栈SpringBoot和Vue，前后端分离，**我们开源一套漂亮的代码和一套整洁的代码规范**，让大家在这浮躁的代码世界里感受到一股把代码写好的清流！同时又让开发者节省大量的时间，减少加班，快乐工作，热爱生活。SmartAdmin 让你从认识到忘不了，绝对是你最想要的！ +### SmartAdmin 2.X -#### 开源地址 (*欢迎 Star！*) +SmartAdmin2.X 由河南·洛阳 [1024 创新实验室](https://www.1024lab.net/)使用SpringBoot2.x 和 Vue3.2 Setup标签、 Composition Api (同时支持JavaScript和TypeScript双版本) ，开发出的一套简洁、易用的中后台解决方案！ + +**我们开源一套漂亮的代码和一套整洁的代码规范**，让大家在这浮躁的代码世界里感受到一股把代码写好的清流！同时又让开发者节省大量的时间，减少加班，快乐工作，保持谦逊，保持学习，热爱代码，更热爱生活！ + +### 地址 在线预览： [http://preview.smartadmin.1024lab.net](http://preview.smartadmin.1024lab.net) 部署文档：[http://smartadmin.1024lab.net](http://smartadmin.1024lab.net) vue2版本：请查看 feature/1.x 分支 -#### 疑惑 -有人问：又是个“轮子”？ 轮子靠谱吗？为什么要选择你这个轮子？ -**1024Lab**回答： -它不是“轮子”，目的不是为了重复造轮子！ 我们开源的是一套 “漂亮的代码” 和 “代码规范”。 - +### 理念与思想 -#### 理念与思想 -- 我们分享的不是代码，不是徒劳无功的堆砌功能，而是你必须的基础功能，比如Vue前端权限、心跳、动态Reload、Keepalived标签页等等，可能还有一些正是你当前项目中缺失的功能。 -- 我们分享的不仅有代码，还有一套经过几十人验证过的前、后端代码。细节决定成败，好的规范能让我们敲下的每行代码更铿锵有力！ -- 我们推崇高质量的代码，身为开发，代码即利剑，键盘上一套行云流水，宛如侠客，事了拂衣去，深藏身与名。 -- 我们推崇团队的高度配合默契、互相帮助，从不加班，而不是一看到别人的代码就头皮发麻，留其996.ICU -- 我们热爱编程，热爱代码，保持谦逊，不断学习，快乐工作，热爱生活。 -- **请相信并认真阅读下面的每一个点，让你感受不一样的编码体验** +- 我们分享的不是徒劳无功的各种功能，而是必须有的功能，如：数据变动记录、系统说明文档、版本更新记录、意见反馈、日志、心跳、单号生成器等等。 +- 我们分享的还有经过上百家公司验证过的前端、后端、vue3等代码规范，好的规范能让我们敲下的每行代码更铿锵有力！ +- **我们推崇高质量的代码，身为开发，代码即利剑，键盘上一套行云流水，宛如侠客，事了拂衣去，深藏身与名。** +- **我们推崇团队的高度配合默契、互相帮助，从不加班，而不是一看到别人的代码就头皮发麻，留其 [996.ICU](https://baike.baidu.com/item/996.ICU)** +- **我们主动思考，保持谦逊，保持学习，热爱代码，更热爱生活。** +- **我们希望你，希望你能花费3分钟认真阅读下面的每一个点，让你感受从未有过的技术体验！** #### 演示图 @@ -51,86 +48,78 @@ vue2版本：请查看 feature/1.x 分支
+### 技术体系 -#### 技术体系 -- 前端：Vue + Vue-Router + Vuex + ViewUI + vue-enum -- 后端：SpringBoot2 + Mybatis-plus + jwt + druid + mysql -- 前端代码规范smart-front-standard -guide（大力推荐） -- 基于阿里规范之上的后端规范smart-backend-standard-guide（大力推荐） +- 前端：Vue3.2 + Vue-Router + Pinia + Ant Design Vue 3.X + Vite +- 后端：Java8 + SpringBoot2.X + Mybatis-plus + jwt + druid + mysql -#### 前端特点 -- 高质量的代码、代码结构、和代码注释 -- 漂亮的UI，菜单栏、标签页，体验、交互更好用的员工、部门、角色、菜单管理等等 -- 优化基于Keepalive的标签页，做到标签页该缓存的时候缓存，比如左右切换等，不该缓存的时候不缓存，比如新建，表单提交结束等 -- 前端常量维护: vue-enum，拒绝出现魔法数字，代码不可维护的现象 -- 全新的基于前端的权限设计（忘掉传统的权限设计吧，已经不适合这个前端时代） -- 基于websocket的在线人数 -- 支持一级、二级、三级菜单，四级菜单以及搜索功能 -- 其他功能：邮件、富文本、消息、系统配置等等 -- 写不完了，太多好的细节需要你的发现...... +### 功能特点 -#### 后端特点 -- 高质量的Java代码、分包结构、和代码注释 +- OA办公：公司信息（发票、银行、员工等）、通知公告（阅读记录、次数等） +- 文档：系统手册、意见反馈、更新记录 等 +- 监控：心跳监控、数据库监控 +- 日志：登录日志、操作日志（IP、浏览器、操作系统等设备信息） +- 系统：员工、部门、角色、权限、菜单 等 +- 工具：文件管理、系统参数、数据字典、单号生成 等 +- 代码生成： 基于每个表的配置、在线预览代码、下载 等 + +### 前端特点 + +- vue3.2 Composition 模式中如何正确的写好并组织好代码 +- 提供 js 和 ts 双版本，清晰的代码结构 +- 漂亮的 UI，菜单栏、标签页，体验、交互更好用的员工、部门、角色、菜单管理等等 +- 多种布局layout模式 +- 前端常量维护: vue-enum，拒绝出现魔法数字，常量枚举不可维护的现象 +- main.js 中正确的加载方式 +- 漂亮的首页、很好的帮助文档功能、等等，太多好的细节需要你的发现...... + +### 后端特点 + +- 高质量的 Java 代码、分包结构、和代码注释 - 业内独创的请求返回码维护，非常值得一看 -- 基于一个注解和controller的权限设计放弃更复杂的shiro，以及一套数据权限支持 - 四层架构（controller, service, manager, dao） -- 代码阅读性强、扩展性极高的员工、部门、角色、菜单管理 -- 基于LRU策略的内存级权限缓存 -- 配合前端vue-enum的swagger文档注解 -- 心跳服务，让你发现有哪些机器再跑，哪些人在偷偷的跑你的Job -- 自定义的quartz job添加和修改，方便测试人员测试 +- 配合前端 vue-enum 的 swagger 文档注解 +- 心跳服务，让你发现有哪些机器再跑，哪些人在偷偷的跑你的 Job - smart-reload，为系统预留钩子，动态加载，在不重启程序前提下执行一些代码，你懂的 - 以上只是一些举例，更多灿若繁星的惊喜和细节，等待着你的发现！ -#### 前端代码规范 -- 文件、文件夹、目录结构、组建、变量等等怎么命名 -- html、css、less等如何规范 -- vue项目目录结构如何划分 -- router和store该怎么划分扩展性更好 -- vue组件规范该选择哪些 +### 前端代码规范 + +- vue3 项目目录结构如何划分 +- Composition setup 模式下如何编写代码 +- 文件、文件夹、目录结构、组件、变量等等怎么命名 +- router 和 store ( pinia ) 该怎么划分扩展性更好 +- 网络请求 axios 如何封装 - 以及更多，数不胜数让你觉得实用，同时身心愉悦的规范 -#### 后端代码规范 +### 后端代码规范 + - 四层架构（controller, service, manager, dao） 是什么，为什么要有四层 - 各个层的代码该怎么写才能让团队配合默契，高度一致 -- vo, bo, dto, entity ，各种javabean 怎么区分和使用 -- spring的 @Transactional 你用对了吗 -- 方法参数个数、注释、todo这些也要有规范，你遵守过吗 +- vo, bo, form, entity ，各种 javabean 怎么区分和使用 +- spring 的 @Transactional 你用对了吗 +- 方法参数个数、注释、todo 这些也要有规范，你遵守过吗 +- 数据库列如何命名等等 - 以上举例，只是沧海一粟，更多的细节等待你的发现！ ps：以上规范基础都是以团队出发，让团队开心快乐的写代码，而不是为了代码规范而规范，不喜勿喷！谢谢。 -#### 联系我们 - -[1024创新实验室](https://www.1024lab.net/) -公众号 - - - - -
- -SmartAdmin微信群（**加我微信拉你入群！**） +### 联系我们 - + + + -
- - - - - -#### 捐赠 -开源不易，感谢捐赠 ->*佛祖保佑捐赠这些人写程序永无bug，工资翻倍，迎娶白富美，走上人生巅峰！* - - + + +
加我微信，拉你入群关注“小镇程序员”，了解我们请我们喝杯咖啡
---- -作者简介: -[卓大](https://zhuoda.vip)， 1024创新实验室主任，混迹于各个技术圈，研究过计算机，熟悉点java，略懂点前端。 +### 作者 + +[1024创新实验室-主任：卓大](https://zhuoda.vip)， 1024创新实验室主任，混迹于各个技术圈，研究过计算机，熟悉点 java，略懂点前端。 + diff --git a/截图/xiaozhen-gzh.jpg b/截图/xiaozhen-gzh.jpg new file mode 100644 index 00000000..9c6319e6 Binary files /dev/null and b/截图/xiaozhen-gzh.jpg differ diff --git a/截图/zhuoda-wechat-money-v1.jpg b/截图/zhuoda-wechat-money-v1.jpg new file mode 100644 index 00000000..641ff591 Binary files /dev/null and b/截图/zhuoda-wechat-money-v1.jpg differ diff --git a/截图/zhuoda-wechat.jpg b/截图/zhuoda-wechat.jpg new file mode 100644 index 00000000..1e684f43 Binary files /dev/null and b/截图/zhuoda-wechat.jpg differ