feat：update 3 4
This commit is contained in:
smart
@@ -0,0 +1,423 @@
|
||||
# JeecgBoot Work Order Case Pack Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
**Goal:** Create an independent JeecgBoot work-order training case pack under `cases/jeecgboot-work-order/`.
|
||||
|
||||
**Architecture:** This is a documentation-only training asset. The case pack is split into an entry README, role-specific guides, a source map, prompt templates, worksheets, an acceptance checklist, and an asset index. It references the local JeecgBoot project and existing TRAE course materials without changing either.
|
||||
|
||||
**Tech Stack:** Markdown, local JeecgBoot source paths, existing TRAE course docs.
|
||||
|
||||
---
|
||||
|
||||
## File Structure
|
||||
|
||||
- Create: `cases/jeecgboot-work-order/README.md`
|
||||
- Case pack entry, learning goals, audience, timing, usage order, required project context, final deliverables.
|
||||
- Create: `cases/jeecgboot-work-order/instructor-guide.md`
|
||||
- Teaching agenda for 2-hour, half-day, and full-day variants, with facilitation notes and common failure modes.
|
||||
- Create: `cases/jeecgboot-work-order/learner-guide.md`
|
||||
- Student-facing lab path from project reading to final review.
|
||||
- Create: `cases/jeecgboot-work-order/source-map.md`
|
||||
- Source-grounded JeecgBoot path map for backend, frontend, permissions, routes, config, database, and project knowledge docs.
|
||||
- Create: `cases/jeecgboot-work-order/prompts.md`
|
||||
- Copy-ready TRAE prompts with inputs, constraints, and output formats.
|
||||
- Create: `cases/jeecgboot-work-order/worksheets.md`
|
||||
- Fillable classroom templates for requirements, source evidence, APIs, RBAC, state transitions, audit, dashboard, and review.
|
||||
- Create: `cases/jeecgboot-work-order/acceptance-checklist.md`
|
||||
- Checklist for evaluating learner output.
|
||||
- Create: `cases/jeecgboot-work-order/assets-index.md`
|
||||
- Post-class asset library mapping for rules, prompts, commands, skills, SOPs, and cases.
|
||||
|
||||
## Task 1: Create Case Pack Directory
|
||||
|
||||
**Files:**
|
||||
- Create: `cases/jeecgboot-work-order/`
|
||||
|
||||
- [ ] **Step 1: Create the directory**
|
||||
|
||||
Run:
|
||||
|
||||
```bash
|
||||
mkdir -p cases/jeecgboot-work-order
|
||||
```
|
||||
|
||||
Expected: directory exists.
|
||||
|
||||
- [ ] **Step 2: Verify the directory**
|
||||
|
||||
Run:
|
||||
|
||||
```bash
|
||||
find cases -maxdepth 2 -type d | sort
|
||||
```
|
||||
|
||||
Expected includes:
|
||||
|
||||
```text
|
||||
cases
|
||||
cases/jeecgboot-work-order
|
||||
```
|
||||
|
||||
## Task 2: Write Entry README
|
||||
|
||||
**Files:**
|
||||
- Create: `cases/jeecgboot-work-order/README.md`
|
||||
|
||||
- [ ] **Step 1: Write README**
|
||||
|
||||
Include these sections:
|
||||
|
||||
```markdown
|
||||
# JeecgBoot 工单案例包
|
||||
|
||||
## 适用场景
|
||||
|
||||
## 学习目标
|
||||
|
||||
## 建议使用顺序
|
||||
|
||||
## 课前准备
|
||||
|
||||
## 案例任务主线
|
||||
|
||||
## 最终交付物
|
||||
|
||||
## 关键约束
|
||||
|
||||
## 文件索引
|
||||
```
|
||||
|
||||
- [ ] **Step 2: Check README links**
|
||||
|
||||
Run:
|
||||
|
||||
```bash
|
||||
rg -n "\\[[^\\]]+\\]\\(([^)]+)\\)" cases/jeecgboot-work-order/README.md
|
||||
```
|
||||
|
||||
Expected: all relative links point to files created in this plan.
|
||||
|
||||
## Task 3: Write Instructor And Learner Guides
|
||||
|
||||
**Files:**
|
||||
- Create: `cases/jeecgboot-work-order/instructor-guide.md`
|
||||
- Create: `cases/jeecgboot-work-order/learner-guide.md`
|
||||
|
||||
- [ ] **Step 1: Write instructor guide**
|
||||
|
||||
Include:
|
||||
|
||||
```markdown
|
||||
# 讲师手册
|
||||
|
||||
## 授课定位
|
||||
|
||||
## 2 小时版本
|
||||
|
||||
## 半天版本
|
||||
|
||||
## 1 天版本
|
||||
|
||||
## 演示路径
|
||||
|
||||
## 讲师提醒
|
||||
|
||||
## 常见翻车点
|
||||
|
||||
## 收束话术
|
||||
```
|
||||
|
||||
- [ ] **Step 2: Write learner guide**
|
||||
|
||||
Include:
|
||||
|
||||
```markdown
|
||||
# 学员实操手册
|
||||
|
||||
## 实操目标
|
||||
|
||||
## 第 1 步：建立项目地图
|
||||
|
||||
## 第 2 步：整理工单需求
|
||||
|
||||
## 第 3 步：定位源码依据
|
||||
|
||||
## 第 4 步：设计接口契约
|
||||
|
||||
## 第 5 步：设计权限和状态流转
|
||||
|
||||
## 第 6 步：补齐审计和异常态
|
||||
|
||||
## 第 7 步：设计看板指标
|
||||
|
||||
## 第 8 步：做 Review 和交付验收
|
||||
```
|
||||
|
||||
- [ ] **Step 3: Verify guides reference worksheets and prompts**
|
||||
|
||||
Run:
|
||||
|
||||
```bash
|
||||
rg -n "prompts.md|worksheets.md|source-map.md|acceptance-checklist.md" cases/jeecgboot-work-order/instructor-guide.md cases/jeecgboot-work-order/learner-guide.md
|
||||
```
|
||||
|
||||
Expected: both guides reference supporting files.
|
||||
|
||||
## Task 4: Write Source Map
|
||||
|
||||
**Files:**
|
||||
- Create: `cases/jeecgboot-work-order/source-map.md`
|
||||
|
||||
- [ ] **Step 1: Write source map**
|
||||
|
||||
Include source-grounded tables for:
|
||||
|
||||
```markdown
|
||||
# 源码定位图
|
||||
|
||||
## 项目知识库入口
|
||||
|
||||
## 后端入口与模块
|
||||
|
||||
## 前端入口与模块
|
||||
|
||||
## 权限与路由
|
||||
|
||||
## API 与请求层
|
||||
|
||||
## 配置与运行
|
||||
|
||||
## 数据库与迁移
|
||||
|
||||
## 课堂使用方式
|
||||
```
|
||||
|
||||
- [ ] **Step 2: Verify referenced local paths exist**
|
||||
|
||||
Run:
|
||||
|
||||
```bash
|
||||
rg -o "`\\.\\./JeecgBoot/[^`]+`" cases/jeecgboot-work-order/source-map.md
|
||||
```
|
||||
|
||||
Then manually confirm representative paths exist with `test -e` or `ls`.
|
||||
|
||||
## Task 5: Write Prompt Library
|
||||
|
||||
**Files:**
|
||||
- Create: `cases/jeecgboot-work-order/prompts.md`
|
||||
|
||||
- [ ] **Step 1: Write prompt templates**
|
||||
|
||||
Include prompts for:
|
||||
|
||||
```markdown
|
||||
# Prompt 模板库
|
||||
|
||||
## 使用规则
|
||||
|
||||
## 项目理解 Prompt
|
||||
|
||||
## 源码定位 Prompt
|
||||
|
||||
## 需求拆解 Prompt
|
||||
|
||||
## 接口契约 Prompt
|
||||
|
||||
## RBAC 权限矩阵 Prompt
|
||||
|
||||
## 权限落地检查 Prompt
|
||||
|
||||
## 状态机设计 Prompt
|
||||
|
||||
## 审计日志 Prompt
|
||||
|
||||
## 异常态 Prompt
|
||||
|
||||
## 看板指标 Prompt
|
||||
|
||||
## 修改计划 Prompt
|
||||
|
||||
## Review Prompt
|
||||
```
|
||||
|
||||
Each prompt must require TRAE to output:
|
||||
|
||||
```text
|
||||
事实依据
|
||||
推断
|
||||
建议
|
||||
不确定点
|
||||
下一步验证
|
||||
```
|
||||
|
||||
- [ ] **Step 2: Verify prompt safety wording**
|
||||
|
||||
Run:
|
||||
|
||||
```bash
|
||||
rg -n "先找依据|事实|推断|建议|不确定点|不要直接改代码|验收" cases/jeecgboot-work-order/prompts.md
|
||||
```
|
||||
|
||||
Expected: all key safety constraints are present.
|
||||
|
||||
## Task 6: Write Worksheets
|
||||
|
||||
**Files:**
|
||||
- Create: `cases/jeecgboot-work-order/worksheets.md`
|
||||
|
||||
- [ ] **Step 1: Write worksheets**
|
||||
|
||||
Include fillable tables:
|
||||
|
||||
```markdown
|
||||
# 课堂工作表
|
||||
|
||||
## 上下文包
|
||||
|
||||
## 源码依据记录表
|
||||
|
||||
## 需求拆解表
|
||||
|
||||
## 接口契约表
|
||||
|
||||
## RBAC 权限矩阵
|
||||
|
||||
## 状态流转表
|
||||
|
||||
## 审计日志设计表
|
||||
|
||||
## 异常态清单
|
||||
|
||||
## 看板指标表
|
||||
|
||||
## Review 记录表
|
||||
|
||||
## 最终交付记录
|
||||
```
|
||||
|
||||
- [ ] **Step 2: Verify tables are fillable**
|
||||
|
||||
Run:
|
||||
|
||||
```bash
|
||||
rg -n "\\|.*\\|.*\\|" cases/jeecgboot-work-order/worksheets.md
|
||||
```
|
||||
|
||||
Expected: each worksheet section contains a Markdown table.
|
||||
|
||||
## Task 7: Write Acceptance Checklist And Asset Index
|
||||
|
||||
**Files:**
|
||||
- Create: `cases/jeecgboot-work-order/acceptance-checklist.md`
|
||||
- Create: `cases/jeecgboot-work-order/assets-index.md`
|
||||
|
||||
- [ ] **Step 1: Write acceptance checklist**
|
||||
|
||||
Include:
|
||||
|
||||
```markdown
|
||||
# 验收清单
|
||||
|
||||
## 项目理解
|
||||
|
||||
## 需求与接口
|
||||
|
||||
## 权限与状态
|
||||
|
||||
## 审计、异常态与看板
|
||||
|
||||
## Review 与交付
|
||||
|
||||
## 评分建议
|
||||
```
|
||||
|
||||
- [ ] **Step 2: Write asset index**
|
||||
|
||||
Include:
|
||||
|
||||
```markdown
|
||||
# 资产归档索引
|
||||
|
||||
## 可沉淀资产
|
||||
|
||||
## 目录建议
|
||||
|
||||
## 规则资产
|
||||
|
||||
## Prompt 资产
|
||||
|
||||
## Command 与 Skill 资产
|
||||
|
||||
## 案例库资产
|
||||
|
||||
## 维护机制
|
||||
```
|
||||
|
||||
- [ ] **Step 3: Verify checklist and assets are cross-linked**
|
||||
|
||||
Run:
|
||||
|
||||
```bash
|
||||
rg -n "README.md|prompts.md|worksheets.md|acceptance-checklist.md|assets-index.md" cases/jeecgboot-work-order/acceptance-checklist.md cases/jeecgboot-work-order/assets-index.md
|
||||
```
|
||||
|
||||
Expected: files reference related materials.
|
||||
|
||||
## Task 8: Final Verification
|
||||
|
||||
**Files:**
|
||||
- Inspect all files under `cases/jeecgboot-work-order/`
|
||||
|
||||
- [ ] **Step 1: List generated files**
|
||||
|
||||
Run:
|
||||
|
||||
```bash
|
||||
find cases/jeecgboot-work-order -type f | sort
|
||||
```
|
||||
|
||||
Expected exactly:
|
||||
|
||||
```text
|
||||
cases/jeecgboot-work-order/README.md
|
||||
cases/jeecgboot-work-order/acceptance-checklist.md
|
||||
cases/jeecgboot-work-order/assets-index.md
|
||||
cases/jeecgboot-work-order/instructor-guide.md
|
||||
cases/jeecgboot-work-order/learner-guide.md
|
||||
cases/jeecgboot-work-order/prompts.md
|
||||
cases/jeecgboot-work-order/source-map.md
|
||||
cases/jeecgboot-work-order/worksheets.md
|
||||
```
|
||||
|
||||
- [ ] **Step 2: Scan for placeholders**
|
||||
|
||||
Run:
|
||||
|
||||
```bash
|
||||
rg -n "TODO|TBD|待补|your/path|foo|bar|unknown" cases/jeecgboot-work-order
|
||||
```
|
||||
|
||||
Expected: no output.
|
||||
|
||||
- [ ] **Step 3: Check source path references**
|
||||
|
||||
Run:
|
||||
|
||||
```bash
|
||||
rg -n "../../../JeecgBoot|jeecg-boot|jeecgboot-vue3|docs/project-knowledge" cases/jeecgboot-work-order
|
||||
```
|
||||
|
||||
Expected: source references exist in `source-map.md`, `prompts.md`, and guides.
|
||||
|
||||
- [ ] **Step 4: Check Git status**
|
||||
|
||||
Run:
|
||||
|
||||
```bash
|
||||
git status --short
|
||||
```
|
||||
|
||||
Expected: only new `docs/` and `cases/` from this work plus pre-existing unrelated changes.
|
||||
|
||||
@@ -0,0 +1,142 @@
|
||||
# JeecgBoot 工单案例包设计
|
||||
|
||||
日期：2026-07-01
|
||||
|
||||
## 目标
|
||||
|
||||
在现有 TRAE 培训课件之外，新增一个可独立分发、可插入第 3/4 天课程的 `JeecgBoot 工单案例包`。案例包用于训练学员把 TRAE 用在真实 JeecgBoot 类后台项目中，完成从项目理解、需求拆解、权限设计、状态流转、审计、异常态、看板到 Review 的完整工程链路。
|
||||
|
||||
## 范围
|
||||
|
||||
案例包存放在：
|
||||
|
||||
```text
|
||||
cases/jeecgboot-work-order/
|
||||
```
|
||||
|
||||
新增文件：
|
||||
|
||||
```text
|
||||
cases/jeecgboot-work-order/
|
||||
├── README.md
|
||||
├── instructor-guide.md
|
||||
├── learner-guide.md
|
||||
├── source-map.md
|
||||
├── prompts.md
|
||||
├── worksheets.md
|
||||
├── acceptance-checklist.md
|
||||
└── assets-index.md
|
||||
```
|
||||
|
||||
不修改现有 Slidev 主课件，不修改 `JeecgBoot` 项目源码，不生成工单模块代码。案例包是培训资料资产，不是代码实现任务。
|
||||
|
||||
## 已观察来源
|
||||
|
||||
- `TRAE 培训大纲V1.0.md`：定义 6 天课程主线和 JeecgBoot 工单训练主题。
|
||||
- `第 3 天：TRAE 能力体系与 Agent 工作方式.md`：后半段已承接 JeecgBoot 工单、Plan、Review、Browser 验证。
|
||||
- `第 4 天：JeecgBoot 工单复杂业务开发：权限、审计、异常态与看板.md`：已有完整复杂业务讲法和交付物。
|
||||
- `slidev/slides.md`：当前 Slidev 主线已包含第 1-4 天，不纳入本次修改范围。
|
||||
- `../../../JeecgBoot/docs/project-knowledge/README.md`：JeecgBoot 项目知识库入口。
|
||||
- `../../../JeecgBoot/jeecg-boot/CLAUDE.md`：后端项目约束、模块结构、修改痕迹规则。
|
||||
- `../../../JeecgBoot/jeecgboot-vue3/CLAUDE.md`：前端项目约束、路由、Pinia、API 层、构建命令。
|
||||
|
||||
## 内容设计
|
||||
|
||||
### README.md
|
||||
|
||||
案例包入口。说明适用对象、建议课时、学习目标、使用顺序、项目准备、交付物清单。
|
||||
|
||||
核心作用：让讲师和学员知道这个包怎么用。
|
||||
|
||||
### instructor-guide.md
|
||||
|
||||
讲师手册。包含 2 小时、半天、1 天三种授课节奏，讲解重点、提问方式、演示路径、常见翻车点和收束话术。
|
||||
|
||||
核心作用：让讲师不用重新组织课堂流程。
|
||||
|
||||
### learner-guide.md
|
||||
|
||||
学员手册。按步骤指导学员使用 TRAE 完成案例任务：读项目、定位源码、拆需求、设计权限、设计状态流转、补审计、列异常态、做看板、做 Review。
|
||||
|
||||
核心作用：让学员可以独立完成实操。
|
||||
|
||||
### source-map.md
|
||||
|
||||
源码定位图。按主题列出 JeecgBoot 前端、后端、权限、路由、配置、数据库和知识库入口路径。
|
||||
|
||||
核心作用：避免学员和 TRAE 泛泛总结项目，强制回到实际路径。
|
||||
|
||||
### prompts.md
|
||||
|
||||
Prompt 模板库。覆盖：
|
||||
|
||||
- 项目理解
|
||||
- 源码定位
|
||||
- 需求拆解
|
||||
- 接口契约
|
||||
- RBAC 权限矩阵
|
||||
- 权限落地检查
|
||||
- 状态机设计
|
||||
- 审计日志设计
|
||||
- 异常态清单
|
||||
- 看板指标
|
||||
- 代码修改计划
|
||||
- Review 与验收
|
||||
|
||||
核心作用：提供课堂可直接复制的 TRAE 提问模板。
|
||||
|
||||
### worksheets.md
|
||||
|
||||
课堂填写表。包含需求拆解表、上下文包、源码依据记录表、接口契约表、权限矩阵、状态流转表、异常态清单、看板指标表、Review 记录表。
|
||||
|
||||
核心作用：让课堂产出标准化。
|
||||
|
||||
### acceptance-checklist.md
|
||||
|
||||
验收清单。按理解、设计、实现计划、验证、资产沉淀五类检查学员产出。
|
||||
|
||||
核心作用：判断学员是否真的掌握，而不是只让 AI 生成了一段内容。
|
||||
|
||||
### assets-index.md
|
||||
|
||||
资产归档建议。说明哪些内容适合沉淀为团队规则、Prompt、Command、Skill、案例库、SOP。
|
||||
|
||||
核心作用：把一次课堂实操转成可复用企业资产。
|
||||
|
||||
## 关键约束
|
||||
|
||||
1. 所有非显而易见的项目事实必须引用实际路径。
|
||||
2. 工单模块是教学案例，不假设当前 JeecgBoot 源码中已经存在完整工单模块。
|
||||
3. Prompt 必须要求 TRAE 区分事实、推断和建议。
|
||||
4. Prompt 必须要求 TRAE 先找依据，再给结论，不允许直接改代码。
|
||||
5. 涉及权限、状态流转、审计、删除、数据看板的任务必须先产出计划和验收点。
|
||||
6. 后端二开说明必须提醒遵守 `jeecg-boot/CLAUDE.md` 中的 `update-begin` / `update-end` 修改痕迹规则。
|
||||
7. 前端说明必须提醒遵守 `jeecgboot-vue3/CLAUDE.md` 中的 `/@/` alias、Pinia、动态路由和 `defHttp` API 层约定。
|
||||
8. 不新增第 5/6 天课件，不改 `slidev/slides.md`。
|
||||
|
||||
## 产出质量标准
|
||||
|
||||
- 新人能根据 `README.md` 判断使用顺序。
|
||||
- 讲师能根据 `instructor-guide.md` 开始授课。
|
||||
- 学员能根据 `learner-guide.md` 完成一轮工单案例设计。
|
||||
- `source-map.md` 能把学员从“泛泛问项目”引导到具体源码路径。
|
||||
- `prompts.md` 的模板能直接复制使用，并包含输入、约束、输出格式和验收要求。
|
||||
- `worksheets.md` 的表格能承接课堂产出。
|
||||
- `acceptance-checklist.md` 能用于小组展示验收。
|
||||
- `assets-index.md` 能指导课后资产沉淀。
|
||||
|
||||
## 非目标
|
||||
|
||||
- 不实现真实工单模块。
|
||||
- 不安装依赖、不启动 JeecgBoot。
|
||||
- 不生成数据库迁移 SQL。
|
||||
- 不改现有课件结构。
|
||||
- 不替换第 4 天逐字稿。
|
||||
- 不把案例包写入 `JeecgBoot/docs/project-knowledge/`，避免培训资料和项目知识库混合。
|
||||
|
||||
## 未知与风险
|
||||
|
||||
- 当前 `TRAE课件` 工作区已有未提交改动，本次只新增案例包和设计说明，不处理既有改动。
|
||||
- JeecgBoot 目录不是 Git 仓库，案例包中的源码路径按当前本地目录快照编写。
|
||||
- 若后续要让学员真正生成并运行工单模块，还需要另行准备数据库、账号、菜单权限和初始数据脚本。
|
||||
|
||||
Reference in New Issue
Block a user