ai-engineering-init 1.1.0

package/.claude/docs//346/241/206/346/236/266/350/257/264/346/230/216.md

@@ -0,0 +1,393 @@
+# RuoYi-Vue-Plus 框架说明
+
+> 本文档说明框架已完成的模块和业务开发区域。
+> **注意**：本项目是纯后端项目，前端项目独立维护。
+
+最后更新: 2026-02-09
+
+---
+
+## 📦 框架已完成模块（无需开发）
+
+### 后端框架模块
+
+#### 1. ruoyi-common（通用工具库 - 24个子模块）
+
+| 模块 | 功能说明 |
+|------|---------|
+| ruoyi-common-bom | BOM 依赖版本管理 |
+| ruoyi-common-core | 核心工具类、常量、异常处理、MapstructUtils |
+| ruoyi-common-mybatis | MyBatis-Plus 增强、BaseMapperPlus、分页、数据权限 |
+| ruoyi-common-redis | Redis 缓存封装、RedisUtils、分布式锁 |
+| ruoyi-common-satoken | Sa-Token 认证授权、LoginHelper |
+| ruoyi-common-security | 安全组件 |
+| ruoyi-common-tenant | 多租户支持、TenantEntity、TenantHelper |
+| ruoyi-common-web | Web 配置、全局异常处理、BaseController |
+| ruoyi-common-json | JSON 序列化配置 |
+| ruoyi-common-excel | Excel 导入导出（FastExcel） |
+| ruoyi-common-doc | SpringDoc/OpenAPI 接口文档 |
+| ruoyi-common-oss | 对象存储（S3 协议、MinIO、阿里云等） |
+| ruoyi-common-sms | 短信服务（SMS4j） |
+| ruoyi-common-mail | 邮件服务 |
+| ruoyi-common-social | 社交登录（JustAuth） |
+| ruoyi-common-websocket | WebSocket 支持 |
+| ruoyi-common-sse | SSE 服务端推送 |
+| ruoyi-common-job | 定时任务（SnailJob） |
+| ruoyi-common-idempotent | 幂等性控制 |
+| ruoyi-common-ratelimiter | 限流控制 |
+| ruoyi-common-encrypt | 数据加密注解 |
+| ruoyi-common-sensitive | 敏感字段脱敏 |
+| ruoyi-common-log | 操作日志 |
+| ruoyi-common-translation | 翻译/国际化 |
+
+#### 2. ruoyi-modules/ruoyi-system（系统管理）
+
+**监控模块 (monitor)**：
+
+| Controller | 功能说明 |
+|-----------|---------|
+| CacheController | 缓存监控、Redis Key 管理 |
+| SysLogininforController | 登录日志、IP归属地 |
+| SysOperlogController | 操作日志记录 |
+| SysUserOnlineController | 在线用户监控、强制下线 |
+
+**系统模块 (system)**：
+
+| Controller | 功能说明 |
+|-----------|---------|
+| SysUserController | 用户管理、分配角色、重置密码 |
+| SysRoleController | 角色管理、权限分配、数据权限 |
+| SysMenuController | 菜单管理、按钮权限、路由配置 |
+| SysDeptController | 部门管理、树形结构 |
+| SysPostController | 岗位管理 |
+| SysDictTypeController | 字典类型管理 |
+| SysDictDataController | 字典数据管理 |
+| SysConfigController | 系统参数配置 |
+| SysNoticeController | 通知公告 |
+| SysProfileController | 个人中心 |
+| SysTenantController | 租户管理 |
+| SysTenantPackageController | 租户套餐、菜单权限 |
+| SysClientController | OAuth2 客户端管理 |
+| SysOssController | OSS 文件管理 |
+| SysOssConfigController | OSS 配置管理 |
+| SysSocialController | 社会化登录管理 |
+
+#### 3. ruoyi-modules/ruoyi-generator（代码生成器）
+
+- 数据库表导入
+- 代码生成配置
+- 一键生成 CRUD 代码（Entity、BO、VO、Controller、Service、Mapper）
+- 生成菜单 SQL
+- 支持单表、树表、主子表
+
+#### 4. ruoyi-modules/ruoyi-demo（演示模块）
+
+- 功能演示示例
+- 代码参考模板
+- 表前缀：`test_`
+
+#### 5. ruoyi-modules/ruoyi-job（定时任务模块）
+
+- SnailJob 任务调度
+- 分布式任务管理
+- 失败重试、工作流编排
+
+#### 6. ruoyi-modules/ruoyi-workflow（工作流模块）
+
+- WarmFlow 工作流引擎
+- 流程定义与管理
+- 审批流程、任务办理
+- 表前缀：`flow_`
+
+#### 7. ruoyi-admin（启动入口）
+
+- Spring Boot 启动类
+- 配置文件管理（application.yml、application-dev.yml）
+- 不包含业务逻辑
+
+---
+
+## 🏗️ 核心架构规范
+
+### 三层架构（无 DAO 层）
+
+```
+Controller → Service → Mapper
+     ↓           ↓         ↓
+  接收请求    业务逻辑    数据访问
+  参数校验    查询构建    MyBatis-Plus
+```
+
+**关键点**：
+- Service 实现类**不继承任何基类**，直接注入 Mapper
+- `buildQueryWrapper()` 方法在 **Service 实现类**中
+- Mapper 接口继承 `BaseMapperPlus<Entity, Vo>`
+
+### 包名规范
+
+**必须使用 `org.dromara.*`**，禁止使用 `com.ruoyi.*`
+
+```java
+// ✅ 正确
+package org.dromara.system.controller.system;
+package org.dromara.demo.service.impl;
+
+// ❌ 错误
+package com.ruoyi.system.controller;  // 禁止！
+```
+
+### 模块与表前缀对应
+
+| 模块 | 目录路径 | 包路径 | 表前缀 |
+|------|---------|--------|--------|
+| **系统管理** | `ruoyi-modules/ruoyi-system/` | `org.dromara.system` | `sys_` |
+| **演示模块** | `ruoyi-modules/ruoyi-demo/` | `org.dromara.demo` | `test_` |
+| **工作流** | `ruoyi-modules/ruoyi-workflow/` | `org.dromara.workflow` | `flow_` |
+| **定时任务** | `ruoyi-modules/ruoyi-job/` | `org.dromara.job` | `sj_` |
+| **自定义业务** | `ruoyi-modules/ruoyi-xxx/` | `org.dromara.xxx` | `xxx_` |
+
+---
+
+## 🎯 业务开发区域（需要开发的地方）
+
+### 后端业务模块位置
+
+```
+ruoyi-modules/
+├── ruoyi-system/          ❌ 框架模块（不要修改）
+├── ruoyi-generator/       ❌ 框架模块（不要修改）
+├── ruoyi-demo/            ⚠️ 演示模块（可参考，不建议直接修改）
+├── ruoyi-job/             ❌ 框架模块（不要修改）
+├── ruoyi-workflow/        ❌ 框架模块（不要修改）
+└── ruoyi-{你的业务}/      ✅ 创建你的业务模块
+```
+
+### 创建业务模块的标准结构
+
+```
+ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/
+├── controller/
+│   └── XxxController.java          # @RestController, extends BaseController
+├── service/
+│   ├── IXxxService.java            # 服务接口
+│   └── impl/
+│       └── XxxServiceImpl.java     # 服务实现（包含 buildQueryWrapper）
+├── mapper/
+│   └── XxxMapper.java              # extends BaseMapperPlus<Xxx, XxxVo>
+└── domain/
+    ├── Xxx.java                    # Entity（extends TenantEntity）
+    ├── bo/
+    │   └── XxxBo.java              # 业务对象（@AutoMapper）
+    └── vo/
+        └── XxxVo.java              # 视图对象
+```
+
+### 标准代码示例
+
+**Entity 示例**：
+
+```java
+@Data
+@TableName("m_order")
+public class Order extends TenantEntity {
+    @TableId(value = "id")
+    private Long id;
+    private String orderNo;
+    private Integer status;
+    // 其他业务字段...
+}
+```
+
+**BO 示例**：
+
+```java
+@Data
+@AutoMapper(target = Order.class, reverseConvertGenerate = false)
+public class OrderBo extends BaseEntity {
+    private Long id;
+    private String orderNo;
+    private Integer status;
+}
+```
+
+**Service 实现示例**：
+
+```java
+@Service
+public class OrderServiceImpl implements IOrderService {
+
+    private final OrderMapper baseMapper;  // 直接注入 Mapper
+
+    /**
+     * 构建查询条件（在 Service 层）
+     */
+    private LambdaQueryWrapper<Order> buildQueryWrapper(OrderBo bo) {
+        LambdaQueryWrapper<Order> lqw = Wrappers.lambdaQuery();
+        lqw.eq(StringUtils.isNotBlank(bo.getOrderNo()), Order::getOrderNo, bo.getOrderNo());
+        lqw.eq(bo.getStatus() != null, Order::getStatus, bo.getStatus());
+        return lqw;
+    }
+
+    @Override
+    public TableDataInfo<OrderVo> queryPageList(OrderBo bo, PageQuery pageQuery) {
+        LambdaQueryWrapper<Order> lqw = buildQueryWrapper(bo);
+        Page<OrderVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
+        return TableDataInfo.build(result);
+    }
+}
+```
+
+**Controller 示例**：
+
+```java
+@RestController
+@RequestMapping("/mall/order")
+public class OrderController extends BaseController {
+
+    private final IOrderService orderService;
+
+    @GetMapping("/list")
+    public TableDataInfo<OrderVo> list(OrderBo bo, PageQuery pageQuery) {
+        return orderService.queryPageList(bo, pageQuery);
+    }
+
+    @GetMapping("/{id}")
+    public R<OrderVo> getInfo(@PathVariable Long id) {
+        return R.ok(orderService.queryById(id));
+    }
+
+    @PostMapping
+    public R<Void> add(@RequestBody OrderBo bo) {
+        return toAjax(orderService.insertByBo(bo));
+    }
+
+    @PutMapping
+    public R<Void> edit(@RequestBody OrderBo bo) {
+        return toAjax(orderService.updateByBo(bo));
+    }
+
+    @DeleteMapping("/{ids}")
+    public R<Void> remove(@PathVariable Long[] ids) {
+        return toAjax(orderService.deleteByIds(Arrays.asList(ids)));
+    }
+}
+```
+
+---
+
+## 📏 进度统计规则
+
+### 核心原则：使用排除法（黑名单）
+
+**为什么用排除法？**
+- ✅ **灵活**：用户可以创建任意名称的业务目录
+- ✅ **准确**：不会遗漏用户的自定义业务模块
+- ✅ **简单**：只需维护一个小的框架模块排除列表
+
+### 只统计业务模块
+
+**后端**：
+- ✅ 统计：`ruoyi-modules/ruoyi-*`（排除 ruoyi-system、ruoyi-generator、ruoyi-demo、ruoyi-job、ruoyi-workflow）
+- ❌ 不统计：ruoyi-common、ruoyi-admin、ruoyi-system、ruoyi-generator、ruoyi-demo、ruoyi-job、ruoyi-workflow
+
+---
+
+## 🚀 快速开始
+
+### 1. 查看框架状态
+
+```bash
+/start
+```
+
+### 2. 开发第一个业务功能
+
+**方式 1：使用 /dev 命令**
+
+```bash
+/dev
+```
+
+Claude 会引导你完成：
+- 需求分析
+- 数据库设计
+- 后端代码生成
+
+**方式 2：使用 /crud 命令（快速生成标准CRUD）**
+
+```bash
+/crud
+```
+
+**方式 3：使用代码生成器**
+
+1. 设计数据库表
+2. 访问代码生成器页面
+3. 导入表、配置生成选项
+4. 一键生成代码
+
+### 3. 查看业务进度
+
+```bash
+/progress
+```
+
+---
+
+## 📚 相关文档
+
+- **开发规范**：`CLAUDE.md` - 完整的开发规范和架构说明
+- **技能库**：`.claude/skills/` - 各功能开发指南
+
+---
+
+## 💡 常见问题
+
+### Q1: 我可以修改框架模块的代码吗？
+
+**不建议**。框架模块是通用功能，修改后升级框架会有冲突。如果需要扩展，建议：
+- 继承框架类并重写
+- 在业务模块中封装
+- 通过配置文件调整行为
+
+### Q2: 为什么项目没有 DAO 层？
+
+本项目采用三层架构（Controller → Service → Mapper），Service 直接注入 Mapper，没有独立的 DAO 层。这样做的好处是：
+- 更简洁、更少的样板代码
+- 避免过度分层
+- MyBatis-Plus 已提供足够的数据访问抽象
+
+### Q3: buildQueryWrapper 应该放在哪里？
+
+**放在 Service 实现类中**，不是 Controller，也不是单独的 DAO 层。
+
+### Q4: 代码生成器生成的代码是业务代码吗？
+
+**是的**。代码生成器根据你的业务表生成代码，属于业务代码，会放到你指定的业务模块中。
+
+### Q5: 为什么执行 /progress 显示 0%？
+
+因为你还没有开发任何业务模块。框架模块不参与进度统计。
+
+---
+
+## 🎯 总结
+
+| 类型 | 框架模块（已完成） | 业务模块（需要开发） |
+|------|------------------|-------------------|
+| 通用工具 | ruoyi-common（24个子模块） | - |
+| 启动入口 | ruoyi-admin | - |
+| 系统管理 | ruoyi-modules/ruoyi-system | - |
+| 代码生成 | ruoyi-modules/ruoyi-generator | - |
+| 演示模块 | ruoyi-modules/ruoyi-demo | - |
+| 定时任务 | ruoyi-modules/ruoyi-job | - |
+| 工作流 | ruoyi-modules/ruoyi-workflow | - |
+| 业务模块 | - | ruoyi-modules/ruoyi-{你的业务}/ |
+| 统计进度 | ❌ 不统计 | ✅ 只统计业务模块 |
+
+**记住**：
+- 框架 = 已完成的通用功能
+- 业务 = 你要开发的项目功能
+- 包名必须是 `org.dromara.*`
+- 三层架构：Controller → Service → Mapper（无 DAO 层）
+- 进度统计只看业务，不看框架

package/.claude/docs//350/267/257/347/224/261/351/205/215/347/275/256/346/214/207/345/215/227.md

@@ -0,0 +1,246 @@
+# 路由配置指南
+
+> **适用于**: 腾云智慧食堂管理系统前端项目（`/Users/xujiajun/Developer/frontProj/web`）
+
+最后更新: 2026-02-18
+
+---
+
+## 路由文件结构
+
+```
+src/router/
+├── index.js            # 路由入口：创建路由实例、全局前置守卫
+├── static-routers.js   # 静态路由：不需要权限的页面（登录、404、大屏等）
+├── business-routers.js # 业务路由：商户管理相关页面
+└── campus-routers.js   # 园区路由：园区相关页面
+```
+
+`src/permission.js` — 全局路由守卫（登录、权限、动态路由加载）
+
+---
+
+## 静态路由 (static-routers.js)
+
+不需要登录权限的页面配置在这里，每条路由都设置 `hidden: true`（不在侧边栏显示）：
+
+```javascript
+// src/router/static-routers.js
+import Layout from '@/layout'
+
+export default [
+  {
+    path: '/login',
+    name: 'login',
+    // ⭐ 懒加载规范：使用 webpackChunkName 注释
+    component: () => import(/* webpackChunkName: "login" */ '@/leniuview/login/index'),
+    hidden: true
+  },
+  {
+    path: '/404',
+    name: '404',
+    component: () => import(/* webpackChunkName: "404" */ '@/leniuview/error/404'),
+    hidden: true
+  },
+  // 有 Layout 框架、但不在菜单显示的页面
+  {
+    path: '',
+    component: Layout,
+    hidden: true,
+    meta: {
+      title: '首页',
+      icon: 'home'
+    }
+  }
+]
+```
+
+---
+
+## 业务路由 (business-routers.js)
+
+有 Layout 框架、需要权限的业务页面，组织为父子路由结构：
+
+```javascript
+// src/router/business-routers.js
+import Layout from '@/layout'
+import LayoutView from '@/layout/layout'  // 嵌套路由时使用
+
+export default {
+  path: '/initialized',
+  component: Layout,      // 使用主布局
+  redirect: 'noRedirect',
+  name: '商户',
+  meta: {
+    title: '商户',
+    icon: 'component'
+  },
+  children: [
+    {
+      path: 'initial',
+      // ⭐ 懒加载：webpackChunkName 与 name 保持一致
+      component: () => import(/* webpackChunkName: "initial" */ '@/leniuview/Business/initialized'),
+      name: '商户注册',
+      meta: {
+        title: '商户注册',
+        redirect: 'audit'
+      }
+    },
+    {
+      path: 'initializedList',
+      component: () => import(/* webpackChunkName: "initializedList" */ '@/leniuview/Business/initializedList'),
+      name: '商户审核',
+      meta: {
+        title: '商户审核',
+        noCache: true       // 不缓存该页面
+      }
+    }
+  ]
+}
+```
+
+---
+
+## 懒加载规范
+
+```javascript
+// ✅ 正确：使用 webpackChunkName 注释
+component: () => import(/* webpackChunkName: "moduleName" */ '@/leniuview/xxx/index')
+
+// ✅ webpackChunkName 命名建议与路由 name 保持一致
+{
+  path: 'priceRule',
+  name: 'priceRule',
+  component: () => import(/* webpackChunkName: "priceRule" */ '@/leniuview/marketing/priceRule/index')
+}
+
+// ❌ 不推荐：不加 webpackChunkName（影响分包优化）
+component: () => import('@/leniuview/xxx/index')
+```
+
+---
+
+## meta 字段说明
+
+| 字段 | 类型 | 说明 | 示例 |
+|------|------|------|------|
+| `title` | String | 页面标题（显示在浏览器标签和面包屑） | `'营销规则管理'` |
+| `icon` | String | 菜单图标名称 | `'component'` |
+| `noCache` | Boolean | 是否禁用页面缓存（`<keep-alive>`）默认缓存 | `true` |
+| `hidden` | Boolean | 是否在侧边菜单中隐藏 | `true` |
+| `redirect` | String | 重定向目标 | `'audit'` |
+| `affix` | Boolean | 是否固定在 tab 栏（不可关闭） | `true` |
+
+---
+
+## 权限路由控制流程
+
+`permission.js` 中的全局前置守卫流程：
+
+```
+用户访问页面
+    ↓
+有 Token?
+    ├── 否 → 是白名单页面? → 是 → 直接访问
+    │                      → 否 → 跳转 /login
+    └── 是 → 已加载用户角色?
+              ├── 是 → 直接 next()
+              └── 否 → 调用 store.dispatch('user/getInfo')
+                            ↓
+                        根据角色加载动态路由
+                        store.dispatch('permission/generateRoutes', roles)
+                            ↓
+                        router.addRoutes(accessedRoutes)
+                            ↓
+                        next({ ...to, replace: true })
+```
+
+### 白名单页面（无需登录）
+
+```javascript
+// src/permission.js
+const whiteList = [
+  '/login',
+  '/ssoLogin',
+  '/openLogin',
+  '/404',
+  '/registeredCompany',
+  '/registeredCompanyLinS',
+  '/resetPassword',
+  '/registerSupplier',
+  '/cooperativePartner',
+  '/dataHunter_user',
+  '/dataHunter_back',
+  '/dataHunter_merchant',
+  '/backCustomScreen'
+]
+```
+
+---
+
+## 新增路由步骤
+
+### 1. 不需要权限的页面（静态路由）
+
+在 `static-routers.js` 中添加：
+
+```javascript
+{
+  path: '/myPage',
+  name: 'myPage',
+  component: () => import(/* webpackChunkName: "myPage" */ '@/leniuview/myModule/index'),
+  hidden: true
+}
+```
+
+### 2. 需要权限的业务页面（业务路由）
+
+在对应的业务路由文件（如 `business-routers.js`）的 `children` 中添加：
+
+```javascript
+{
+  path: 'myFeature',
+  component: () => import(/* webpackChunkName: "myFeature" */ '@/leniuview/Business/myFeature/index'),
+  name: '我的功能',
+  meta: {
+    title: '我的功能',
+    noCache: true
+  }
+}
+```
+
+### 3. 动态权限路由
+
+从后端接口获取用户有权限的菜单，由 Vuex `permission` 模块动态生成路由，无需手动添加。
+
+---
+
+## 路由实例管理
+
+```javascript
+// src/router/index.js
+import { resetRouter } from '@/router'
+
+// 登出时重置路由（清除动态添加的权限路由）
+resetRouter()
+```
+
+---
+
+## 常见问题
+
+### 重复点击相同路由报错
+
+已在 `router/index.js` 中全局处理，忽略 `NavigationDuplicated` 错误，无需每个页面单独处理。
+
+### 页面不缓存
+
+在路由 meta 中添加 `noCache: true`，同时确保组件有 `name` 属性（`keep-alive` 按组件 name 缓存）。
+
+### 检查当前用户是否有某页面权限
+
+```javascript
+import { checkMenu } from '@/utils/auth'
+
+const hasAccess = checkMenu('/marketing/price')
+```

package/.claude/framework-config.json

@@ -0,0 +1,73 @@
+{
+  "framework": {
+    "description": "框架模块配置 - 这些模块是框架的一部分，不参与业务进度统计",
+    "backend": {
+      "modules": [
+        "ruoyi-common",
+        "ruoyi-admin"
+      ],
+      "systemModules": [
+        "ruoyi-modules/ruoyi-system",
+        "ruoyi-modules/ruoyi-generator"
+      ],
+      "description": "后端框架模块，包含通用工具、系统管理、代码生成器等"
+    },
+    "systemFeatures": [
+      "用户管理",
+      "角色管理",
+      "菜单管理",
+      "部门管理",
+      "岗位管理",
+      "字典管理",
+      "参数配置",
+      "通知公告",
+      "操作日志",
+      "登录日志",
+      "在线用户",
+      "定时任务",
+      "代码生成器",
+      "租户管理",
+      "租户套餐",
+      "客户端管理",
+      "OSS配置",
+      "OSS对象存储"
+    ]
+  },
+  "business": {
+    "description": "业务模块配置 - 这些是需要统计进度的业务代码",
+    "backend": {
+      "modulePattern": "ruoyi-modules/ruoyi-*",
+      "excludeModules": [
+        "ruoyi-modules/ruoyi-system",
+        "ruoyi-modules/ruoyi-generator",
+        "ruoyi-modules/ruoyi-demo",
+        "ruoyi-modules/ruoyi-job",
+        "ruoyi-modules/ruoyi-workflow"
+      ],
+      "description": "业务模块位于 ruoyi-modules/ 下，以 ruoyi- 开头但不包括框架自带模块（system、generator、demo、job、workflow）"
+    }
+  },
+  "scanRules": {
+    "backend": {
+      "requiredFiles": [
+        "Entity (domain/*.java)",
+        "BO (domain/bo/*Bo.java)",
+        "VO (domain/vo/*Vo.java)",
+        "Controller (*Controller.java)",
+        "Service (I*Service.java)",
+        "ServiceImpl (impl/*ServiceImpl.java)",
+        "Mapper (*Mapper.java)"
+      ],
+      "completenessFormula": "存在文件数 / 7 * 100%"
+    },
+    "todoPatterns": [
+      "TODO:",
+      "FIXME:",
+      "XXX:",
+      "HACK:",
+      "NOTE:"
+    ]
+  },
+  "version": "1.0.0",
+  "lastUpdated": "2026-01-24"
+}