Update YamiSysUser.java

README.md

@@ -1,2 +1,138 @@
-# mall4
+# 编写的原因
 
+写在前面，很多加入我们群里的人，都会问我们源码在哪里，现在仔细回答一下
+
+1. 我们已经声明了，这是一个前后端分离的商城，而且分离的很彻底，java的后台管理系统不是jsp，使用vue写的，所以商城的后台管理在vue这个项目 https://gitee.com/gz-yami/mall4v ,启动完java，不要访问java的端口，启动vue，访问vue的端口页面，就能看到后台管理，就能上商品了！！！
+
+2. 和上面一样的，很多人问，前端的浏览商品的页面在哪里，其实就在这里 https://gitee.com/gz-yami/mall4m
+
+3. 有人会问你是不是将上面两个链接藏起来了，上面两个项目的链接都在readme里面写着，可是很多人都不读。
+
+4. swagger文档怎么访问不了，其实路径是/doc.html
+
+5. 我们开源的刚上线直接申请通过了推荐项目，第一天就有100个星星，一个月就有1k的星星，大家都不是傻的，这代码是能用的，拜托...后来没怎么维护（整个流程都是好的，整个功能都是好的，都不知道维护啥），现在又开始维护了，星星也没了（如果你悄悄拿去做外包项目，觉得这个项目对你有用，就给个星星呗）
+
+
+
+## 先确定我们下载的项目有几个项目
+
+- mall4j：j代表java，java项目，这里面包含了小程序/后台vue连接需要的接口。
+- mall4v：v代表vue项目，是后台管理员界面使用的前端项目，因为前后端分离的
+- mall4m：m代表mini，小程序项目，这里的项目是小程序的项目
+- mall4uni：uni代表uniapp，H5项目，这里的项目是H5的项目
+- jvm：java虚拟机啦~
+
+
+## 1.java开发环境安装
+
+
+### 1.1开发环境
+
+以下版本是最低要求的！！！ 提问问题前请注意开发环境！！
+
+| 工具      | 版本    |
+|---------|-------|
+| jdk     | 17    |
+| mysql   | 5.7+  |
+| redis   | 4.0+  |
+| nodejs  | 14-16 |
+| xxl-job | 2.4.0 |
+
+
+### 1.2 安装jdk + mysql + redis + maven
+
+如果不了解怎么安装jdk的，可以参考 [菜鸟教程的java相关](https://www.runoob.com/java/java-environment-setup.html)
+- 教程展示的是oracle，需要自行搜索openjdk的下载链接，下载jdk17版本
+
+如果不了解怎么安装mysql的，可以参考  [菜鸟教程的mysql相关](https://www.runoob.com/mysql/mysql-install.html) 
+
+如果不了解怎么安装maven的，可以参考  [菜鸟教程的maven相关]( https://www.runoob.com/maven/maven-setup.html ) 
+
+如果对于redis的安装并不了解的，可以参考 [菜鸟教程的redis相关](https://www.runoob.com/redis/redis-install.html)
+
+安装相对简单，网上也有很多教程，这里就不多讲述。安装完按需对redis进行配置，后启动redis服务即可。
+
+### 2.启动
+
+- 推荐使用idea，安装lombok插件后，使用idea导入maven项目
+- 将yami_shop.sql导入到mysql中，修改`application-dev.yml`更改 datasource.url、user、password
+- 通过修改`shop.properties` 修改七牛云、阿里大鱼等信息
+- 修改`api.properties` 修改当前接口所在域名，用于支付回调
+- 启动redis，端口6379
+- 通过`WebApplication`启动项目后台接口，`ApiApplication` 启动项目前端接口
+- xxl-job定时任务，通过github或者gitee下载xxl-job的已经打包好的源码，把`XxlJobConfig.class`这个文件的代码注释打开，配置yml文件中相关xxl-job配置即可使用
+
+
+## 3.vue开发环境安装
+
+这是一套正常的vue启动流程。如果你无法理解，可能要先学习一下vue...
+
+#### 3.1 安装nodejs
+
+[NodeJS](https://nodejs.org)  项目要求最低 18.12.0，推荐 20.9.0
+
+如果不了解怎么安装nodejs的，可以参考   [菜鸟教程的nodejs相关](https://www.runoob.com/nodejs/nodejs-install-setup.html)
+
+
+
+#### 3.2 安装依赖启动项目
+
+项目要求使用 [pnpm](https://www.pnpm.cn/)  包管理工具
+
+使用编辑器打开项目，在根目录执行以下命令安装依赖
+
+```bash
+pnpm i
+```
+
+如果不想使用 pnpm，请删除 `package.json` 文件中  `preinstall`  脚本后再进行安装
+
+```json
+{
+    "scripts" : {
+        "preinstall": "npx only-allow pnpm"  // 使用其他包管理工具（npm、yarn、cnpm等）请删除此命令
+    }
+}
+```
+
+
+H5端和平台端修改文件`.env.production`（生产环境）/ `.env.development`（开发环境）
+里面的`VITE_APP_BASE_API`为api接口请求地址， `VITE_APP_RESOURCES_URL`为静态资源文件url 
+
+```json
+// api接口请求地址
+VITE_APP_BASE_API = 'http://127.0.0.1:8085'
+
+// 静态资源文件url
+VITE_APP_RESOURCES_URL = 'https://img.mall4j.com/'
+
+```
+
+mall4m小程序端修改文件`utils\config.js`，里面的`domain`为api接口请求地址
+
+注意！！如果启动uni项目或者小程序，默认后台api服务端口号为8086，
+如果启动后台项目，默认后台admin服务端口号为8085，请对照仔细填写后再启动，如遇401状态码，仔细检查端口号是否配置正确！
+如果后台启动后，图形验证码显示“接口验证失败数过多，请稍后再试”，请F12打开network确定连接的admin服务端口号是否正确，ip或域名是否正确，
+如果有配置nginx，还要确认下项目访问路径是否正确，可以通过地址+/doc.html来访问接口文档确定是否正确访问到admin服务
+
+
+
+
+运行dev环境：
+
+```bash
+npm run dev
+```
+
+运行dev环境(H5)：
+
+```bash
+npm run dev:h5
+```
+
+## 4.文档
+
+这代码有没有文档呀？
+当然有啦，你已经下载了，在doc这个文件夹上，实在不知道，我就给链接出来咯：
+
+### [https://gitee.com/gz-yami/mall4j/tree/master/doc](https://gitee.com/gz-yami/mall4j/tree/master/doc)

doc/接口设计/2. 订单设计-确认订单.md

@@ -1,4 +1,4 @@
-下单简单的分成几个步骤：
+下单简单的分成几个步骤
 
 1. 用户点击“立即购买”或“购物车-结算”进入到“确认订单”页面
 2. 在“确认订单”页面选择收货地址，优惠券等，重新计算运费、订单价格

front-end/mall4v/.eslintrc-auto-import.json

@@ -1,94 +1,185 @@
 {
   "globals": {
-    "$t": true,
+    // 定义了一系列全局变量或函数，设置为true表示它们是可写的（可以被重新赋值），如果需要设置为只读，则应将值设为false。
-    "Component": true,
+    
-    "ComponentPublicInstance": true,
+    "$t": true, // 国际化文本翻译函数
-    "ComputedRef": true,
+    
-    "Debounce": true,
+    "Component": true, // Vue组件构造器类型
-    "EffectScope": true,
+    
-    "InjectionKey": true,
+    "ComponentPublicInstance": true, // 组件实例类型，用于类型检查和推断
-    "PropType": true,
+    
-    "Ref": true,
+    "ComputedRef": true, // 计算属性类型的引用
-    "VNode": true,
+    
-    "clearLoginInfo": true,
+    "Debounce": true, // 防抖功能函数，防止某个函数在短时间内被多次调用
-    "computed": true,
+    
-    "configDefInfo": true,
+    "EffectScope": true, // 效果作用域，用于管理依赖追踪和副作用
-    "createApp": true,
+    
-    "customRef": true,
+    "InjectionKey": true, // 提供注入时使用的唯一键
-    "defineAsyncComponent": true,
+    
-    "defineComponent": true,
+    "PropType": true, // 定义props验证类型的工具
-    "effectScope": true,
+    
-    "encrypt": true,
+    "Ref": true, // 响应式的引用对象，通常用于包装原始数据类型
-    "flatten": true,
+    
-    "checkFileUrl": true,
+    "VNode": true, // 虚拟节点类型，代表DOM树中的一个节点
-    "formatConfigInfo": true,
+    
-    "getCurrentInstance": true,
+    "clearLoginInfo": true, // 清除登录信息的函数
-    "getCurrentScope": true,
+    
-    "getLevels": true,
+    "computed": true, // 创建计算属性的函数
-    "getUUID": true,
+    
-    "h": true,
+    "configDefInfo": true, // 配置默认信息的对象或函数
-    "http": true,
+    
-    "idList": true,
+    "createApp": true, // 创建Vue应用实例的函数
-    "inject": true,
+    
-    "isAuth": true,
+    "customRef": true, // 创建自定义ref的函数
-    "isEmail": true,
+    
-    "isHtmlNull": true,
+    "defineAsyncComponent": true, // 定义异步组件的函数
-    "isMobile": true,
+    
-    "isPhone": true,
+    "defineComponent": true, // 定义组件的辅助函数
-    "isProxy": true,
+    
-    "isQq": true,
+    "effectScope": true, // 创建效果作用域的函数
-    "isReactive": true,
+    
-    "isReadonly": true,
+    "encrypt": true, // 加密函数
-    "isRef": true,
+    
-    "isURL": true,
+    "flatten": true, // 展平数组的函数
-    "markRaw": true,
+    
-    "nextTick": true,
+    "checkFileUrl": true, // 检查文件URL有效性的函数
-    "onActivated": true,
+    
-    "onBeforeMount": true,
+    "formatConfigInfo": true, // 格式化配置信息的函数
-    "onBeforeRouteLeave": true,
+    
-    "onBeforeRouteUpdate": true,
+    "getCurrentInstance": true, // 获取当前组件实例的函数
-    "onBeforeUnmount": true,
+    
-    "onBeforeUpdate": true,
+    "getCurrentScope": true, // 获取当前作用域的函数
-    "onDeactivated": true,
+    
-    "onErrorCaptured": true,
+    "getLevels": true, // 获取层级信息的函数
-    "onMounted": true,
+    
-    "onRenderTracked": true,
+    "getUUID": true, // 生成UUID的函数
-    "onRenderTriggered": true,
+    
-    "onScopeDispose": true,
+    "h": true, // 创建虚拟DOM节点的函数
-    "onServerPrefetch": true,
+    
-    "onUnmounted": true,
+    "http": true, // HTTP请求库或函数
-    "onUpdated": true,
+    
-    "provide": true,
+    "idList": true, // ID列表，可能是静态数据或函数
-    "reactive": true,
+    
-    "readonly": true,
+    "inject": true, // 注入依赖的函数
-    "ref": true,
+    
-    "resolveComponent": true,
+    "isAuth": true, // 检查权限的函数
-    "shallowReactive": true,
+    
-    "shallowReadonly": true,
+    "isEmail": true, // 验证电子邮件格式的函数
-    "shallowRef": true,
+    
-    "toRaw": true,
+    "isHtmlNull": true, // 检查HTML是否为空的函数
-    "toRef": true,
+    
-    "toRefs": true,
+    "isMobile": true, // 检测设备是否为移动设备的函数
-    "treeDataTranslate": true,
+    
-    "triggerRef": true,
+    "isPhone": true, // 验证电话号码格式的函数
-    "unref": true,
+    
-    "uploadFile": true,
+    "isProxy": true, // 检查对象是否为代理对象的函数
-    "useAttrs": true,
+    
-    "useCommonStore": true,
+    "isQq": true, // 检查QQ号格式的函数
-    "scoreProdStore":true,
+    
-    "useCssModule": true,
+    "isReactive": true, // 检查对象是否为响应式对象的函数
-    "useCssVars": true,
+    
-    "useLink": true,
+    "isReadonly": true, // 检查对象是否为只读的函数
-    "useRoute": true,
+    
-    "useRouter": true,
+    "isRef": true, // 检查对象是否为ref的函数
-    "useSlots": true,
+    
-    "useUserStore": true,
+    "isURL": true, // 验证URL格式的函数
-    "useWebConfigStore": true,
+    
-    "validHtmlLength": true,
+    "markRaw": true, // 标记对象为非响应式的函数
-    "validNoEmptySpace": true,
+    
-    "watch": true,
+    "nextTick": true, // 在下次DOM更新循环结束之后执行延迟回调的函数
-    "watchEffect": true,
+    
-    "watchPostEffect": true,
+    "onActivated": true, // 组件激活时触发的生命周期钩子
-    "watchSyncEffect": true
+    
+    "onBeforeMount": true, // 组件挂载之前触发的生命周期钩子
+    
+    "onBeforeRouteLeave": true, // 导航离开路由前触发的钩子
+    
+    "onBeforeRouteUpdate": true, // 当前路由改变，但是该组件被复用时触发的钩子
+    
+    "onBeforeUnmount": true, // 组件卸载前触发的生命周期钩子
+    
+    "onBeforeUpdate": true, // 组件更新前触发的生命周期钩子
+    
+    "onDeactivated": true, // 组件失活时触发的生命周期钩子
+    
+    "onErrorCaptured": true, // 捕获错误的钩子
+    
+    "onMounted": true, // 组件挂载后触发的生命周期钩子
+    
+    "onRenderTracked": true, // 当依赖追踪触发时触发的钩子
+    
+    "onRenderTriggered": true, // 当渲染触发时触发的钩子
+    
+    "onScopeDispose": true, // 当作用域销毁时触发的钩子
+    
+    "onServerPrefetch": true, // 服务端预获取数据的钩子
+    
+    "onUnmounted": true, // 组件卸载后触发的生命周期钩子
+    
+    "onUpdated": true, // 组件更新后触发的生命周期钩子
+    
+    "provide": true, // 提供依赖的函数
+    
+    "reactive": true, // 创建响应式对象的函数
+    
+    "readonly": true, // 将对象转换为只读的函数
+    
+    "ref": true, // 创建一个响应式的引用对象的函数
+    
+    "resolveComponent": true, // 解析组件的函数
+    
+    "shallowReactive": true, // 创建浅层次的响应式对象的函数
+    
+    "shallowReadonly": true, // 创建浅层次的只读对象的函数
+    
+    "shallowRef": true, // 创建浅层次的响应式引用对象的函数
+    
+    "toRaw": true, // 返回响应式对象的原始版本的函数
+    
+    "toRef": true, // 将响应式对象的属性转换为ref的函数
+    
+    "toRefs": true, // 将响应式对象的所有属性转换为ref的函数
+    
+    "treeDataTranslate": true, // 翻译树形结构数据的函数
+    
+    "triggerRef": true, // 触发ref的依赖追踪的函数
+    
+    "unref": true, // 解包ref的函数
+    
+    "uploadFile": true, // 文件上传的函数
+    
+    "useAttrs": true, // 使用属性的组合式API
+    
+    "useCommonStore": true, // 使用通用状态存储的组合式API
+    
+    "scoreProdStore": true, // 使用产品评分状态存储的组合式API
+    
+    "useCssModule": true, // 使用CSS模块的组合式API
+    
+    "useCssVars": true, // 使用CSS变量的组合式API
+    
+    "useLink": true, // 使用链接的组合式API
+    
+    "useRoute": true, // 使用路由信息的组合式API
+    
+    "useRouter": true, // 使用路由导航的组合式API
+    
+    "useSlots": true, // 使用插槽的组合式API
+    
+    "useUserStore": true, // 使用用户状态存储的组合式API
+    
+    "useWebConfigStore": true, // 使用网站配置状态存储的组合式API
+    
+    "validHtmlLength": true, // 验证HTML长度的函数
+    
+    "validNoEmptySpace": true, // 验证字符串中不包含空格的函数
+    
+    "watch": true, // 监听响应式数据变化的函数
+    
+    "watchEffect": true, // 立即运行并监听其依赖的变化的函数
+    
+    "watchPostEffect": true, // 在依赖项变化后立即运行的函数
+    
+    "watchSyncEffect": true // 同步地运行并在依赖项变化时同步更新的函数
   }
 }

front-end/mall4v/index.html

@@ -1,16 +1,33 @@
 <!DOCTYPE html>
+<!-- 声明文档类型为HTML5 -->
 <html>
   <head>
+    <!-- 设置文档的字符编码为UTF-8，确保正确显示各种语言的文字 -->
     <meta charset="UTF-8" />
+    
+    <!-- 指定页面图标（favicon），通常是一个小图标，在浏览器标签上显示 -->
     <link rel="icon" href="/favicon.ico" />
+    
+    <!-- 指示IE使用最新的渲染引擎和Chrome Frame（如果安装的话）来呈现页面 -->
     <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
+    
+    <!-- 配置移动设备上的视口（viewport），以确保页面在不同尺寸的屏幕上正确缩放 -->
     <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no">
+    
+    <!-- 引入一个空的script标签，ID为qqMap，可能是为了之后通过JavaScript动态加载腾讯地图API或其他相关代码 -->
     <script id="qqMap" charset="utf-8"></script>
+    
+    <!-- 指定页面使用的渲染器为Webkit，这主要用于兼容某些旧版浏览器的行为 -->
     <meta name="renderer" content="webkit">
+    
+    <!-- 页面标题，这里留空，实际项目中应根据具体需求填写 -->
     <title></title>
   </head>
   <body>
+    <!-- 定义一个div元素，ID为app，这是单页应用(SPA)中常见的挂载点，用于Vue.js或React等框架的应用程序入口 -->
     <div id="app"></div>
+    
+    <!-- 引入主JavaScript文件，使用type="module"表明这是一个ES6模块。该文件路径为/src/main.js，表示应用程序逻辑的起点 -->
     <script type="module" src="/src/main.js"></script>
   </body>
 </html>

front-end/mall4v/nginx.conf

@@ -1,22 +1,44 @@
+# 定义一个server块，它代表一个虚拟主机或站点。
 server {
+    # 监听在HTTP标准端口80上，这是未加密的HTTP流量的标准端口。
     listen 80;
+    
+    # 指定该服务器块响应哪些域名的请求。这里是mini-admin.mall4j.com。
     server_name mini-admin.mall4j.com;
 
+    # 开启Gzip压缩功能，以减少传输的数据量，提高页面加载速度。
     gzip on;
+    
+    # 如果存在预压缩的静态资源（如.html.gz），则优先提供这些压缩后的资源。
     gzip_static on;
 
+    # 定义处理所有请求的location块。
     location / {
+        # 尝试按照顺序查找文件：先找精确匹配的文件路径，然后是目录，最后尝试根路径。
         try_files $uri $uri/ /;
+        
+        # 设置Web根目录的位置，即网站文件存放的目录。
         root /usr/share/nginx/html/dist;
+        
+        # 当访问根路径时，默认提供的首页文件名。
         index index.html;
     }
 
+    # 当出现404错误（找不到页面）时，重定向到指定的404错误页面。
     error_page 404 /404.html;
+    
+    # 特别指定当访问路径为/404-light.html时的处理方式。
     location = /404-light.html {
+        # 这里没有额外配置，意味着它将按照默认规则处理此特定路径。
+        # 使用"="表示精确匹配，只有当请求完全符合这个URL时才会触发。
     }
 
+    # 对于500系列的服务器错误，重定向到指定的50x错误页面。
     error_page 500 502 503 504 /50x.html;
+    
+    # 特别指定当访问路径为/50x.html时的处理方式。
     location = /50x.html {
+        # 类似于上面的404-light.html配置，这里也没有额外配置。
+        # "location = /50x.html"确保了只有当请求的是/50x.html时，才会应用这个location块。
     }
 }
-

front-end/mall4v/package.json

@@ -1,63 +1,79 @@
 {
   "name": "mall4v",
+  // 指定项目为私有，这意味着它不会被发布到npm注册表。
   "private": true,
+  // 项目的版本号，遵循语义化版本控制规则。
   "version": "0.0.0",
+  // 指定项目使用ES模块系统。
   "type": "module",
   "scripts": {
+    // 在安装依赖之前运行的命令，这里强制使用pnpm进行安装。
     "preinstall": "npx only-allow pnpm",
+    // 启动开发服务器，使用Vite构建工具。
     "dev": "vite",
+    // 启动带有测试模式的开发服务器。
     "dev:test": "vite --mode testing",
+    // 构建生产环境下的代码。
     "build": "vite build",
+    // 构建带有测试模式的生产代码。
     "build:test": "vite build --mode testing",
+    // 使用eslint检查src目录下的.js和.vue文件。
     "lint": "eslint --ext .js,.vue src",
+    // 自动修复eslint检测到的问题。
     "lint:fix": "eslint --fix --ext .js,.vue src",
+    // 预览构建好的应用。
     "preview": "vite preview",
+    // 对暂存区中的文件执行指定的lint命令。
     "lint:staged": "lint-staged"
   },
+  // 指定Node.js和pnpm的最低版本要求。
   "engines": {
     "node": ">=16",
     "pnpm": ">=6"
   },
   "dependencies": {
-    "@element-plus/icons-vue": "2.1.0",
+    // 开发和运行时依赖项，以下是项目所依赖的库及其版本：
-    "@smallwei/avue": "^3.2.22",
+    "@element-plus/icons-vue": "2.1.0",          // Element Plus图标库
-    "axios": "1.3.4",
+    "@smallwei/avue": "^3.2.22",                // Avue组件库
-    "big.js": "6.2.1",
+    "axios": "1.3.4",                           // HTTP请求库
-    "browser-image-compression": "2.0.2",
+    "big.js": "6.2.1",                          // 精确的浮点数运算库
-    "crypto-js": "4.1.1",
+    "browser-image-compression": "2.0.2",       // 浏览器端图片压缩库
-    "echarts": "5.4.1",
+    "crypto-js": "4.1.1",                       // 加密算法库
-    "element-plus": "2.3.6",
+    "echarts": "5.4.1",                         // 数据可视化图表库
-    "element-resize-detector": "1.2.4",
+    "element-plus": "2.3.6",                    // Element Plus UI库
-    "js-base64": "3.7.5",
+    "element-resize-detector": "1.2.4",         // 监测DOM元素大小变化的库
-    "lodash": "4.17.21",
+    "js-base64": "3.7.5",                       // Base64编码解码库
-    "moment": "2.29.4",
+    "lodash": "4.17.21",                        // JavaScript实用工具库
-    "pinia": "2.0.33",
+    "moment": "2.29.4",                         // 日期处理库（注意：现在官方推荐使用date-fns或dayjs）
-    "qs": "6.11.1",
+    "pinia": "2.0.33",                          // Vue的状态管理库
-    "vue": "3.2.47",
+    "qs": "6.11.1",                             // 查询字符串解析和序列化库
-    "vue-cookies": "1.8.3",
+    "vue": "3.2.47",                            // Vue框架核心库
-    "vue-draggable-next": "2.1.1",
+    "vue-cookies": "1.8.3",                     // Vue插件用于操作浏览器cookies
-    "vue-router": "4.1.6"
+    "vue-draggable-next": "2.1.1",              // Vue组件用于实现拖拽功能
+    "vue-router": "4.1.6"                       // Vue路由管理库
   },
   "devDependencies": {
-    "@babel/eslint-parser": "^7.21.3",
+    // 开发时依赖项，仅在开发环境中使用：
-    "@vitejs/plugin-vue": "^4.1.0",
+    "@babel/eslint-parser": "^7.21.3",          // Babel ESLint解析器
-    "eslint": "^8.38.0",
+    "@vitejs/plugin-vue": "^4.1.0",             // Vite插件支持Vue
-    "eslint-config-standard": "^17.0.0",
+    "eslint": "^8.38.0",                        // ESLint代码检查工具
-    "eslint-plugin-import": "^2.27.5",
+    "eslint-config-standard": "^17.0.0",        // ESLint标准配置
-    "eslint-plugin-n": "^15.7.0",
+    "eslint-plugin-import": "^2.27.5",          // ESLint插件用于检查import/export语句
-    "eslint-plugin-promise": "^6.1.1",
+    "eslint-plugin-n": "^15.7.0",               // ESLint插件用于Node.js代码
-    "eslint-plugin-vue": "^9.10.0",
+    "eslint-plugin-promise": "^6.1.1",          // ESLint插件用于Promise相关规则
-    "eslint-plugin-vue-scoped-css": "^2.4.0",
+    "eslint-plugin-vue": "^9.10.0",             // ESLint插件用于Vue特定规则
-    "lint-staged": "13.2.2",
+    "eslint-plugin-vue-scoped-css": "^2.4.0",   // ESLint插件用于检查Vue单文件组件中的CSS作用域
-    "sass": "^1.59.3",
+    "lint-staged": "13.2.2",                    // 工具，在提交git前对暂存区文件执行任务
-    "unplugin-auto-import": "^0.15.1",
+    "sass": "^1.59.3",                          // Sass预处理器
-    "unplugin-vue-components": "^0.24.1",
+    "unplugin-auto-import": "^0.15.1",          // 插件自动导入API
-    "vite": "^4.3.9",
+    "unplugin-vue-components": "^0.24.1",       // 插件自动注册Vue组件
-    "vite-plugin-compression": "^0.5.1",
+    "vite": "^4.3.9",                           // 快速前端构建工具
-    "vite-plugin-eslint": "^1.8.1",
+    "vite-plugin-compression": "^0.5.1",        // Vite插件提供资源压缩
-    "vite-plugin-svg-icons": "^2.0.1",
+    "vite-plugin-eslint": "^1.8.1",             // Vite插件集成ESLint
-    "vue-eslint-parser": "^9.1.1"
+    "vite-plugin-svg-icons": "^2.0.1",          // Vite插件方便使用SVG图标
+    "vue-eslint-parser": "^9.1.1"               // Vue语法的ESLint解析器
   },
+  // 配置当暂存区中有*.js或*.vue文件时，自动执行的命令。
   "lint-staged": {
     "*.{js,vue}": [
       "eslint --fix"

front-end/mall4v/tsconfig.json

@@ -1,15 +1,29 @@
 {
   "compilerOptions": {
+    // 指定模块代码生成的方式。"commonjs"是Node.js环境下的默认模块系统。
     "module": "commonjs",
+
+    // 设置编译后的JavaScript代码的目标ECMAScript版本。"es5"确保代码可以在大多数浏览器和环境中运行。
     "target": "es5",
+
+    // 启用源映射（source map）生成。这有助于调试，因为它允许你在原始TypeScript代码而不是编译后的JavaScript中设置断点。
     "sourceMap": true,
+
+    // 忽略所有声明文件（.d.ts）中的类型检查。这可以加速编译过程，但可能会隐藏一些潜在的问题。
     "skipLibCheck": true
   },
+
+  // 指定应被编译器排除在外的目录或文件。通常会排除node_modules，因为这些是第三方库，不需要进行TypeScript编译。
   "exclude": [
     "node_modules"
   ],
+
+  // 明确指出应该包含在编译中的特定文件。只有这些文件将被编译，除非它们通过导入被其他文件间接引用。
   "include": [
+    // 包含组件的声明文件，帮助TypeScript理解组件的结构和类型。
     "src/auto-import/components.d.ts",
+
+    // 包含自动导入项的声明文件，帮助TypeScript识别那些应该自动引入的模块或变量。
     "src/auto-import/imports.d.ts"
   ]
 }

yami-shop-admin/src/main/java/com/yami/shop/admin/config/AdminConfig.java

@@ -1,4 +1,3 @@
-以下是为您提供的代码注释：
 
 ```java
 /*

yami-shop-security/yami-shop-security-admin/src/main/java/com/yami/shop/security/admin/adapter/ResourceServerAdapter.java

@@ -7,11 +7,29 @@ import java.util.Arrays;
 import java.util.List;
 
 /**
+ * ResourceServerAdapter 类是一个组件，它继承自 DefaultAuthConfigAdapter。
+ * 该类的主要作用是配置资源服务器的一些认证相关的信息，特别是排除某些路径的认证需求。
+ * 此类使用了 Spring 的 @Component 注解，以便被 Spring 容器自动扫描并作为一个 Bean 进行管理。
+ * 
  * @author 菠萝凤梨
  * @date 2022/3/28 14:57
  */
 @Component
 public class ResourceServerAdapter extends DefaultAuthConfigAdapter {
+
+    /**
+     * EXCLUDE_PATH 是一个静态的 List 集合，存储了一些不需要进行认证的路径列表。
+     * 这些路径包含了常见的资源路径，如：
+     * - /webjars/**：WebJars 相关资源，通常用于管理前端依赖库。
+     * - /swagger/**：Swagger 相关资源，用于 API 文档的展示和调试。
+     * - /v3/api-docs/**：Swagger 的 API 文档的 JSON 数据路径。
+     * - /doc.html：Swagger 的文档页面。
+     * - /swagger-ui.html：Swagger 的 UI 页面。
+     * - /swagger-resources/**：Swagger 的资源路径。
+     * - /captcha/**：可能是验证码相关的资源路径。
+     * - /adminLogin：可能是管理员登录页面的路径。
+     * - /mall4j/img/**：可能是 mall4j 项目中的图片资源路径。
+     */
     public static final List<String> EXCLUDE_PATH = Arrays.asList(
             "/webjars/**",
             "/swagger/**",
@@ -23,6 +41,13 @@ public class ResourceServerAdapter extends DefaultAuthConfigAdapter {
             "/adminLogin",
             "/mall4j/img/**");
 
+    /**
+     * 重写了父类的 excludePathPatterns 方法。
+     * 此方法用于返回那些需要排除认证的路径列表，确保在访问这些路径时，
+     * 不需要进行用户认证操作，以便外部用户可以直接访问这些资源。
+     * 
+     * @return 存储排除认证路径的 List 集合
+     */
     @Override
     public List<String> excludePathPatterns() {
         return EXCLUDE_PATH;

yami-shop-security/yami-shop-security-admin/src/main/java/com/yami/shop/security/admin/model/YamiSysUser.java

@@ -10,11 +10,13 @@
 package com.yami.shop.security.admin.model;
 
 import lombok.Data;
-
 import java.util.Set;
 
+
 /**
- * 用户详细信息
+ * YamiSysUser 类表示用户的详细信息，用于存储用户在系统中的关键信息。
+ * 此类使用了 Lombok 的 @Data 注解，该注解会自动生成 getter、setter、equals、hashCode 和 toString 等方法，
+ * 简化了代码的编写，减少了样板代码。
  * 
  * @author 
  */
@@ -22,16 +24,34 @@ import java.util.Set;
 public class YamiSysUser {
 
     /**
-     * 用户ID
+     * 用户的唯一标识符，存储用户的 ID 信息。
+     * 通常用于区分不同用户，在数据库操作、权限管理和用户相关的业务逻辑中起着重要作用。
      */
     private Long userId;
 
+    /**
+     * 表示用户是否被启用。
+     * 如果为 true，表示用户处于启用状态，可以正常登录和使用系统；
+     * 若为 false，则用户可能被禁用，无法登录或使用系统的部分或全部功能。
+     */
     private boolean enabled;
 
+    /**
+     * 存储用户的权限集合。
+     * 可以包含用户所拥有的各种权限，如 "READ", "WRITE", "DELETE" 等权限，
+     * 这些权限可以用于控制用户在系统中能够进行的操作。
+     */
     private Set<String> authorities;
 
+    /**
+     * 用户的登录用户名，用于用户登录系统时的身份标识。
+     * 它应该是唯一的，并且用户可以通过该用户名和密码登录系统。
+     */
     private String username;
 
+    /**
+     * 店铺 ID，用于标识用户所属的店铺。
+     * 在多店铺系统中，该字段可用于区分用户与不同店铺的关联，方便进行店铺相关的业务处理和权限管理。
+     */
     private Long shopId;
 }
-

yami-shop-security/yami-shop-security-admin/src/main/java/com/yami/shop/security/admin/util/SecurityUtils.java

@@ -15,6 +15,9 @@ import com.yami.shop.security.common.util.AuthUserContext;
 import lombok.experimental.UtilityClass;
 
 /**
+ * SecurityUtils 类是一个工具类，位于 com.yami.shop.security.admin.util 包下。
+ * 它提供了一个静态方法 getSysUser()，用于获取当前登录用户的系统用户信息。
+ * 这个类使用了 Lombok 的 @UtilityClass 注解，表明它是一个工具类，包含一些静态实用方法。
  *
  * @author LGH
  */
@@ -22,6 +25,8 @@ import lombok.experimental.UtilityClass;
 public class SecurityUtils {
     /**
      * 获取用户
+     *
+     * @return 返回当前登录用户的系统用户信息
      */
     public YamiSysUser getSysUser() {
         UserInfoInTokenBO userInfoInTokenBO = AuthUserContext.get();
@@ -35,4 +40,3 @@ public class SecurityUtils {
         return details;
     }
 }
-