ai-engineering-init 1.3.4 → 1.4.1

package/.codex/skills/ui-pc/SKILL.md

@@ -1,462 +1,424 @@
 ---
 name: ui-pc
 description: |
-  前端（plus-ui）组件库指南。包含 21 个自定义组件、7 个 Store 模块、19 个工具模块。
+  前端组件库指南。包含公共组件、业务组件、Element UI 组件使用。
 
   触发场景：
   - 开发前端后台管理页面
-  - 使用 Element Plus 组件
+  - 使用 Element UI 组件
   - 表格、表单、弹窗、图表等前端 UI
-  - 使用 useDict、useDictStore 等
-  - 使用 Utils 工具函数
+  - 使用 leniu-components 业务组件
+  - 前端权限控制、国际化
 
-  触发词：el-、DictTag、Pagination、RightToolbar、ImagePreview、前端组件、后台页面、管理端、useDict、useDictStore、i18n
+  触发词：el-、el-table、el-form、el-dialog、leniu-page、leniu-table、前端组件、后台页面、v-hasPerm
 
-  适用目录：plus-ui/**
+  适用目录：/Users/xujiajun/Developer/frontProj/web/src/**
 ---
 
 # 前端组件库指南
 
-> **适用于**: `plus-ui/` 目录下的前端后台管理页面开发
+> **适用于**: 腾云智慧食堂管理系统前端项目（Vue 2.7.16 + Element UI 2.15.9）
+>
+> **前端项目路径**: `/Users/xujiajun/Developer/frontProj/web`
 
 ---
 
 ## 目录结构
 
 ```
-plus-ui/src/
-├── api/                # API 接口定义
-├── assets/             # 静态资源
-├── components/         # 自定义组件（21个）
-├── directive/          # 自定义指令
-├── enums/              # 枚举定义
-├── hooks/              # Hooks（1个）
-├── lang/               # 国际化
-├── layout/             # 布局组件
-├── plugins/            # 插件
-├── router/             # 路由配置
-├── store/              # Pinia Store（7个模块）
-├── types/              # 类型定义
-├── utils/              # 工具函数（19个）
-└── views/              # 页面视图
+src/
+├── components/         # 公共组件（~87个）
+├── leniu-components/   # 业务组件（10个核心组件）
+├── layout/             # 布局组件（Navbar/Sidebar/AppMain）
+├── directive/          # 自定义指令（11个）
+└── mixins/             # 全局混入（5个）
 ```
 
 ---
 
-## 组件总览（21 个）
-
-| 组件 | 用途 | 使用场景 |
-|------|------|----------|
-| `Breadcrumb` | 面包屑导航 | 页面顶部路径导航 |
-| `DictTag` | 字典标签 | 显示字典值对应的标签 |
-| `Editor` | 富文本编辑器 | 内容编辑 |
-| `FileUpload` | 文件上传 | 附件上传 |
-| `Hamburger` | 汉堡菜单按钮 | 侧边栏折叠切换 |
-| `IconSelect` | 图标选择器 | 选择系统图标 |
-| `iFrame` | 内嵌页面 | 嵌入外部页面 |
-| `ImagePreview` | 图片预览 | 表格中图片缩略图 |
-| `ImageUpload` | 图片上传 | 头像/图片上传 |
-| `LangSelect` | 语言选择 | 切换系统语言 |
-| `Pagination` | 分页组件 | 列表分页 |
-| `ParentView` | 父级视图 | 路由嵌套容器 |
-| `Process` | 流程组件 | 流程展示 |
-| `RightToolbar` | 右侧工具栏 | 表格工具栏（搜索/刷新/列设置） |
-| `RoleSelect` | 角色选择器 | 选择角色 |
-| `RuoYiDoc` | 文档链接 | 跳转官方文档 |
-| `RuoYiGit` | Git链接 | 跳转仓库 |
-| `Screenfull` | 全屏切换 | 页面全屏 |
-| `SizeSelect` | 尺寸选择 | 切换组件尺寸 |
-| `SvgIcon` | SVG图标 | 显示 SVG 图标 |
-| `TopNav` | 顶部导航 | 顶部菜单导航 |
-| `UserSelect` | 用户选择器 | 选择用户 |
-
-### 常用组件示例
-
-#### DictTag - 字典标签
+## 业务组件（leniu-components）
 
-```vue
-<template>
-  <dict-tag :options="sys_normal_disable" :value="row.status" />
-</template>
-
-<script setup lang="ts">
-const { sys_normal_disable } = useDict('sys_normal_disable')
-</script>
-```
-
-#### Pagination - 分页
-
-```vue
-<pagination
-  v-show="total > 0"
-  :total="total"
-  v-model:page="queryParams.pageNum"
-  v-model:limit="queryParams.pageSize"
-  @pagination="getList"
-/>
-```
-
-#### RightToolbar - 工具栏
-
-```vue
-<right-toolbar
-  v-model:showSearch="showSearch"
-  @queryTable="getList"
-/>
-```
-
-#### ImagePreview - 图片预览
-
-```vue
-<image-preview :src="row.avatar" :width="50" :height="50" />
-```
+| 组件 | 路径 | 用途 |
+|------|------|------|
+| `leniu-page` | `leniu-components/leniu-page` | 页面布局容器（所有业务页面必用） |
+| `leniu-search` | `leniu-components/leniu-search` | 搜索组件（列表页搜索） |
+| `leniu-table` | `leniu-components/leniu-table` | 增强表格组件 |
+| `leniu-form` | `leniu-components/leniu-form` | 表单组件 |
+| `leniu-form-item` | `leniu-components/leniu-form-item` | 表单项组件 |
+| `leniu-form-dialog` | `leniu-components/leniu-form-dialog` | 弹窗表单（新增/编辑） |
+| `leniu-form-panel` | `leniu-components/leniu-form-panel` | 面板表单（详情展示） |
+| `leniu-button-list` | `leniu-components/leniu-button-list` | 按钮组 |
+| `leniu-table-toolbar` | `leniu-components/leniu-table-toolbar` | 表格工具栏 |
 
 ---
 
-## Store 模块（7 个）
-
-| Store | 文件 | 职责 |
-|-------|------|------|
-| `useUserStore` | `store/modules/user.ts` | 用户信息、登录状态、角色权限 |
-| `useAppStore` | `store/modules/app.ts` | 应用状态（侧边栏、设备类型） |
-| `useDictStore` | `store/modules/dict.ts` | 字典数据缓存 |
-| `useNoticeStore` | `store/modules/notice.ts` | 通知消息 |
-| `usePermissionStore` | `store/modules/permission.ts` | 权限路由管理 |
-| `useSettingsStore` | `store/modules/settings.ts` | 系统设置 |
-| `useTagsViewStore` | `store/modules/tagsView.ts` | 标签页管理 |
-
-### useUserStore 用法
-
-```typescript
-import { useUserStore } from '@/store/modules/user'
-
-const userStore = useUserStore()
-
-// 属性
-userStore.userId        // 用户ID
-userStore.tenantId      // 租户ID
-userStore.token         // 登录令牌
-userStore.nickname      // 昵称
-userStore.avatar        // 头像
-userStore.roles         // 角色列表
-userStore.permissions   // 权限列表
-
-// 方法
-await userStore.login(userInfo)  // 登录
-await userStore.getInfo()        // 获取用户信息
-await userStore.logout()         // 登出
-userStore.setAvatar(url)         // 设置头像
-```
-
-### useDictStore 用法
-
-```typescript
-import { useDictStore } from '@/store/modules/dict'
+## 常用公共组件（components）
 
-const dictStore = useDictStore()
-const dicts = dictStore.getDict('sys_normal_disable')
-dictStore.setDict('sys_normal_disable', dictData)
-```
+| 组件 | 用途 |
+|------|------|
+| `Pagination` | 分页组件 |
+| `CollapseSearch` | 折叠搜索区域 |
+| `Breadcrumb` | 面包屑导航 |
+| `Dropzone` | 文件拖拽上传 |
+| `ImageCropper` | 图片裁剪 |
+| `Tinymce` | 富文本编辑器 |
+| `UploadImageList` | 图片上传列表 |
 
 ---
 
-## Hooks（1 个）
+## 全局原型方法（main.js 挂载）
 
-### useDialog
+在任意组件中可直接使用：
 
-```typescript
-import useDialog from '@/hooks/useDialog'
-
-const { dialogVisible, openDialog, closeDialog } = useDialog()
-```
+| 方法/属性 | 说明 | 示例 |
+|----------|------|------|
+| `this.money(fen)` | 分转元（保留2位小数） | `this.money(100)` → `'1.00'` |
+| `this.accMul(val, 100)` | 精确乘法（元转分） | `this.accMul(1.5, 100)` → `150` |
+| `this.parseTime(time, fmt)` | 格式化时间 | `this.parseTime(new Date(), '{y}-{m}-{d}')` |
+| `this.$echarts` | ECharts 实例 | `this.$echarts.init(el)` |
+| `this.$hasPerm(['xxx:add'])` | 权限判断（JS中） | 返回 true/false |
+| `this.isDevEnv` | 是否纯本地开发环境 | true/false |
+| `this.isDevTestEnv` | 是否开发测试环境 | 含 dev/test 域名 |
+| `this._` | Lodash 工具库 | `this._.debounce(fn, 300)` |
+| `this.validators` | 表单校验规则集 | `this.validators.required()` |
+| `this.inputRules` | 输入过滤规则 | `this.inputRules.number(val)` |
+| `this.CNEN` | 中英文拼接工具 | 根据 i18n 拼接 |
 
 ---
 
-## Utils 工具函数（19 个模块）
-
-### dict.ts - 字典工具（高频使用）
-
-```typescript
-import { useDict } from '@/utils/dict'
-
-// 获取字典数据
-const { sys_normal_disable, sys_user_sex } = useDict(
-  'sys_normal_disable',
-  'sys_user_sex'
-)
+## 自定义指令（directive）
 
-// 返回格式：
-// { label: '正常', value: '0', elTagType: 'primary', elTagClass: '' }
-```
-
-### request.ts - HTTP 请求
-
-```typescript
-import request from '@/utils/request'
-
-// GET 请求
-export function listUser(query) {
-  return request({
-    url: '/system/user/list',
-    method: 'get',
-    params: query
-  })
-}
+```vue
+<!-- 按钮权限（最常用）-->
+<el-button v-hasPerm="['xxx:add']">新增</el-button>
+<el-button v-hasPerm="['xxx:edit']">修改</el-button>
+<el-button v-hasPerm="['xxx:remove']">删除</el-button>
 
-// POST 请求
-export function addUser(data) {
-  return request({
-    url: '/system/user',
-    method: 'post',
-    data: data
-  })
-}
+<!-- 角色权限 -->
+<el-button v-hasRole="['admin']">管理员按钮</el-button>
 ```
 
-### auth.ts - 认证工具
+---
 
-```typescript
-import { getToken, setToken, removeToken } from '@/utils/auth'
+## 国际化（i18n）
 
-const token = getToken()
-setToken('new-token')
-removeToken()
+```vue
+<template>
+  <!-- 使用翻译 -->
+  <span>{{ $t('规则名称') }}</span>
+  <el-button>{{ $t('action.query') }}</el-button>
+  <el-button>{{ $t('新增') }}</el-button>
+</template>
 ```
 
-### ruoyi.ts - 通用工具
+> **注意**：语言文件在 `src/lang/` 目录，支持中文（zh）和英文（en）
 
-```typescript
-import {
-  parseTime,           // 时间格式化
-  resetForm,           // 重置表单
-  addDateRange,        // 添加日期范围参数
-  selectDictLabel,     // 获取字典标签
-  handleTree,          // 构造树形结构
-  blobValidate         // Blob 验证
-} from '@/utils/ruoyi'
+---
 
-// 日期范围查询
-addDateRange(queryParams, dateRange, 'createTime')
+## 全局 Mixin（mixins/index.js）
 
-// 构造树形结构
-const treeData = handleTree(data, 'id', 'parentId')
-```
+所有组件自动混入，提供以下方法：
 
-### validate.ts - 验证工具
-
-```typescript
-import {
-  isURL,
-  isLowerCase,
-  isUpperCase,
-  isAlphabets,
-  isEmail,
-  isMobile,
-  isPhone,
-  isIdCard,
-  isNumber,
-  isIntegerGreaterThanZero
-} from '@/utils/validate'
-
-if (isEmail(value)) { ... }
-if (isMobile(value)) { ... }
-```
+```javascript
+// 金额输入过滤（只允许数字和小数点）
+this.oninput(value, decimalLimit, maxLength, maxValue)
 
-### index.ts - 通用工具函数
-
-```typescript
-import {
-  formatDate,        // 日期格式化
-  formatTime,        // 时间格式化（相对时间）
-  debounce,          // 防抖
-  deepClone,         // 深拷贝
-  uniqueArr,         // 数组去重
-  hasClass,          // 判断类名
-  addClass,          // 添加类名
-  removeClass,       // 移除类名
-  isExternal         // 是否外部链接
-} from '@/utils'
-```
+// 只允许字母和数字
+this.LetterAndNum(value, maxLength)
 
-### crypto.ts - 加密工具
+// 只允许数字
+this.Num(value, maxLength)
 
-```typescript
-import { encrypt, decrypt } from '@/utils/crypto'
+// 获取当前时间戳字符串
+this.getTimestamp()
 
-const encrypted = encrypt(data)
-const decrypted = decrypt(encrypted)
+// 获取图片完整URL
+this.getUrl1(path)  // 自动拼接 baseUrl
 ```
 
-### jsencrypt.ts - RSA 加密
-
-```typescript
-import { encrypt, decrypt } from '@/utils/jsencrypt'
-
-const encrypted = encrypt(password)
-```
+---
 
-### permission.ts - 权限工具
+## 标准列表页结构
 
-```typescript
-import { checkPermi, checkRole } from '@/utils/permission'
+```vue
+<template>
+  <page-slot>
+    <!-- 搜索区域 -->
+    <collapse-search slot="search">
+      <template v-slot:outerCol>
+        <el-col :span="6">
+          <el-form-item :label="$t('名称')">
+            <el-input v-model="listQuery.name" clearable />
+          </el-form-item>
+        </el-col>
+        <el-col :span="6">
+          <el-form-item :label="$t('状态')">
+            <el-select v-model="listQuery.status" clearable>
+              <el-option label="正常" value="1" />
+              <el-option label="停用" value="0" />
+            </el-select>
+          </el-form-item>
+        </el-col>
+      </template>
+      <el-button
+        slot="operate"
+        type="primary"
+        icon="el-icon-search"
+        @click="() => (page.current = 1) && getData()"
+      >
+        {{ $t('action.query') }}
+      </el-button>
+    </collapse-search>
+
+    <!-- 操作按钮 -->
+    <el-button
+      slot="tableTopLeft"
+      type="primary"
+      plain
+      icon="el-icon-plus"
+      v-hasPerm="['xxx:add']"
+      @click="handleAdd"
+    >
+      {{ $t('新增') }}
+    </el-button>
 
-// 检查权限
-if (checkPermi(['system:user:add'])) { ... }
+    <!-- 表格 -->
+    <el-table
+      slot="table"
+      height="100%"
+      stripe
+      :data="tableData"
+      v-loading="loading"
+    >
+      <el-table-column prop="name" :label="$t('名称')" min-width="150" />
+      <el-table-column prop="status" :label="$t('状态')">
+        <template slot-scope="{ row }">
+          <el-tag :type="row.status === '1' ? 'success' : 'danger'">
+            {{ row.status === '1' ? '正常' : '停用' }}
+          </el-tag>
+        </template>
+      </el-table-column>
+      <el-table-column :label="$t('操作')" width="180" align="center">
+        <template slot-scope="{ row }">
+          <el-button type="text" @click="handleEdit(row)" v-hasPerm="['xxx:edit']">
+            {{ $t('修改') }}
+          </el-button>
+          <el-button type="text" @click="handleDelete(row)" v-hasPerm="['xxx:remove']">
+            {{ $t('删除') }}
+          </el-button>
+        </template>
+      </el-table-column>
+    </el-table>
+  </page-slot>
+</template>
 
-// 检查角色
-if (checkRole(['admin'])) { ... }
+<script>
+import { getList, del } from '@/api/xxx'
+
+export default {
+  name: 'XxxList',
+  data() {
+    return {
+      loading: false,
+      tableData: [],
+      total: 0,
+      page: { current: 1, size: 20 },
+      listQuery: {
+        name: '',
+        status: ''
+      }
+    }
+  },
+  mounted() {
+    this.getData()
+  },
+  methods: {
+    async getData() {
+      this.loading = true
+      try {
+        const res = await getList({
+          page: this.page,
+          object: this.listQuery
+        })
+        this.tableData = res.records || []
+        this.total = res.total || 0
+      } finally {
+        this.loading = false
+      }
+    },
+    handleAdd() {
+      this.visible = true
+      this.form = {}
+    },
+    handleEdit(row) {
+      this.visible = true
+      this.form = { ...row }
+    },
+    handleDelete(row) {
+      this.$confirm('确定删除？', '提示', {
+        type: 'warning'
+      }).then(async () => {
+        await del(row.id)
+        this.$message.success('删除成功')
+        this.getData()
+      })
+    }
+  }
+}
+</script>
 ```
 
-### websocket.ts - WebSocket
-
-```typescript
-import { initWebSocket, closeWebSocket, sendMessage } from '@/utils/websocket'
-
-initWebSocket(url, onMessage, onError)
-sendMessage(data)
-closeWebSocket()
-```
+---
 
-### sse.ts - Server-Sent Events
+## 标准表单弹窗
 
-```typescript
-import { createSSE, closeSSE } from '@/utils/sse'
+```vue
+<template>
+  <el-dialog
+    :title="form.id ? '编辑' : '新增'"
+    :visible.sync="visible"
+    width="600px"
+    @close="handleClose"
+  >
+    <el-form ref="form" :model="form" :rules="rules" label-width="100px">
+      <el-form-item label="名称" prop="name">
+        <el-input v-model="form.name" placeholder="请输入名称" />
+      </el-form-item>
+      <el-form-item label="状态" prop="status">
+        <el-radio-group v-model="form.status">
+          <el-radio label="1">正常</el-radio>
+          <el-radio label="0">停用</el-radio>
+        </el-radio-group>
+      </el-form-item>
+    </el-form>
+    <div slot="footer">
+      <el-button @click="visible = false">取消</el-button>
+      <el-button type="primary" :loading="submitting" @click="handleSubmit">
+        确定
+      </el-button>
+    </div>
+  </el-dialog>
+</template>
 
-const sse = createSSE(url, onMessage)
-closeSSE(sse)
+<script>
+import { add, update } from '@/api/xxx'
+
+export default {
+  name: 'XxxForm',
+  props: {
+    visible: Boolean,
+    data: Object
+  },
+  data() {
+    return {
+      form: {},
+      rules: {
+        name: [{ required: true, message: '请输入名称', trigger: 'blur' }]
+      },
+      submitting: false
+    }
+  },
+  watch: {
+    data: {
+      immediate: true,
+      handler(val) {
+        this.form = val ? { ...val } : {}
+      }
+    }
+  },
+  methods: {
+    handleClose() {
+      this.$refs.form.resetFields()
+      this.$emit('update:visible', false)
+    },
+    async handleSubmit() {
+      this.$refs.form.validate(async (valid) => {
+        if (!valid) return
+        this.submitting = true
+        try {
+          const api = this.form.id ? update : add
+          await api(this.form)
+          this.$message.success('保存成功')
+          this.$emit('success')
+          this.handleClose()
+        } finally {
+          this.submitting = false
+        }
+      })
+    }
+  }
+}
+</script>
 ```
 
 ---
 
-## 标准列表页结构
+## API 接口定义规范
 
-### 1. 搜索区域
+所有 API 调用通过 `src/utils/request.js` 封装，请求格式有两种：
 
-```vue
-<el-form :model="queryParams" ref="queryRef" :inline="true" v-show="showSearch">
-  <el-form-item label="用户名称" prop="userName">
-    <el-input
-      v-model="queryParams.userName"
-      placeholder="请输入用户名称"
-      clearable
-      @keyup.enter="handleQuery"
-    />
-  </el-form-item>
-  <el-form-item label="状态" prop="status">
-    <el-select v-model="queryParams.status" placeholder="用户状态" clearable>
-      <el-option
-        v-for="dict in sys_normal_disable"
-        :key="dict.value"
-        :label="dict.label"
-        :value="dict.value"
-      />
-    </el-select>
-  </el-form-item>
-  <el-form-item>
-    <el-button type="primary" icon="Search" @click="handleQuery">搜索</el-button>
-    <el-button icon="Refresh" @click="resetQuery">重置</el-button>
-  </el-form-item>
-</el-form>
-```
+### 标准请求格式（带 content 包裹）
 
-### 2. 工具栏区域
+```javascript
+// src/api/xxx.js
+import request from '@/utils/request'
 
-```vue
-<el-row :gutter="10" class="mb8">
-  <el-col :span="1.5">
-    <el-button type="primary" plain icon="Plus" @click="handleAdd" v-hasPermi="['system:user:add']">
-      新增
-    </el-button>
-  </el-col>
-  <el-col :span="1.5">
-    <el-button type="success" plain icon="Edit" :disabled="single" @click="handleUpdate" v-hasPermi="['system:user:edit']">
-      修改
-    </el-button>
-  </el-col>
-  <el-col :span="1.5">
-    <el-button type="danger" plain icon="Delete" :disabled="multiple" @click="handleDelete" v-hasPermi="['system:user:remove']">
-      删除
-    </el-button>
-  </el-col>
-  <right-toolbar v-model:showSearch="showSearch" @queryTable="getList" />
-</el-row>
-```
+// 分页查询
+export function getList(data) {
+  return request({
+    url: '/api/v1/xxx/list',
+    method: 'post',
+    data: {
+      version: '1.0',
+      nonceStr: '1212fsadf',
+      timestamp: '2020-4-21',
+      signType: 'md5',
+      content: data,  // 业务数据放在 content 中
+      sign: 'xxx'
+    }
+  })
+}
 
-### 3. 表格区域
+// GET 请求
+export function getDetail(id) {
+  return request({
+    url: `/api/v1/xxx/detail/${id}`,
+    method: 'get',
+    params: { version: '1.0', content: { id } }
+  })
+}
 
-```vue
-<el-table v-loading="loading" :data="userList" @selection-change="handleSelectionChange">
-  <el-table-column type="selection" width="50" align="center" />
-  <el-table-column label="用户编号" align="center" prop="userId" />
-  <el-table-column label="用户名称" align="center" prop="userName" />
-  <el-table-column label="头像" align="center" prop="avatar" width="80">
-    <template #default="scope">
-      <image-preview :src="scope.row.avatar" :width="50" :height="50" />
-    </template>
-  </el-table-column>
-  <el-table-column label="状态" align="center" prop="status">
-    <template #default="scope">
-      <dict-tag :options="sys_normal_disable" :value="scope.row.status" />
-    </template>
-  </el-table-column>
-  <el-table-column label="操作" align="center" width="180">
-    <template #default="scope">
-      <el-button link type="primary" icon="Edit" @click="handleUpdate(scope.row)" v-hasPermi="['system:user:edit']">
-        修改
-      </el-button>
-      <el-button link type="primary" icon="Delete" @click="handleDelete(scope.row)" v-hasPermi="['system:user:remove']">
-        删除
-      </el-button>
-    </template>
-  </el-table-column>
-</el-table>
-
-<pagination
-  v-show="total > 0"
-  :total="total"
-  v-model:page="queryParams.pageNum"
-  v-model:limit="queryParams.pageSize"
-  @pagination="getList"
-/>
+// 删除
+export function del(id) {
+  return request({
+    url: `/api/v1/xxx/delete`,
+    method: 'post',
+    data: { version: '1.0', content: { id } }
+  })
+}
 ```
 
-### 4. 弹窗表单
-
-```vue
-<el-dialog :title="title" v-model="open" width="500px" append-to-body>
-  <el-form ref="formRef" :model="form" :rules="rules" label-width="80px">
-    <el-form-item label="用户名称" prop="userName">
-      <el-input v-model="form.userName" placeholder="请输入用户名称" />
-    </el-form-item>
-    <el-form-item label="状态" prop="status">
-      <el-radio-group v-model="form.status">
-        <el-radio
-          v-for="dict in sys_normal_disable"
-          :key="dict.value"
-          :value="dict.value"
-        >{{ dict.label }}</el-radio>
-      </el-radio-group>
-    </el-form-item>
-  </el-form>
-  <template #footer>
-    <div class="dialog-footer">
-      <el-button type="primary" @click="submitForm">确 定</el-button>
-      <el-button @click="cancel">取 消</el-button>
-    </div>
-  </template>
-</el-dialog>
-```
+> **注意**：
+> - 请求拦截器会自动添加签名（MD5）
+> - 所有接口都走 SM4 国密加密（`/security/` 前缀）
+> - 响应 `code == 10000` 为成功，返回 `res.data`
+> - 响应 `code == 20001` 为登录失效，自动跳转登录
 
 ---
 
-## 权限指令
+## 金额处理规范
 
-```vue
-<!-- 按钮权限 -->
-<el-button v-hasPermi="['system:user:add']">新增</el-button>
+```javascript
+// ✅ 前端展示：分转元（使用全局 money 方法）
+this.money(10000)  // → '100.00'
+this.money(null)   // → ''
 
-<!-- 角色权限 -->
-<el-button v-hasRole="['admin']">管理员按钮</el-button>
+// ✅ 后端传参：元转分（使用全局 accMul 方法）
+this.accMul(100, 100)  // → 10000
+
+// ❌ 禁止直接 / 100 或 * 100（精度问题）
+amount / 100  // 禁止
+amount * 100  // 禁止
 ```
 
 ---
@@ -465,11 +427,12 @@ closeSSE(sse)
 
 | 用途 | 路径 |
 |------|------|
-| 标准 CRUD 页面 | `plus-ui/src/views/system/user/index.vue` |
-| API 定义规范 | `plus-ui/src/api/system/user/index.ts` |
-| 字典标签组件 | `plus-ui/src/components/DictTag/index.vue` |
-| 分页组件 | `plus-ui/src/components/Pagination/index.vue` |
-| 工具栏组件 | `plus-ui/src/components/RightToolbar/index.vue` |
-| 字典工具 | `plus-ui/src/utils/dict.ts` |
-| 通用工具 | `plus-ui/src/utils/ruoyi.ts` |
-| 用户 Store | `plus-ui/src/store/modules/user.ts` |
+| 业务组件 | `/Users/xujiajun/Developer/frontProj/web/src/leniu-components/` |
+| 公共组件 | `/Users/xujiajun/Developer/frontProj/web/src/components/` |
+| 标准列表页 | `/Users/xujiajun/Developer/frontProj/web/src/leniuview/marketing/` |
+| API 定义示例 | `/Users/xujiajun/Developer/frontProj/web/src/api/marketing.js` |
+| 请求封装 | `/Users/xujiajun/Developer/frontProj/web/src/utils/request.js` |
+| Token/租户工具 | `/Users/xujiajun/Developer/frontProj/web/src/utils/auth.js` |
+| 全局工具函数 | `/Users/xujiajun/Developer/frontProj/web/src/utils/index.js` |
+| 权限守卫 | `/Users/xujiajun/Developer/frontProj/web/src/permission.js` |
+| 主入口 | `/Users/xujiajun/Developer/frontProj/web/src/main.js` |