leniu-dev 2.0.0

package/.claude/commands/start.md

@@ -0,0 +1,199 @@
+# /start - 项目快速了解
+
+新成员快速了解 leniu-tengyun-core（云食堂）项目的必看命令。
+
+---
+
+## 适用场景
+
+| 场景 | 说明 |
+|------|------|
+| **初次接触** | 新成员第一次接触项目 |
+| **项目交接** | 接手他人的项目 |
+| **重新梳理** | 距上次熟悉项目已久，需快速回顾 |
+| **窗口切换** | 在新的 Claude 会话中快速了解项目 |
+
+---
+
+## 执行流程
+
+### 第一步：扫描项目结构
+
+```bash
+# 扫描业务模块 Controller
+Glob pattern: "sys-canteen/src/main/java/net/xnzn/core/**/controller/*Controller.java"
+Glob pattern: "sys-kitchen/src/main/java/net/xnzn/core/**/controller/*Controller.java"
+Glob pattern: "sys-drp/src/main/java/net/xnzn/core/**/controller/*Controller.java"
+
+# 查看最近 3 条 Git 提交
+git log -3 --oneline
+```
+
+### 第二步：识别 leniu 模块结构
+
+**核心业务模块（统计进度）**：
+
+| 模块 | 说明 | 包名 |
+|------|------|------|
+| `sys-canteen` | 食堂业务（订单、菜品、用户）| `net.xnzn.core.canteen` |
+| `sys-kitchen` | 后场厨房（备餐、出餐、排班）| `net.xnzn.core.kitchen` |
+| `sys-drp` | 供应链（采购、库存、配送）| `net.xnzn.core.drp` |
+| `sys-common` | 公共业务（支付、通知、对接）| `net.xnzn.core.common` |
+
+**基础设施模块（不统计进度）**：
+- `core-base` - 公共配置、工具类
+- `core-aggregator` - 聚合器
+- `sys-open` - 开放接口模块
+- `sys-logistics` - 物流模块
+
+### 第三步：判断项目开发阶段
+
+```
+Controller 数量 = 0    → 全新项目
+Controller 数量 1-20   → 初期开发
+Controller 数量 21+    → 成熟项目
+```
+
+### 第四步：检查文档状态
+
+```bash
+Glob pattern: "docs/*.md"
+```
+
+---
+
+## 输出格式
+
+### 情况一：全新项目
+
+```markdown
+# 欢迎使用 leniu-tengyun-core（云食堂）
+
+**技术栈**：Spring Boot 3.x + pigx-framework + MyBatis-Plus + JDK 21
+**架构**：四层架构（Controller → Business → Service → Mapper）
+**双库**：系统库（全局配置）+ 商户库（租户业务数据）
+
+## 框架现状
+
+### 核心特性
+- 双库物理隔离（无 tenant_id 字段，通过请求头 MERCHANT-ID 路由）
+- JDK 21 + jakarta.validation.*
+- PageHelper 分页 + LeRequest<T> 请求封装
+- LeException 业务异常 + I18n 国际化
+
+## 快速开始
+
+1. 了解规范：查看 CLAUDE.md
+2. 初始化文档：/init-docs
+3. 开始开发：/dev 或 /crud
+```
+
+### 情况二：开发中项目
+
+```markdown
+# 欢迎回到 leniu-tengyun-core
+
+**项目阶段**：开发中
+**技术栈**：Spring Boot 3.x + JDK 21 + pigx-framework
+
+## 模块进度
+
+| 模块 | Controller 数 | 说明 |
+|------|--------------|------|
+| sys-canteen | X | 食堂业务 |
+| sys-kitchen | X | 后场厨房 |
+| sys-drp | X | 供应链 |
+
+## 最近提交
+
+[显示最近 3 条 git commit]
+
+## 代码质量速查
+
+| 检查项 | 状态 |
+|--------|------|
+| 包名 (net.xnzn.core.*) | ✅/⚠️ |
+| 审计字段 (crby/crtime) | ✅/⚠️ |
+| 认证注解 (@RequiresAuthentication) | ✅/⚠️ |
+
+## 建议操作
+
+```bash
+/progress    # 查看详细进度
+/check       # 检查代码规范
+/next        # 获取下一步建议
+```
+```
+
+### 第五步：文档建议
+
+若 `docs/` 目录不存在：
+
+```markdown
+## 建议
+
+检测到业务代码，但尚未初始化项目文档。
+
+执行 /init-docs 初始化：
+- 项目状态.md - 进度追踪
+- 需求文档.md - 业务需求
+- 待办清单.md - 任务清单
+```
+
+---
+
+## 新成员入门清单
+
+- [ ] 阅读 `CLAUDE.md` 了解 leniu 开发规范
+- [ ] 运行 `/start` 了解项目现状
+- [ ] 运行 `/progress` 查看详细进度
+- [ ] 了解双库架构（系统库 vs 商户库）
+- [ ] 了解四层架构（Controller → Business → Service → Mapper）
+- [ ] 根据 `/next` 建议选择任务
+
+---
+
+## 核心命令速览
+
+```bash
+/start          # 项目概览（当前命令）
+/progress       # 详细进度
+/check          # 代码规范检查
+/dev            # 开发新功能（含表设计）
+/crud           # 快速生成 CRUD（表已存在）
+/next           # 获取建议
+/sync           # 全量同步
+/init-docs      # 初始化文档
+/add-todo       # 添加待办
+```
+
+---
+
+## 常见问题
+
+### Q: leniu 架构和 RuoYi-Vue-Plus 有什么区别？
+
+| 对比 | RuoYi-Vue-Plus | leniu-tengyun-core |
+|------|----------------|-------------------|
+| 包名 | `org.dromara.*` | `net.xnzn.core.*` |
+| 租户 | 单库 `tenant_id` 字段 | 双库物理隔离 |
+| 审计字段 | createBy/createTime | crby/crtime |
+| del_flag | 0=正常 | 2=正常 |
+| 请求封装 | BO | LeRequest<T> |
+| 权限注解 | @SaCheckPermission | @RequiresAuthentication |
+| 异常 | ServiceException | LeException |
+| 多了一层 | 三层 | 四层（多 Business 层）|
+
+### Q: 怎么开发新功能？
+
+```bash
+/dev  # 含表结构设计的完整开发向导
+/crud # 表已存在时快速生成代码
+```
+
+### Q: 怎么追踪进度？
+
+```bash
+/progress  # 查看完成情况
+/sync      # 生成完整报告
+```

package/.claude/commands/sync.md

@@ -0,0 +1,307 @@
+# /sync - 项目代码状态同步
+
+一键同步后端代码状态、生成项目文档、确保代码与文档数据一致。适合定期整理或发现数据不一致时使用。
+
+---
+
+## 适用场景
+
+| 场景 | 说明 |
+|------|------|
+| **定期整理** | 每周末整理项目代码状态和文档 |
+| **数据不一致** | 手动修改过代码或文档后需要重新同步 |
+| **项目交接** | 新成员加入或项目交接时全量检查 |
+| **构建报告** | 生成完整的项目状态报告供管理者查看 |
+| **代码审查** | 代码审查前同步确保信息完整准确 |
+
+---
+
+## 执行流程
+
+### 第一步：扫描后端代码状态（强制执行）
+
+#### 1.1 扫描业务模块和功能完整性
+
+```bash
+# 查找核心业务模块的 Controller
+Glob pattern: "sys-canteen/src/main/java/**/controller/*Controller.java"
+Glob pattern: "sys-kitchen/src/main/java/**/controller/*Controller.java"
+Glob pattern: "sys-drp/src/main/java/**/controller/*Controller.java"
+Glob pattern: "sys-common/src/main/java/**/controller/*Controller.java"
+
+# 基础设施模块（不统计）：core-base、core-aggregator、sys-open、sys-logistics
+```
+
+对每个功能检查 **8 个必需的文件**（leniu 四层架构）：
+
+| 类型 | 文件 | 完整路径 | 必须 |
+|------|------|---------|------|
+| Entity | `XxxInfo.java` | `common/model/XxxInfo.java` | ✅ |
+| DTO | `XxxInfoDTO.java` | `web/dto/XxxInfoDTO.java` | ✅ |
+| VO | `XxxInfoVO.java` | `web/vo/XxxInfoVO.java` | ✅ |
+| Mapper | `XxxInfoMapper.java` | `common/mapper/XxxInfoMapper.java` | ✅ |
+| MapperXML | `XxxInfoMapper.xml` | `common/mapper/XxxInfoMapper.xml` | ✅ |
+| Service | `XxxInfoService.java` | `common/service/impl/XxxInfoService.java` | ✅ |
+| Business | `XxxWebBusiness.java` | `web/business/impl/XxxWebBusiness.java` | ✅ |
+| Controller | `XxxWebController.java` | `web/controller/XxxWebController.java` | ✅ |
+
+#### 1.2 扫描代码规范问题
+
+```bash
+# 检查包名问题
+Grep pattern: "package org\.dromara\.|package com\.ruoyi\." path: sys-canteen/,sys-kitchen/,sys-drp/ output_mode: files_with_matches
+
+# 检查禁止使用的工具类
+Grep pattern: "MapstructUtils|ServiceException" path: sys-canteen/,sys-kitchen/,sys-drp/ glob: "*.java" output_mode: files_with_matches
+
+# 检查审计字段命名
+Grep pattern: "private.*createBy|private.*updateBy|private.*createTime|private.*updateTime" path: sys-canteen/,sys-kitchen/,sys-drp/ glob: "*.java" output_mode: files_with_matches
+
+# 检查 del_flag 错误值
+Grep pattern: "delFlag.*=.*0\b|del_flag.*=.*0\b" path: sys-canteen/,sys-kitchen/,sys-drp/ glob: "*.java" output_mode: files_with_matches
+
+# 检查权限注解
+Grep pattern: "@RequiresAuthentication|@RequiresGuest" path: sys-canteen/,sys-kitchen/,sys-drp/ glob: "*Controller.java" output_mode: files_with_matches
+```
+
+#### 1.3 扫描 Git 提交记录
+
+```bash
+# 获取最近 30 条提交
+git log -30 --oneline --format="%h %s %ad" --date=short
+
+# 统计业务相关提交（feat/fix/update/add/refactor）
+```
+
+#### 1.4 扫描 TODO/FIXME 标记
+
+```bash
+# 扫描所有业务代码中的待办标记
+Grep pattern: "TODO:|FIXME:|XXX:" path: sys-canteen/,sys-kitchen/,sys-drp/,sys-common/ glob: "*.java" output_mode: content -B 1
+```
+
+#### 1.5 生成代码扫描结果
+
+**输出格式**：
+```markdown
+## 代码扫描结果
+
+### 模块完整性分析
+| 模块 | 功能数 | 完成数 | 完成率 | 状态 |
+|------|--------|--------|--------|------|
+| sys-canteen | X | X | XX% | [状态] |
+| sys-kitchen | X | X | XX% | [状态] |
+| sys-drp | X | X | XX% | [状态] |
+| sys-common | X | X | XX% | [状态] |
+
+### 代码规范检查
+| 检查项 | 通过 | 警告 | 错误 |
+|--------|------|------|------|
+| 包名规范 (net.xnzn.core.*) | ✅ | 0 | 0 |
+| 权限注解完整度 | ⚠️ | 2 | 0 |
+| 审计字段规范 | ✅ | 0 | 0 |
+| del_flag 值语义 | ✅ | 0 | 0 |
+
+### 待办统计
+- 🔥 FIXME (高): X 项
+- 📌 TODO (中): X 项
+```
+
+---
+
+### 第二步：分析 Git 提交历史
+
+#### 2.1 最近提交分析
+
+```bash
+# 获取最近提交的功能信息
+git log -5 --oneline
+```
+
+**分析内容**：
+- 最近在做什么功能
+- 是否有 FIXME/BUG 相关的提交
+- 代码活跃度
+
+#### 2.2 功能交付记录
+
+根据 Git 提交历史：
+- 标记代码中完成的功能
+- 识别正在进行的功能
+- 统计本周/本月完成功能数
+
+---
+
+### 第三步：整合检查结果
+
+#### 3.1 与 `/check` 命令同步
+
+```bash
+# 如果最近没有运行过 /check，则执行全量检查
+/check
+
+# 提取检查结果中的：
+# - 严重问题数量
+# - 警告问题数量
+# - 需要修复的问题清单
+```
+
+#### 3.2 与 `/progress` 命令同步
+
+```bash
+# 获取项目进度信息
+/progress
+
+# 提取数据：
+# - 各模块完成率
+# - 待完成功能列表
+# - 代码质量评分
+```
+
+#### 3.3 生成综合分析
+
+**输出信息**：
+- 与上次同步相比的变化（新增/完成/修复）
+- 阻塞项（高优先级 FIXME 未修复）
+- 建议（基于 /next 的分析）
+
+---
+
+### 第四步：生成项目同步报告
+
+```markdown
+# 项目代码状态同步报告
+
+**同步时间**：YYYY-MM-DD HH:mm
+**上次同步**：YYYY-MM-DD（距今 X 天）
+
+---
+
+## 最新进展
+
+### Git 提交摘要
+- **最新提交**：[commit message] ([hash])
+- **最近 7 天**：X 次提交，涉及 X 个功能模块
+- **提交活跃度**：[活跃/正常/低活跃]
+
+### 代码完成度
+| 模块 | 功能数 | 完成 | 进行中 | 待开发 | 完成率 |
+|------|--------|------|--------|--------|---------|
+| sys-canteen | X | X | X | X | XX% |
+| sys-kitchen | X | X | X | X | XX% |
+| sys-drp | X | X | X | X | XX% |
+| sys-common | X | X | X | X | XX% |
+| **合计** | **X** | **X** | **X** | **X** | **XX%** |
+
+---
+
+## 紧急问题（必须立即处理）
+
+### 高优先级 FIXME
+| 文件 | 行号 | 问题 | 影响 |
+|------|------|------|------|
+| [文件名].java | [行号] | [问题描述] | [影响范围] |
+
+**处理建议**：
+/check [模块名]  # 查看详细问题
+/next             # 获取修复建议
+
+---
+
+## 代码规范检查结果
+
+### 总体评分
+| 维度 | 评分 | 说明 |
+|------|------|------|
+| 包名规范 | ✅ | 所有包名符合 net.xnzn.core.* 规范 |
+| 权限注解 | ⚠️ | 3 个接口缺少 @RequiresAuthentication |
+| 审计字段 | ✅ | 正确使用 crby/crtime/upby/uptime |
+| del_flag 语义 | ✅ | 正确使用 2=正常，1=删除 |
+| 对象转换 | ✅ | 正确使用 BeanUtil.copyProperties() |
+| 请求封装 | ⚠️ | 2 处 POST 接口未使用 LeRequest<T> |
+
+### 需要修复的问题
+1. **权限注解缺失**（X 项）
+   - [Controller文件名].java
+
+2. **LeRequest<T> 封装缺失**（X 项）
+   - [Controller文件名].java
+
+---
+
+## 待办事项更新
+
+### 新增待办（本次扫描发现）
+- [ ] [FIXME 描述]（高优先级）
+- [ ] [TODO 描述]（中优先级）
+
+### 本周完成的待办
+- [x] [已完成功能描述]
+
+### 当前进行中
+| 任务 | 优先级 | 进度 | 预计完成 |
+|------|--------|------|---------|
+| [任务描述] | [优先级] | XX% | [时间] |
+
+---
+
+## 与其他命令的协作
+
+### 工作流建议
+1. **日常开发** → `/update-status` 增量更新
+2. **每周末** → `/sync` 全量同步，生成报告
+3. **遇到问题** → `/check` 检查代码规范
+4. **规划工作** → `/progress` 查看进度，`/next` 获取建议
+5. **交接新人** → `/start` 快速了解，`/sync` 查看最新状态
+
+### 命令关系图
+```
+/start (快速了解)
+   ↓
+/crud or /dev (开发新功能)
+   ↓
+/check (检查规范)
+   ↓
+/sync (同步并生成报告) ← 您在这里
+   ↓
+/progress (查看进度)
+   ↓
+/next (获取建议)
+```
+
+---
+
+## 检查通过项
+
+- [x] 包名规范（net.xnzn.core.*）
+- [x] 对象转换（BeanUtil.copyProperties()）
+- [x] 审计字段正确（crby/crtime/upby/uptime）
+- [x] del_flag 语义正确（2=正常，1=删除）
+- [x] Mapper 继承正确（BaseMapper<Entity>）
+- [x] 无 tenant_id 字段（双库物理隔离）
+
+---
+
+## 同步说明
+
+- 本报告基于当前代码扫描、Git 提交和规范检查综合生成
+- 与 `/progress` 的区别：/progress 只读查看，/sync 生成综合报告
+- 与 `/check` 的关系：/check 检查代码规范，/sync 整合检查结果
+- 建议每周运行一次 `/sync` 命令进行定期整理
+- 发现数据不一致时立即运行 `/sync` 进行全量同步
+- 同步报告默认保存到 `docs/sync-report-YYYY-MM-DD.md`
+
+---
+
+## 相关命令
+
+| 命令 | 说明 | 何时使用 |
+|------|------|---------|
+| `/start` | 快速了解项目 | 初次接触项目 |
+| `/check` | 代码规范检查 | 开发完成后 |
+| `/progress` | 查看项目进度 | 了解完成情况 |
+| `/next` | 获取下一步建议 | 不知道做什么 |
+| `/sync` | 全量同步报告 | 每周整理、发现不一致 |
+| `/update-status` | 增量更新状态 | 日常使用 |
+| `/dev` | 开发新功能 | 从零开始 |
+| `/crud` | 快速生成代码 | 表已存在时 |