ai-engineering-init 1.1.0

package/.cursor/skills/store-pc/SKILL.md

@@ -0,0 +1,366 @@
+---
+name: store-pc
+description: |
+  前端状态管理指南。包含 Vuex Store 的创建和使用规范。
+
+  触发场景：
+  - 创建/使用 Vuex Store
+  - Vuex 状态管理
+  - 跨组件数据共享
+  - 全局状态管理
+
+  触发词：Vuex、store、mapState、mapActions、commit、dispatch、状态管理
+
+  适用目录：/Users/xujiajun/Developer/frontProj/web/src/store/**
+---
+
+# 前端状态管理指南
+
+> **适用于**: 腾云智慧食堂管理系统前端项目（Vue 2.7.16 + Vuex 3.4.0）
+>
+> **Store 目录**: `/Users/xujiajun/Developer/frontProj/web/src/store/`
+
+---
+
+## 目录结构
+
+```
+src/store/
+├── index.js           # Store 入口（Vuex 初始化）
+├── getters.js         # 全局 getters
+└── modules/           # Store 模块（28个）
+    ├── user.js        # 用户状态（最核心）
+    ├── app.js         # 应用状态（语言/尺寸）
+    ├── permission.js  # 权限路由管理
+    ├── tagsView.js    # 标签页管理
+    ├── settings.js    # 系统设置
+    ├── marketing.js   # 营销状态
+    ├── order.js       # 订单状态
+    ├── stock.js       # 库存状态
+    ├── reportcenter.js # 报表状态
+    ├── account.js     # 账户状态
+    ├── purchase.js    # 采购状态
+    ├── chart.js       # 图表状态
+    ├── notice.js      # 通知状态
+    ├── upload.js      # 上传状态
+    ├── menudish.js    # 菜品状态
+    ├── supplyChain.js # 供应链状态
+    └── ...            # 其他业务模块
+```
+
+---
+
+## 全局 Getters（getters.js）
+
+```javascript
+// 常用全局 getters（可直接用 mapGetters 访问）
+{
+  token,            // 登录 token
+  name,             // 用户名
+  userInfo,         // 完整用户信息对象
+  permissions,      // 权限列表
+  hasRoles,         // 是否已加载角色（用于路由守卫）
+  permission_routes, // 已生成的权限路由
+  adminMerchant,    // 是否为超级管理员商户
+  url,              // API base URL
+  language,         // 当前语言（zh/en）
+  size,             // Element UI 组件尺寸
+  areaOptions,      // 区域选项（来自 supplyChain）
+}
+```
+
+---
+
+## 创建新 Store
+
+### 标准模板
+
+```javascript
+// src/store/modules/xxx.js
+import { getList, getDetail } from '@/api/xxx'
+
+const state = {
+  list: [],
+  current: null,
+  loading: false,
+  total: 0
+}
+
+const mutations = {
+  SET_LIST: (state, list) => {
+    state.list = list
+  },
+  SET_CURRENT: (state, current) => {
+    state.current = current
+  },
+  SET_LOADING: (state, loading) => {
+    state.loading = loading
+  },
+  SET_TOTAL: (state, total) => {
+    state.total = total
+  }
+}
+
+const actions = {
+  /**
+   * 获取列表
+   */
+  async fetchList({ commit }, params) {
+    commit('SET_LOADING', true)
+    try {
+      const res = await getList({
+        page: { current: params.current || 1, size: params.size || 20 },
+        object: params
+      })
+      commit('SET_LIST', res.records || [])
+      commit('SET_TOTAL', res.total || 0)
+      return res
+    } finally {
+      commit('SET_LOADING', false)
+    }
+  },
+
+  /**
+   * 获取详情
+   */
+  async fetchDetail({ commit }, id) {
+    const res = await getDetail({ id })
+    commit('SET_CURRENT', res)
+    return res
+  },
+
+  /**
+   * 重置状态
+   */
+  reset({ commit }) {
+    commit('SET_LIST', [])
+    commit('SET_CURRENT', null)
+    commit('SET_TOTAL', 0)
+  }
+}
+
+const getters = {
+  list: state => state.list,
+  current: state => state.current,
+  loading: state => state.loading,
+  total: state => state.total
+}
+
+export default {
+  namespaced: true,
+  state,
+  mutations,
+  actions,
+  getters
+}
+```
+
+### 在 index.js 中注册
+
+```javascript
+// src/store/index.js
+import xxx from './modules/xxx'
+
+export default new Vuex.Store({
+  modules: {
+    // ... 其他模块
+    xxx
+  }
+})
+```
+
+---
+
+## 使用 Store
+
+### 方式 1：直接访问
+
+```javascript
+export default {
+  computed: {
+    list() {
+      return this.$store.state.xxx.list
+    },
+    loading() {
+      return this.$store.state.xxx.loading
+    },
+    // 使用全局 getter
+    token() {
+      return this.$store.getters.token
+    },
+    userInfo() {
+      return this.$store.getters.userInfo
+    }
+  },
+  methods: {
+    getData() {
+      this.$store.dispatch('xxx/fetchList', this.queryParams)
+    }
+  }
+}
+```
+
+### 方式 2：mapState / mapGetters / mapActions
+
+```javascript
+import { mapState, mapGetters, mapActions, mapMutations } from 'vuex'
+
+export default {
+  computed: {
+    // 模块内 state
+    ...mapState('xxx', ['list', 'loading', 'total']),
+
+    // 全局 getters
+    ...mapGetters(['token', 'userInfo', 'permissions', 'adminMerchant'])
+  },
+  methods: {
+    ...mapActions('xxx', ['fetchList', 'fetchDetail', 'reset']),
+
+    async getData() {
+      await this.fetchList({ ...this.queryParams, ...this.page })
+    }
+  },
+  mounted() {
+    this.getData()
+  }
+}
+```
+
+---
+
+## 核心 Store 模块说明
+
+### user.js（用户状态）
+
+最重要的模块，包含：
+- `state.token` - 登录 token
+- `state.userInfo` - 完整用户信息（userId、roles、roleCode、merchantId 等）
+- `state.hasRoles` - 是否已加载角色信息
+- `state.adminMerchant` - 是否为超级管理员（`roleCode === 'ROLE_ADMIN'`）
+- `state.merchantList` - 商户列表（管理员可切换商户）
+
+```javascript
+// 在路由守卫中获取用户信息
+const userInfo = await store.dispatch('user/getInfo')
+
+// 登出
+await store.dispatch('user/resetToken')
+localStorage.clear()
+locationHref()
+```
+
+### permission.js（权限路由）
+
+- 根据用户角色动态生成路由
+- `state.routes` - 完整路由表（用于菜单渲染）
+- `state.addRoutes` - 动态添加的路由
+
+```javascript
+// 在路由守卫中生成权限路由
+const accessRoutes = await store.dispatch('permission/generateRoutes')
+accessRoutes.forEach(route => {
+  router.addRoute(route)
+})
+```
+
+### app.js（应用状态）
+
+- `state.language` - 当前语言（zh/en）
+- `state.size` - Element UI 组件尺寸
+
+---
+
+## 最佳实践
+
+### 1. 何时使用 Store
+
+| 场景 | 是否使用 Store |
+|------|---------------|
+| 多个页面/组件共享的数据 | ✅ 使用 |
+| 用户登录状态、权限 | ✅ 使用（user 模块） |
+| 全局配置（语言、尺寸） | ✅ 使用（app 模块） |
+| 页面内部状态（表单数据）| ❌ 用 data |
+| 父子组件传值 | ❌ 用 props/emit |
+| 兄弟组件通信（简单） | ❌ 用 eventBus |
+
+### 2. 命名规范
+
+```javascript
+// ✅ 正确：Mutation 大写字母+下划线
+const mutations = {
+  SET_LIST: (state, list) => { state.list = list },
+  SET_LOADING: (state, v) => { state.loading = v }
+}
+
+// ✅ 正确：Action 小驼峰
+const actions = {
+  fetchList: async ({ commit }, params) => { },
+  fetchDetail: async ({ commit }, id) => { }
+}
+
+// ✅ 正确：模块文件名小写，匹配业务名
+// store/modules/marketing.js
+// store/modules/order.js
+```
+
+### 3. 登出时重置 Store
+
+```javascript
+// 在 user store 中
+const actions = {
+  async resetToken({ commit }) {
+    commit('SET_TOKEN', '')
+    commit('SET_HAS_ROLES', false)
+    removeToken()
+    removeTenant()
+  }
+}
+
+// 登出时（permission.js 路由守卫中）
+await store.dispatch('user/resetToken')
+localStorage.clear()
+locationHref()  // 使用全局 locationHref 跳转（不用 router.push）
+```
+
+### 4. 分页数据格式
+
+```javascript
+// 后端返回的分页数据格式
+{
+  records: [],  // 数据列表（非 rows）
+  total: 100,
+  current: 1,
+  size: 20
+}
+
+// 请求分页参数格式
+{
+  page: { current: 1, size: 20 },
+  object: { ...queryParams }  // 查询条件
+}
+```
+
+---
+
+## 参考文件
+
+| Store | 路径 |
+|-------|------|
+| Store 入口 | `/Users/xujiajun/Developer/frontProj/web/src/store/index.js` |
+| 全局 Getters | `/Users/xujiajun/Developer/frontProj/web/src/store/getters.js` |
+| 用户 Store | `/Users/xujiajun/Developer/frontProj/web/src/store/modules/user.js` |
+| 权限 Store | `/Users/xujiajun/Developer/frontProj/web/src/store/modules/permission.js` |
+| 应用 Store | `/Users/xujiajun/Developer/frontProj/web/src/store/modules/app.js` |
+| 设置 Store | `/Users/xujiajun/Developer/frontProj/web/src/store/modules/settings.js` |
+| 标签页 Store | `/Users/xujiajun/Developer/frontProj/web/src/store/modules/tagsView.js` |
+
+---
+
+## 注意事项
+
+1. **本项目使用 Vuex 3.x**（非 Pinia），与 Vue 2 配套
+2. **Store 模块必须设置 `namespaced: true`**
+3. **异步操作放在 Actions 中**，同步操作放在 Mutations 中
+4. **分页数据用 `records`**，不是 `rows`（与 RuoYi 后端框架不同）
+5. **登出使用 `locationHref()`** 而非 `router.push('/login')`，目的是清除内存中的数据
+6. **`adminMerchant` 为 true 时**，用户是超级管理员（`roleCode === 'ROLE_ADMIN'`），可切换商户

package/.cursor/skills/task-tracker/SKILL.md

@@ -0,0 +1,307 @@
+---
+name: task-tracker
+description: |
+  开发任务进度跟踪系统。当用户需要记录复杂开发任务的需求、步骤、进度时自动使用此 Skill。
+  创建 Markdown 文档实现任务上下文持久化，支持中断后快速恢复。
+
+  触发场景：
+  - 多步骤功能开发（需要跨会话）
+  - 复杂需求的步骤分解与跟踪
+  - 任务进度记录与更新
+  - 中断后的任务恢复
+  - 历史任务查询与归档
+
+  触发词：创建任务、跟踪任务、记录进度、任务跟踪、继续任务、恢复任务、查看任务、归档任务、任务列表
+---
+
+# 任务跟踪技能
+
+## 何时使用
+
+✅ 用户明确要求跟踪任务（"创建任务跟踪"、"记录进度"、"跟踪这个任务"）
+✅ 复杂的多步骤开发任务
+✅ 需要跨会话恢复的工作
+
+❌ 简单的单步操作
+❌ 纯咨询性对话
+
+## 目录结构
+
+```
+{项目根目录}/
+└── docs/
+    └── tasks/
+        ├── README.md          # 使用说明（首次自动生成）
+        ├── active/            # 进行中的任务
+        │   └── task-20260121-153045-用户反馈.md
+        └── archive/           # 已完成的任务
+            └── 2026-01/
+                └── task-20260120-优惠券系统.md
+```
+
+## 文档模板
+
+```markdown
+# 任务：{任务标题}
+
+**状态**: 🟢 进行中 | 🔵 已完成 | 🔴 已暂停
+**创建时间**: {YYYY-MM-DD HH:MM:SS}
+**更新时间**: {YYYY-MM-DD HH:MM:SS}
+**Git 分支**: {branch_name}
+
+---
+
+## 📋 需求描述
+
+{用户原始需求的详细描述，包括背景、目标、约束条件}
+
+---
+
+## 🎯 实现步骤
+
+- [ ] 1. {步骤1简述}
+  - **文件**: `path/to/file.ext`
+  - **说明**: {详细说明}
+
+- [x] 2. {步骤2简述}
+  - **文件**: `another/file.ext`
+  - **说明**: {详细说明}
+  - **完成时间**: {YYYY-MM-DD HH:MM}
+
+- [ ] 3. {步骤3简述}
+
+---
+
+## 📝 关键决策
+
+- **模块归属**: {模块名称}
+- **数据库表**: {表名前缀}
+- **主键策略**: {ID生成方式}
+- **技术选型**: {框架/库版本}
+
+---
+
+## 🔄 当前进度
+
+**已完成**: {X} / {总数} 步骤 ({百分比}%)
+
+**下一步操作**:
+1. {下一步具体要做的事情}
+2. {再下一步}
+
+---
+
+## 📁 相关文件
+
+- `{文件路径}` - {文件用途}
+
+---
+
+## ⚠️ 注意事项
+
+- {需要特别注意的点}
+- {已知问题或风险}
+
+---
+
+## 💬 变更记录
+
+### {YYYY-MM-DD HH:MM}
+- {本次更新内容}
+```
+
+## 核心操作
+
+### 1. 创建任务
+
+**触发**：用户说"创建任务跟踪"、"记录这个任务"
+
+**步骤**：
+```bash
+# 1. 确保目录存在
+mkdir -p docs/tasks/active docs/tasks/archive
+
+# 2. 生成文件名
+# 格式: task-{YYYYMMdd-HHMMSS}-{任务简称}.md
+TIMESTAMP=$(date +%Y%m%d-%H%M%S)
+SLUG="{任务标题简化版，截断30字符}"
+FILENAME="task-${TIMESTAMP}-${SLUG}.md"
+
+# 3. 创建文档
+# 填充上述模板内容到 docs/tasks/active/$FILENAME
+
+# 4. 首次使用时创建 README.md（如不存在）
+```
+
+**README.md 内容**：
+```markdown
+# 任务跟踪中心
+
+## 目录说明
+- `active/` - 进行中的任务
+- `archive/` - 已完成的任务（按月归档）
+
+## 使用方法
+1. Claude 自动创建任务跟踪文档
+2. 手动编辑文档更新进度（修改复选框）
+3. 任务完成后移动到 archive/{年-月}/
+
+## 快速恢复
+```bash
+# 查看活跃任务
+ls -1 active/
+
+# 恢复任务
+cat active/task-20260121-*.md
+```
+
+### 2. 更新进度
+
+**触发**：用户说"更新进度"、"标记步骤X完成"
+
+**步骤**：
+```bash
+# 1. 找到当前任务文档（最新的那个）
+TASK_FILE=$(ls -t docs/tasks/active/*.md | head -1)
+
+# 2. 更新复选框: - [ ] → - [x]
+sed -i "s/^- \[ \] ${STEP_NUMBER}\./- [x] ${STEP_NUMBER}./" "$TASK_FILE"
+
+# 3. 更新时间戳
+CURRENT_TIME=$(date '+%Y-%m-%d %H:%M:%S')
+sed -i "s/^\*\*更新时间\*\*:.*/\*\*更新时间\*\*: $CURRENT_TIME/" "$TASK_FILE"
+
+# 4. 添加变更记录
+echo -e "### $CURRENT_TIME\n- 完成步骤 $STEP_NUMBER: $DESCRIPTION" >> "$TASK_FILE"
+
+# 5. 重新计算进度百分比
+TOTAL=$(grep -c "^- \[.\]" "$TASK_FILE")
+DONE=$(grep -c "^- \[x\]" "$TASK_FILE")
+PERCENT=$((DONE * 100 / TOTAL))
+```
+
+### 3. 列出活跃任务
+
+**触发**：用户说"有哪些任务"、"列出任务"
+
+**步骤**：
+```bash
+for file in docs/tasks/active/*.md; do
+  TITLE=$(grep "^# 任务：" "$file" | sed 's/^# 任务：//')
+  STATUS=$(grep "^\*\*状态\*\*:" "$file" | sed 's/.*: //')
+  PROGRESS=$(grep "^\*\*已完成\*\*:" "$file" | sed 's/.*: //')
+  
+  echo "📄 $TITLE"
+  echo "   状态: $STATUS | 进度: $PROGRESS"
+  echo "   文件: $file"
+  echo ""
+done
+```
+
+### 4. 恢复任务
+
+**触发**：用户说"继续上次的任务"、"恢复任务"
+
+**步骤**：
+```bash
+# 1. 确定要恢复的任务
+if [ 用户指定了任务名 ]; then
+  TASK_FILE=$(find docs/tasks/active -name "*{用户指定的关键词}*.md" | head -1)
+else
+  TASK_FILE=$(ls -t docs/tasks/active/*.md | head -1)  # 最新的
+fi
+
+# 2. 读取文档内容
+cat "$TASK_FILE"
+
+# 3. 提取关键信息并向用户确认
+TITLE=$(grep "^# 任务：" "$TASK_FILE" | sed 's/^# 任务：//')
+NEXT_STEPS=$(提取 "下一步操作" 部分)
+
+# 4. 输出恢复信息
+echo "正在恢复任务：$TITLE"
+echo "下一步操作："
+echo "$NEXT_STEPS"
+```
+
+### 5. 归档任务
+
+**触发**：用户说"任务完成"、"归档任务"
+
+**步骤**：
+```bash
+# 1. 更新状态
+sed -i "s/^\*\*状态\*\*:.*/\*\*状态\*\*: 🔵 已完成/" "$TASK_FILE"
+
+# 2. 移动到归档目录
+YEAR_MONTH=$(date +%Y-%m)
+mkdir -p "docs/tasks/archive/$YEAR_MONTH"
+mv "$TASK_FILE" "docs/tasks/archive/$YEAR_MONTH/"
+
+echo "✅ 已归档到: docs/tasks/archive/$YEAR_MONTH/"
+```
+
+## 使用示例
+
+**场景1：创建任务**
+```
+用户: "创建一个用户反馈功能的任务跟踪"
+
+Claude:
+✅ 创建文档: docs/tasks/active/task-20260121-153045-用户反馈.md
+📋 已记录需求描述
+🎯 列出5个实现步骤
+💡 开始第一步：设计数据库表结构
+```
+
+**场景2：更新进度**
+```
+用户: "标记步骤1和2完成"
+
+Claude:
+✅ 已更新进度: 2/5 (40%)
+⏰ 更新时间: 2026-01-21 16:45:30
+📌 下一步: 实现 Service 层
+```
+
+**场景3：恢复任务**
+```
+[用户重新打开窗口]
+用户: "继续上次的用户反馈功能"
+
+Claude:
+📄 正在恢复任务：用户反馈管理功能
+✅ 已完成: 数据库设计、实体类创建 (2/5)
+📌 下一步: 实现 Service 层
+🔗 文件: docs/tasks/active/task-20260121-153045-用户反馈.md
+```
+
+## 最佳实践
+
+**应该做**：
+- ✅ 一个任务 = 一个完整功能开发
+- ✅ 及时更新进度（完成一步更新一次）
+- ✅ 详细记录关键决策
+- ✅ 保留原始需求描述
+
+**不应该做**：
+- ❌ 为每个小改动创建任务
+- ❌ 删除旧任务（归档即可）
+- ❌ 自动归档（由用户决定）
+
+## 错误处理
+
+**目录不存在** → 自动创建 `docs/tasks/active` 和 `archive`
+
+**没有活跃任务** → 提示用户：创建新任务 | 恢复归档任务 | 查看历史
+
+**文档格式错误** → 尽量解析，提示用户保持格式：
+- 保持 `##` 标题层级
+- 复选框格式：`- [ ]` 或 `- [x]`
+- 不删除 `**字段**` 标记
+
+## 功能边界
+
+**适用于**：单人开发、本地存储、快速恢复上下文
+
+**不适用于**：多人协作、实时同步、复杂依赖管理（请使用专业项目管理工具）