leniu-dev 2.0.0

package/.claude/commands/opsx-verify.md

@@ -0,0 +1,159 @@
+# /opsx-verify - 验证 OpenSpec 变更
+
+Verify that an implementation matches the change artifacts (specs, tasks, design).
+
+**Input**: Optionally specify a change name. If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
+
+**Steps**
+
+1. **If no change name provided, prompt for selection**
+
+   Run `openspec list --json` to get available changes. Use the **AskUserQuestion tool** to let the user select.
+
+   Show changes that have implementation tasks (tasks artifact exists).
+   Include the schema used for each change if available.
+   Mark changes with incomplete tasks as "(In Progress)".
+
+   **IMPORTANT**: Do NOT guess or auto-select a change. Always let the user choose.
+
+2. **Check status to understand the schema**
+   ```bash
+   openspec status --change "<name>" --json
+   ```
+   Parse the JSON to understand:
+   - `schemaName`: The workflow being used (e.g., "spec-driven")
+   - Which artifacts exist for this change
+
+3. **Get the change directory and load artifacts**
+
+   ```bash
+   openspec instructions apply --change "<name>" --json
+   ```
+
+   This returns the change directory and context files. Read all available artifacts from `contextFiles`.
+
+4. **Initialize verification report structure**
+
+   Create a report structure with three dimensions:
+   - **Completeness**: Track tasks and spec coverage
+   - **Correctness**: Track requirement implementation and scenario coverage
+   - **Coherence**: Track design adherence and pattern consistency
+
+   Each dimension can have CRITICAL, WARNING, or SUGGESTION issues.
+
+5. **Verify Completeness**
+
+   **Task Completion**:
+   - If tasks.md exists in contextFiles, read it
+   - Parse checkboxes: `- [ ]` (incomplete) vs `- [x]` (complete)
+   - Count complete vs total tasks
+   - If incomplete tasks exist:
+     - Add CRITICAL issue for each incomplete task
+     - Recommendation: "Complete task: <description>" or "Mark as done if already implemented"
+
+   **Spec Coverage**:
+   - If delta specs exist in `openspec/changes/<name>/specs/`:
+     - Extract all requirements (marked with "### Requirement:")
+     - For each requirement:
+       - Search codebase for keywords related to the requirement
+       - Assess if implementation likely exists
+     - If requirements appear unimplemented:
+       - Add CRITICAL issue: "Requirement not found: <requirement name>"
+       - Recommendation: "Implement requirement X: <description>"
+
+6. **Verify Correctness**
+
+   **Requirement Implementation Mapping**:
+   - For each requirement from delta specs:
+     - Search codebase for implementation evidence
+     - If found, note file paths and line ranges
+     - Assess if implementation matches requirement intent
+     - If divergence detected:
+       - Add WARNING: "Implementation may diverge from spec: <details>"
+       - Recommendation: "Review <file>:<lines> against requirement X"
+
+   **Scenario Coverage**:
+   - For each scenario in delta specs (marked with "#### Scenario:"):
+     - Check if conditions are handled in code
+     - Check if tests exist covering the scenario
+     - If scenario appears uncovered:
+       - Add WARNING: "Scenario not covered: <scenario name>"
+       - Recommendation: "Add test or implementation for scenario: <description>"
+
+7. **Verify Coherence**
+
+   **Design Adherence**:
+   - If design.md exists in contextFiles:
+     - Extract key decisions (look for sections like "Decision:", "Approach:", "Architecture:")
+     - Verify implementation follows those decisions
+     - If contradiction detected:
+       - Add WARNING: "Design decision not followed: <decision>"
+       - Recommendation: "Update implementation or revise design.md to match reality"
+   - If no design.md: Skip design adherence check, note "No design.md to verify against"
+
+   **Code Pattern Consistency**:
+   - Review new code for consistency with project patterns
+   - Check file naming, directory structure, coding style
+   - If significant deviations found:
+     - Add SUGGESTION: "Code pattern deviation: <details>"
+     - Recommendation: "Consider following project pattern: <example>"
+
+8. **Generate Verification Report**
+
+   **Summary Scorecard**:
+   ```
+   ## Verification Report: <change-name>
+
+   ### Summary
+   | Dimension    | Status           |
+   |--------------|------------------|
+   | Completeness | X/Y tasks, N reqs|
+   | Correctness  | M/N reqs covered |
+   | Coherence    | Followed/Issues  |
+   ```
+
+   **Issues by Priority**:
+
+   1. **CRITICAL** (Must fix before archive):
+      - Incomplete tasks
+      - Missing requirement implementations
+      - Each with specific, actionable recommendation
+
+   2. **WARNING** (Should fix):
+      - Spec/design divergences
+      - Missing scenario coverage
+      - Each with specific recommendation
+
+   3. **SUGGESTION** (Nice to fix):
+      - Pattern inconsistencies
+      - Minor improvements
+      - Each with specific recommendation
+
+   **Final Assessment**:
+   - If CRITICAL issues: "X critical issue(s) found. Fix before archiving."
+   - If only warnings: "No critical issues. Y warning(s) to consider. Ready for archive (with noted improvements)."
+   - If all clear: "All checks passed. Ready for archive."
+
+**Verification Heuristics**
+
+- **Completeness**: Focus on objective checklist items (checkboxes, requirements list)
+- **Correctness**: Use keyword search, file path analysis, reasonable inference - don't require perfect certainty
+- **Coherence**: Look for glaring inconsistencies, don't nitpick style
+- **False Positives**: When uncertain, prefer SUGGESTION over WARNING, WARNING over CRITICAL
+- **Actionability**: Every issue must have a specific recommendation with file/line references where applicable
+
+**Graceful Degradation**
+
+- If only tasks.md exists: verify task completion only, skip spec/design checks
+- If tasks + specs exist: verify completeness and correctness, skip design
+- If full artifacts: verify all three dimensions
+- Always note which checks were skipped and why
+
+**Output Format**
+
+Use clear markdown with:
+- Table for summary scorecard
+- Grouped lists for issues (CRITICAL/WARNING/SUGGESTION)
+- Code references in format: `file.ts:123`
+- Specific, actionable recommendations
+- No vague suggestions like "consider reviewing"

package/.claude/commands/progress.md

@@ -0,0 +1,264 @@
+# /progress - 项目进度梳理
+
+作为项目进度分析助手，帮您快速分析后端开发进度、识别完成度和待办事项。
+
+## 执行流程
+
+### 第一步：扫描业务模块（强制执行）
+
+```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（物流模块）
+```
+
+自动检测的核心业务模块：
+- `sys-canteen`：食堂业务（订单、菜品、用户）
+- `sys-kitchen`：后场厨房（备餐、出餐、排班）
+- `sys-drp`：供应链（采购、库存、配送）
+- `sys-common`：公共业务（支付、通知、对接）
+
+### 第二步：分析代码完整性
+
+对每个功能检查 **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` | ✅ | Mapper 接口 |
+| MapperXML | `XxxInfoMapper.xml` | `common/mapper/XxxInfoMapper.xml` | ✅ | SQL 映射（同目录） |
+| Service | `XxxInfoService.java` | `common/service/impl/XxxInfoService.java` | ✅ | 单表 CRUD |
+| Business | `XxxWebBusiness.java` | `web/business/impl/XxxWebBusiness.java` | ✅ | 业务编排 |
+| Controller | `XxxWebController.java` | `web/controller/XxxWebController.java` | ✅ | 接口层 |
+
+### 第三步：扫描代码待办（TODO/FIXME）
+
+```bash
+# 扫描需要处理的代码注释
+Grep pattern: "TODO:|FIXME:" path: sys-canteen/,sys-kitchen/,sys-drp/,sys-common/ glob: "*.java" output_mode: content -B 1
+```
+
+### 第四步：扫描 OpenSpec 变更状态（如有）
+
+```bash
+# 检查是否有活跃的 OpenSpec 变更
+Glob pattern: "openspec/changes/*/tasks.md"
+
+# 对每个找到的变更：
+# 1. 读取 proposal.md 获取变更概述
+# 2. 读取 tasks.md 统计任务完成情况（[ ] 未完成 / [x] 已完成）
+# 3. 检查是否有 design.md、specs/ 等制品
+```
+
+### 第五步：代码质量分析
+
+```bash
+# 检查代码规范性
+Grep pattern: "package org\.dromara\." path: sys-canteen/,sys-kitchen/,sys-drp/ glob: "*.java" 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: "createBy|createTime|updateBy|updateTime" path: sys-canteen/,sys-kitchen/,sys-drp/ glob: "*.java" output_mode: files_with_matches
+Grep pattern: "delFlag.*=.*0\b" path: sys-canteen/,sys-kitchen/,sys-drp/ glob: "*.java" output_mode: files_with_matches
+```
+
+---
+
+## 输出格式
+
+```markdown
+# 项目进度报告
+
+**生成时间**：YYYY-MM-DD HH:mm
+**检查范围**：全量后端代码
+
+---
+
+## 项目概况
+
+- **项目名称**：leniu-tengyun-core 云食堂
+- **技术栈**：Spring Boot 3.x + pigx-framework + MyBatis-Plus + JDK 21
+- **架构**：四层架构（Controller → Business → Service → Mapper）
+- **双库**：系统库（全局配置）+ 商户库（租户业务数据）
+- **当前阶段**：[开发中/测试中/已上线]
+
+---
+
+## 后端模块进度汇总
+
+| 模块 | 功能数 | 完成数 | 完成率 | 状态 |
+|------|--------|--------|--------|------|
+| sys-canteen（食堂业务） | X | X | XX% | [状态] |
+| sys-kitchen（后场厨房） | X | X | XX% | [状态] |
+| sys-drp（供应链） | X | X | XX% | [状态] |
+| sys-common（公共业务） | X | X | XX% | [状态] |
+| **合计** | **X** | **X** | **XX%** | [状态] |
+
+---
+
+## 功能详情分析
+
+### [模块名] 模块 (XX% 完成)
+
+| 功能 | Entity | DTO | VO | Mapper | XML | Service | Business | Controller | 完成度 | 备注 |
+|------|--------|-----|----|--------|-----|---------|----------|------------|--------|------|
+| [功能名] | ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ | XX% | [备注] |
+
+**说明**：
+- ✅ 已完成
+- ⚠️ 部分完成/需改进
+- ❌ 待完成
+
+---
+
+## OpenSpec 变更状态（如有活跃变更）
+
+| 变更名称 | 状态 | 任务完成 | 概述 |
+|---------|------|---------|------|
+| `[change-name]` | 进行中 | X/Y | [proposal 概述] |
+
+> 使用 `/opsx:apply [变更名]` 继续实现未完成的任务，或 `/opsx:verify [变更名]` 验证已完成的变更。
+
+---
+
+## 代码质量分析
+
+| 指标 | 评分 | 说明 |
+|------|------|------|
+| 包名规范 | 良好 ✅ | 所有包名符合 net.xnzn.core.* |
+| 审计字段 | 良好 ✅ | 使用 crby/crtime/upby/uptime |
+| del_flag 语义 | 良好 ✅ | 正确使用 2=正常，1=删除 |
+| 权限注解完整度 | 待补充 ⚠️ | 部分接口缺少 @RequiresAuthentication |
+| 对象转换规范 | 良好 ✅ | 正确使用 BeanUtil.copyProperties() |
+| 请求封装规范 | 待补充 ⚠️ | 部分 POST 接口未使用 LeRequest<T> |
+| 事务注解完整 | 良好 ✅ | 写操作均有 @Transactional |
+
+---
+
+## 代码待办事项
+
+### TODO 项 (X 个)
+
+| 文件 | 行号 | 类型 | 内容 | 优先级 |
+|------|------|------|------|--------|
+| `[文件名].java` | [行号] | TODO | [描述] | [优先级] |
+
+### FIXME 项 (X 个)
+
+| 文件 | 行号 | 类型 | 内容 | 优先级 |
+|------|------|------|------|--------|
+| `[文件名].java` | [行号] | FIXME | [描述] | [优先级] |
+
+---
+
+## 改进建议
+
+### 高优先级（需立即处理）
+
+1. **补充缺失的 Business 层**
+   - [模块名] 缺少 [功能名]WebBusiness 编排层
+   - 影响：复杂业务逻辑无处放置
+   - 建议：使用 `/crud [功能名]` 快速生成
+
+2. **完善权限注解**
+   - 发现 X 个接口缺少 @RequiresAuthentication/@RequiresGuest
+   - 影响：权限控制不严格
+   - 建议：使用 `/check` 进行完整检查
+
+3. **修复 FIXME 问题**
+   - [FIXME 描述]
+   - 影响：[影响范围]
+   - 优先级：🔴 高
+
+### 中优先级（逐步完善）
+
+1. **补充接口注释**
+   - [模块名] 缺少业务逻辑注释
+   - 建议：为关键方法添加 JavaDoc
+
+2. **优化查询性能**
+   - [Service 文件名] 大数据量查询需优化
+   - 建议：添加分页、完善 buildWrapper 查询条件
+
+3. **完善 Mapper XML**
+   - [模块名] 部分复杂查询需要补充 XML SQL
+   - 建议：XML 文件与 Mapper.java 放在同一目录
+
+---
+
+## 检查通过项
+
+- [x] 包名规范（net.xnzn.core.*）
+- [x] 对象转换（BeanUtil.copyProperties()）
+- [x] 审计字段（crby/crtime/upby/uptime）
+- [x] 逻辑删除（del_flag: 2=正常，1=删除）
+- [x] Mapper 继承（BaseMapper<Entity>）
+- [x] 无 tenant_id 字段（双库物理隔离）
+
+---
+
+## 完成度判定标准
+
+| 完成率 | 状态 | 说明 | 推荐行动 |
+|--------|------|------|---------|
+| 100% | ✅ 已完成 | 全部 8 个文件均已完成 | 可进行代码审查 |
+| 75-99% | 🟢 基本完成 | 缺少 1-2 个文件 | 补充缺失文件 |
+| 50-74% | 🟡 进行中 | 缺少 2-4 个文件 | 加快开发进度 |
+| 1-49% | 🔴 早期阶段 | 仅有少量文件 | 继续开发 |
+| 0% | ⚫ 待开发 | 无相关文件 | 使用 `/dev` 开始开发 |
+
+---
+
+## 快速操作
+
+根据上面的分析结果，您可以使用以下命令快速完成开发：
+
+```bash
+# 1. 快速生成缺失功能
+/crud [功能名]
+
+# 2. 检查并修复代码规范
+/check [模块名]
+
+# 3. 继续开发新功能（含表设计）
+/dev 新功能名称
+
+# 4. 快速添加待办任务
+/add-todo [任务描述]，[优先级]
+```
+
+---
+
+## 说明
+
+- 本报告统计核心业务模块（sys-canteen、sys-kitchen、sys-drp、sys-common）
+- 基础设施模块（core-base、core-aggregator、sys-open、sys-logistics）不统计进度
+- 完成率基于 8 个必需文件的存在情况判定（leniu 四层架构）
+- 代码待办基于 TODO/FIXME 注释统计
+- 建议定期运行此命令以追踪项目进度
+```
+
+---
+
+## 使用示例
+
+```
+用户：/progress
+用户：/progress canteen （仅检查 sys-canteen 模块）
+用户：/progress kitchen （仅检查 sys-kitchen 模块）
+
+Claude：
+🔍 正在扫描项目结构...
+📊 分析代码完整性...
+🔍 扫描代码待办事项...
+
+[输出完整的进度报告]
+```

package/.claude/commands/release.md

@@ -0,0 +1,109 @@
+# /release - 自动化发版
+
+作为发版助手，自动读取项目发版规范（RELEASE.md），按标准流程执行版本发布。
+
+## 使用方式
+
+- `/release` — 自动检测变更，推荐版本号，执行完整发版流程
+- `/release patch` — 指定 patch 版本升级
+- `/release minor` — 指定 minor 版本升级
+- `/release major` — 指定 major 版本升级
+
+## 执行流程
+
+### 第一步：环境检查
+
+```bash
+# 1. 读取发版规范
+cat RELEASE.md
+
+# 2. 查看当前版本和最新 tag
+node -p "require('./package.json').version"
+git tag --sort=-version:refname | head -5
+
+# 3. 检查工作区状态（必须干净或只有待发版的改动）
+git status -s
+
+# 4. 查看自上次 tag 以来的所有 commit
+git log $(git tag --sort=-version:refname | head -1)..HEAD --oneline
+```
+
+### 第二步：确定版本号
+
+根据 commit 内容自动推荐版本类型：
+- 含 `feat` → minor
+- 含 `fix`/`chore`/`remove` → patch
+- 含 `BREAKING CHANGE` → major
+
+如果用户指定了版本类型（patch/minor/major），直接使用。
+否则展示推荐并等用户确认。
+
+### 第三步：更新 CHANGELOG.md
+
+基于 `git log` 自动生成 CHANGELOG 条目：
+
+```markdown
+## [vX.Y.Z] - YYYY-MM-DD
+
+### 新增
+- ...
+
+### 修复
+- ...
+
+### 移除
+- ...
+```
+
+分类规则：
+- `feat` 开头 → 新增
+- `fix` 开头 → 修复
+- `remove`/`删除` → 移除
+- `chore`/其他 → 改进
+
+生成后展示给用户确认，可修改。
+
+### 第四步：更新 package.json
+
+```bash
+# 使用 npm version 更新（不自动打 tag）
+npm version <patch|minor|major> --no-git-tag-version
+```
+
+### 第五步：提交
+
+```bash
+git add package.json CHANGELOG.md
+git commit -m "chore: 发布 vX.Y.Z"
+```
+
+### 第六步：推送代码
+
+```bash
+git push origin main
+```
+
+### 第七步：打 tag 并推送
+
+```bash
+git tag vX.Y.Z
+git push origin vX.Y.Z
+```
+
+### 第八步：验证
+
+```bash
+echo "package.json: $(node -p \"require('./package.json').version\")"
+echo "latest tag:   $(git tag --sort=-version:refname | head -1)"
+echo "HEAD commit:  $(git log --oneline -1)"
+echo "tag commit:   $(git rev-parse --short vX.Y.Z)"
+```
+
+确认四个值一致后，输出发版成功信息。
+
+## 安全规则
+
+- 如果 `git status` 有未提交的改动，先询问用户是否需要一起发版
+- 如果 package.json version 已经大于最新 tag，说明版本号已手动更新过，跳过 npm version 步骤
+- 推送前必须确认 remote 是正确的仓库
+- 每一步失败都立即停止并报告，不要继续后续步骤