@specpow/framework 0.5.21 → 0.5.22

package/builtin/schemas/mes-crud-module/schema.yaml

@@ -0,0 +1,158 @@
+# MES CRUD Module Schema
+# 基于 MES 项目（mom-master + implat-ui）真实代码模式定制
+# 工件流: proposal → specs → design → tasks → api-docs → menu-register → apply
+
+name: mes-crud-module
+description: |
+  MES 系统专属 CRUD 模块生成器。
+  基于 mom-master（Spring Boot + MyBatis-Plus + Oracle）后端
+  和 implat-ui（Vue2 + ViewUI + VXETable）前端的真实代码模式。
+  生成的代码直接匹配项目约定，无需二次适配。
+
+apply:
+  requires:
+    - tasks    # 实施前必须完成所有工件
+
+artifacts:
+  - id: proposal
+    name: 模块提案
+    description: 描述要生成的 CRUD 模块（实体、字段、业务规则）
+    requires: []
+    template: proposal.md
+    instruction: |
+      根据用户描述，生成 MES CRUD 模块提案。
+      包含：模块名称、所属业务中心（modules-center）、核心实体、表名、
+      CRUD 操作列表、字段清单、业务规则。
+
+      注意 MES 项目约定：
+      - 后端位于 modules-center/{module}-center/
+      - 包名: com.twsz.mom.{module}
+      - 实体继承 BaseModel（雪花 ID + 审计字段自动填充）
+      - 表名使用下划线命名，可选模块前缀
+      - 状态字段统一用 is_effect (1=启用, 0=停用)
+    output: proposal.md
+
+  - id: specs
+    name: 接口规范
+    description: 定义 MES 标准 CRUD 接口行为契约
+    requires: [proposal]
+    template: spec.md
+    instruction: |
+      创建 MES 标准 CRUD 接口规范。使用 Delta Spec 格式。
+
+      MES 项目接口约定（必须遵守）：
+      - POST /{entity}/search — 分页查询（请求体: PageForm<{Entity}>）
+      - POST /{entity}/add — 新增（请求体: Entity）
+      - PUT /{entity}/update — 修改（请求体: Entity）
+      - DELETE /{entity}/delete — 批量删除（请求体: Long[] ids）
+      - GET /{entity}/get/{id} — 详情查询
+      - POST /{entity}/list — 不分页列表（请求体: Entity）
+      - POST /{entity}/export — Excel 导出（EasyExcel）
+
+      响应统一使用 ResponseWrapper<T>。
+      分页使用 PageForm<T>（size + current + condition）。
+
+      前端接口约定：
+      - API 文件位于 src/api/{domain}/{entity}.js
+      - 使用 import axios from '@/libs/request'
+      - search 发送 { size, current, condition } 接收 { records, total }
+      - delete 传 ID 数组（支持批量）
+
+      规范是行为契约，描述系统做什么，不描述怎么做。
+      每个需求必须可验证（Given/When/Then）。
+    output: specs/{{entity}}/spec.md
+
+  - id: design
+    name: 模块设计
+    description: 数据库表设计 + 前后端代码结构 + 接口定义
+    requires: [proposal, specs]
+    template: design.md
+    instruction: |
+      创建 MES CRUD 模块设计文档。包含：
+
+      1. 数据库设计（Oracle）
+         - 表结构（遵循 BaseModel 审计字段约定）
+         - 主键: id NUMBER(19) 雪花算法
+         - 审计字段: created_by, created_date, last_updated_by, last_updated_date
+         - 状态字段: is_effect NUMBER(1) DEFAULT 1
+
+      2. 后端代码结构
+         - Entity: 继承 BaseModel，@TableName，@Data
+         - Mapper: 继承 BaseMapper<T>，XML 含 Columns/Where/Joins 片段
+         - Service: 继承 IService<T>
+         - ServiceImpl: 继承 ServiceImpl<Mapper, Entity>
+         - Controller: @RestController，返回 ResponseWrapper<T>
+
+      3. 前端代码结构
+         - API: src/api/{domain}/{entity}.js
+         - 列表页: src/views/{domain}/{entity}/index.vue（indexPage mixin + search-table）
+         - 表单页: src/views/{domain}/{entity}/{entity}-form.vue（master-sub + BaseMixin）
+
+      4. 接口定义表
+
+      如果变更较小（< 3 个文件），可以跳过此工件。
+    output: design.md
+    conditional: true
+
+  - id: tasks
+    name: 任务列表
+    description: 按 MES 项目约定拆分的实现任务（SDD 引擎逐个执行）
+    requires: [proposal, specs, design]
+    template: tasks.md
+    instruction: |
+      创建 MES CRUD 模块实现任务列表。每个任务应：
+      1. 包含精确的文件路径（匹配项目包结构）
+      2. 包含完整的代码模板或明确的修改指令
+      3. 包含验证步骤
+      4. 任务之间尽量独立（便于 SDD 并行）
+
+      MES 后端任务顺序：
+      1. 建表 SQL（Oracle 语法）
+      2. Entity 实体类（继承 BaseModel）
+      3. Mapper 接口 + XML（含 Columns/Where/Joins 片段）
+      4. Service 接口 + 实现
+      5. Controller
+
+      MES 前端任务顺序：
+      6. API 接口文件
+      7. 列表页（index.vue + indexPage mixin）
+      8. 表单页（{entity}-form.vue + master-sub）
+      9. 菜单注册（c_sys_resource SQL）
+
+      格式：
+      - [ ] Task N: <标题>
+        <详细描述，包含精确文件路径和代码>
+        验证: <如何验证>
+    output: tasks.md
+
+  - id: api-docs
+    name: API 接口文档
+    description: MES 标准 RESTful 接口文档（含请求/响应示例）
+    requires: [design]
+    template: api-docs.md
+    instruction: |
+      生成 MES 标准 API 接口文档：
+      - 接口概览表
+      - 每个接口的请求参数和响应示例（JSON 格式）
+      - 使用 ResponseWrapper 包装格式
+      - PageForm 分页请求格式
+      - 通用错误码说明（使用 HttpStatus 枚举）
+    output: api-docs.md
+
+  - id: menu-register
+    name: 菜单注册
+    description: c_sys_resource 表菜单 + 按钮权限注册 SQL
+    requires: [tasks]
+    template: menu-register.md
+    instruction: |
+      生成 MES 菜单注册配置：
+      - c_sys_resource 表 INSERT 语句（菜单 + 按钮权限）
+      - 前端路由配置参考
+      - 权限标识约定: {module}:{entity}:{action}
+
+      MES 菜单注册约定：
+      - type=1 路由菜单, type=2 按钮权限, type=3 API 资源
+      - component 字段为 Vue 组件路径（如 "pm/entity/index"）
+      - permission 字段为权限标识（如 "pm:entity:add"）
+      - 路由由后端动态返回，前端通过 addRoutes 注册
+    output: menu-register.md

package/builtin/schemas/mes-crud-module/templates/api-docs.md

@@ -0,0 +1,238 @@
+# MES API 接口文档: {{Entity}}
+
+> 模块: {{module}} | 实体: {{Entity}} | 基础路径: `/{{entity}}`
+> 响应格式: `ResponseWrapper<T>` | 分页格式: `PageForm<T>`
+
+---
+
+## 接口概览
+
+| Method | Path | 描述 | 认证 |
+|--------|------|------|------|
+| POST | `/{{entity}}/search` | 分页查询 | 需要 |
+| GET | `/{{entity}}/get/{id}` | 详情查询 | 需要 |
+| POST | `/{{entity}}/add` | 新增 | 需要 |
+| PUT | `/{{entity}}/update` | 修改 | 需要 |
+| DELETE | `/{{entity}}/delete` | 批量删除 | 需要 |
+| POST | `/{{entity}}/list` | 不分页列表 | 需要 |
+| POST | `/{{entity}}/export` | Excel 导出 | 需要 |
+
+---
+
+## 1. 分页查询
+
+**请求**: `POST /{{entity}}/search`
+
+**请求体** (`PageForm<{{Entity}}>`):
+```json
+{
+  "size": 20,
+  "current": 1,
+  "condition": {
+    "isEffect": 1
+  }
+}
+```
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| size | number | 否 | 每页条数，默认 20 |
+| current | number | 否 | 页码，默认 1 |
+| condition | object | 否 | 查询条件（实体字段） |
+
+**响应示例**:
+```json
+{
+  "code": 200,
+  "message": "操作成功",
+  "data": {
+    "records": [
+      {
+        "id": "1234567890123456789",
+        "isEffect": 1,
+        "createdBy": "admin",
+        "createdDate": "2025/01/01 00:00:00",
+        "lastUpdatedBy": "admin",
+        "lastUpdatedDate": "2025/01/01 00:00:00"
+      }
+    ],
+    "total": 100,
+    "size": 20,
+    "current": 1
+  }
+}
+```
+
+> **注意**: id 为 Long 类型，序列化为字符串（`@JsonSerialize(using = ToStringSerializer.class)`）避免 JS 精度丢失。
+
+---
+
+## 2. 详情查询
+
+**请求**: `GET /{{entity}}/get/{id}`
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| id | number | 是 | 记录 ID（路径参数） |
+
+**响应示例**:
+```json
+{
+  "code": 200,
+  "message": "操作成功",
+  "data": {
+    "id": "1234567890123456789",
+    "isEffect": 1,
+    "createdBy": "admin",
+    "createdDate": "2025/01/01 00:00:00",
+    "lastUpdatedBy": "admin",
+    "lastUpdatedDate": "2025/01/01 00:00:00"
+  }
+}
+```
+
+---
+
+## 3. 新增
+
+**请求**: `POST /{{entity}}/add`
+
+**请求体**:
+```json
+{
+  "isEffect": 1
+}
+```
+
+> id、createdBy、createdDate、lastUpdatedBy、lastUpdatedDate 由系统自动填充，无需传入。
+
+**响应示例**:
+```json
+{
+  "code": 200,
+  "message": "操作成功",
+  "data": null
+}
+```
+
+---
+
+## 4. 修改
+
+**请求**: `PUT /{{entity}}/update`
+
+**请求体**:
+```json
+{
+  "id": "1234567890123456789",
+  "isEffect": 1
+}
+```
+
+> lastUpdatedBy、lastUpdatedDate 由系统自动更新。
+
+**响应示例**:
+```json
+{
+  "code": 200,
+  "message": "操作成功",
+  "data": null
+}
+```
+
+---
+
+## 5. 批量删除
+
+**请求**: `DELETE /{{entity}}/delete`
+
+**请求体**:
+```json
+[1, 2, 3]
+```
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| body | Long[] | 是 | 待删除记录 ID 数组 |
+
+**响应示例**:
+```json
+{
+  "code": 200,
+  "message": "操作成功",
+  "data": null
+}
+```
+
+---
+
+## 6. 不分页列表
+
+**请求**: `POST /{{entity}}/list`
+
+**请求体**:
+```json
+{
+  "isEffect": 1
+}
+```
+
+**响应示例**:
+```json
+{
+  "code": 200,
+  "message": "操作成功",
+  "data": [
+    { "id": "1234567890123456789", "isEffect": 1 }
+  ]
+}
+```
+
+> 默认限制最多返回 10000 条（可通过 entity.rowNum 覆盖）。
+
+---
+
+## 7. Excel 导出
+
+**请求**: `POST /{{entity}}/export`
+
+**请求体**: 同查询条件（实体字段）
+
+**响应**: Excel 文件流（`application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`）
+
+---
+
+## 通用错误码（HttpStatus 枚举）
+
+| 错误码 | 常量名 | 说明 |
+|--------|--------|------|
+| 200 | SUCCESS | 操作成功 |
+| 600 | ERROR | 系统错误 |
+| 601 | UNAUTHORIZED | 未认证 |
+| 608 | PARAM_NULL | 参数为空 |
+| 620 | OBJECT_EXIST | 对象已存在 |
+| 621 | OBJECT_INSERT_FAIL | 新增失败 |
+| 622 | OBJECT_UPDATE_FAIL | 修改失败 |
+| 623 | OBJECT_DELETE_FAIL | 删除失败 |
+| 634 | OBJECT_NOT_EXIST | 对象不存在 |
+
+**错误响应格式**:
+```json
+{
+  "code": 621,
+  "message": "新增失败",
+  "data": null
+}
+```
+
+---
+
+## ResponseWrapper 结构
+
+```java
+{
+  "code": 200,          // int — HttpStatus 枚举值
+  "message": "操作成功", // String — 提示信息
+  "data": T              // 泛型 — 业务数据
+}
+```

package/builtin/schemas/mes-crud-module/templates/design.md

@@ -0,0 +1,422 @@
+# MES CRUD 模块设计: {{Entity}}
+
+> 模块: {{module}} | 业务中心: {{module}}-center | 表: {{table_name}}
+
+---
+
+## 1. 数据库设计（Oracle）
+
+### 建表 SQL
+
+```sql
+CREATE TABLE {{table_name}} (
+  id                    NUMBER(19)      NOT NULL,
+  -- ============================================================
+  -- 业务字段（根据提案中的字段清单补充）
+  -- ============================================================
+  is_effect             NUMBER(1)       DEFAULT 1,
+  -- ============================================================
+  -- 审计字段（BaseModel / TimeModel 自动填充）
+  -- ============================================================
+  created_by            VARCHAR2(64)    DEFAULT '',
+  created_date          TIMESTAMP       DEFAULT SYSTIMESTAMP,
+  last_updated_by       VARCHAR2(64)    DEFAULT '',
+  last_updated_date     TIMESTAMP       DEFAULT SYSTIMESTAMP,
+  -- ============================================================
+  CONSTRAINT pk_{{table_name}} PRIMARY KEY (id)
+);
+
+COMMENT ON TABLE {{table_name}} IS '{{table_comment}}';
+-- COMMENT ON COLUMN {{table_name}}.xxx IS 'xxx';
+
+-- 雪花算法 ID 序列（可选，若由应用层生成则不需要）
+-- CREATE SEQUENCE seq_{{table_name}} START WITH 1 INCREMENT BY 1 NOCACHE;
+```
+
+---
+
+## 2. 后端代码结构
+
+### 目录布局
+
+```
+modules-center/{{module}}-center/{{module}}-service/
+└── src/main/java/com/twsz/mom/{{module}}/
+    ├── controller/
+    │   └── {{Entity}}Controller.java
+    ├── service/
+    │   ├── {{Entity}}Service.java
+    │   └── impl/
+    │       └── {{Entity}}ServiceImpl.java
+    ├── mapper/
+    │   └── {{Entity}}Mapper.java
+    └── model/
+        └── {{Entity}}.java
+
+└── src/main/resources/
+    └── mapper/
+        └── {{Entity}}Mapper.xml
+```
+
+### Entity（继承 BaseModel）
+
+```java
+@Data
+@EqualsAndHashCode(callSuper = true)
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@TableName("{{table_name}}")
+public class {{Entity}} extends BaseModel {
+    // 业务字段（审计字段由 BaseModel → TimeModel 提供）
+    private Integer isEffect;
+    // ... 根据提案补充
+}
+```
+
+> **BaseModel 继承链**: `ViewModel`（fields/columns/orderBy/动态查询）→ `TimeModel`（审计字段自动填充）→ `BaseModel`（id 雪花算法）
+
+### Mapper（继承 BaseMapper）
+
+```java
+@Mapper
+public interface {{Entity}}Mapper extends BaseMapper<{{Entity}}> {
+    IPage<{{Entity}}> pageSearch(Page<{{Entity}}> page, @Param("entity") {{Entity}} entity);
+    List<{{Entity}}> list(@Param("entity") {{Entity}} entity);
+}
+```
+
+### Mapper XML（标准片段模板）
+
+```xml
+<mapper namespace="com.twsz.mom.{{module}}.mapper.{{Entity}}Mapper">
+    <resultMap id="BaseResultMap" type="com.twsz.mom.{{module}}.model.{{Entity}}"/>
+
+    <!-- 动态列（支持 ViewModel.fields 部分列查询） -->
+    <sql id="{{Entity}}Columns">
+        <choose>
+            <when test="entity.fields != null">
+                <foreach collection="entity.columns" item="it" separator=",">t.${it}</foreach>
+            </when>
+            <otherwise>t.*</otherwise>
+        </choose>
+    </sql>
+
+    <!-- 动态 WHERE（每个字段一个 if 判断） -->
+    <sql id="{{Entity}}Where">
+        <where>
+            <if test="entity.id != null">AND t.id = #{entity.id}</if>
+            <if test="entity.isEffect != null">AND t.is_effect = #{entity.isEffect}</if>
+            <!-- 根据字段清单补充 -->
+        </where>
+        <choose>
+            <when test="entity.orderBy != null and entity.orderBy != ''">
+                ORDER BY t.${entity.orderBy}
+            </when>
+            <otherwise>ORDER BY t.id DESC</otherwise>
+        </choose>
+    </sql>
+
+    <sql id="{{Entity}}Joins"></sql>
+
+    <select id="pageSearch" resultMap="BaseResultMap">
+        SELECT <include refid="{{Entity}}Columns"/>
+        FROM {{table_name}} t
+        <include refid="{{Entity}}Joins"/>
+        <include refid="{{Entity}}Where"/>
+    </select>
+
+    <select id="list" resultMap="BaseResultMap">
+        SELECT * FROM (
+            SELECT <include refid="{{Entity}}Columns"/>
+            FROM {{table_name}} t
+            <include refid="{{Entity}}Joins"/>
+            <include refid="{{Entity}}Where"/>
+        ) tt WHERE rownum &lt;=
+        <choose>
+            <when test="entity.rowNum != null">#{entity.rowNum}</when>
+            <otherwise>10000</otherwise>
+        </choose>
+    </select>
+</mapper>
+```
+
+### Service 接口
+
+```java
+public interface {{Entity}}Service extends IService<{{Entity}}> {
+    ResponseWrapper<String> insert({{Entity}} entity);
+    ResponseWrapper<String> update({{Entity}} entity);
+    ResponseWrapper<String> deleteByIds(Collection<Long> ids);
+    ResponseWrapper<Page<{{Entity}}>> search(PageForm<{{Entity}}> pageForm);
+    List<{{Entity}}> list({{Entity}} entity);
+}
+```
+
+### Service 实现
+
+```java
+@Slf4j
+@Service
+public class {{Entity}}ServiceImpl extends ServiceImpl<{{Entity}}Mapper, {{Entity}}>
+        implements {{Entity}}Service {
+
+    @Override
+    public ResponseWrapper<String> insert({{Entity}} entity) {
+        if (super.save(entity)) {
+            return ResponseWrapper.defaultSuccess();
+        }
+        return ResponseWrapper.ofStatus(HttpStatus.OBJECT_INSERT_FAIL);
+    }
+
+    @Override
+    public ResponseWrapper<String> update({{Entity}} entity) {
+        if (super.updateById(entity)) {
+            return ResponseWrapper.defaultSuccess();
+        }
+        return ResponseWrapper.ofStatus(HttpStatus.OBJECT_UPDATE_FAIL);
+    }
+
+    @Override
+    public ResponseWrapper<String> deleteByIds(Collection<Long> ids) {
+        if (super.removeByIds(ids)) {
+            return ResponseWrapper.defaultSuccess();
+        }
+        return ResponseWrapper.ofStatus(HttpStatus.OBJECT_DELETE_FAIL);
+    }
+
+    @Override
+    public ResponseWrapper<Page<{{Entity}}>> search(PageForm<{{Entity}}> pageForm) {
+        Page<{{Entity}}> p = new Page<>(pageForm.getCurrent(), pageForm.getSize());
+        baseMapper.pageSearch(p, pageForm.getCondition());
+        return ResponseWrapper.ofSuccess(p);
+    }
+
+    @Override
+    public List<{{Entity}}> list({{Entity}} entity) {
+        return baseMapper.list(entity);
+    }
+}
+```
+
+### Controller
+
+```java
+@Slf4j
+@RestController
+@RequestMapping("/{{entity}}")
+public class {{Entity}}Controller {
+
+    @Resource
+    private {{Entity}}Service {{entity}}Service;
+
+    @PostMapping(value = "add")
+    public ResponseWrapper<String> add(@RequestBody {{Entity}} entity) {
+        return {{entity}}Service.insert(entity);
+    }
+
+    @PutMapping(value = "update")
+    public ResponseWrapper<String> update(@RequestBody {{Entity}} entity) {
+        return {{entity}}Service.update(entity);
+    }
+
+    @PostMapping(value = "search")
+    public ResponseWrapper<Page<{{Entity}}>> search(@RequestBody PageForm<{{Entity}}> pageForm) {
+        return {{entity}}Service.search(pageForm);
+    }
+
+    @DeleteMapping(value = "delete")
+    public ResponseWrapper<String> delete(@RequestBody Long[] ids) {
+        return {{entity}}Service.deleteByIds(Arrays.asList(ids));
+    }
+
+    @GetMapping(value = "get/{id}")
+    public ResponseWrapper<{{Entity}}> get(@PathVariable Long id) {
+        return ResponseWrapper.ofSuccess({{entity}}Service.getById(id));
+    }
+
+    @PostMapping(value = "list")
+    public ResponseWrapper<List<{{Entity}}>> list(@RequestBody {{Entity}} entity) {
+        return ResponseWrapper.ofSuccess({{entity}}Service.list(entity));
+    }
+
+    @PostMapping(value = "export")
+    public void export(@RequestBody {{Entity}} condition, HttpServletResponse response) throws IOException {
+        // EasyExcel 导出
+    }
+}
+```
+
+---
+
+## 3. 前端代码结构
+
+### 目录布局
+
+```
+src/
+├── api/{{domain}}/
+│   └── {{entity}}.js
+└── views/{{domain}}/{{entity}}/
+    ├── index.vue          # 列表页
+    └── {{entity}}-form.vue  # 表单页
+```
+
+### API 接口文件
+
+```js
+import axios from '@/libs/request'
+import { exportExcel } from '../file'
+
+const apiPrefix = '/{{entity}}'
+
+const search{{Entity}} = data => {
+    return axios.request({ url: `${apiPrefix}/search`, method: 'POST', data })
+}
+
+const save{{Entity}} = data => {
+    const url = data.id ? `${apiPrefix}/update` : `${apiPrefix}/add`
+    const method = data.id ? 'PUT' : 'POST'
+    return axios.request({ url, method, data })
+}
+
+const delete{{Entity}} = ids => {
+    return axios.request({
+        url: `${apiPrefix}/delete`,
+        method: 'DELETE',
+        data: Array.isArray(ids) ? ids : [ids]
+    })
+}
+
+const list{{Entity}} = data => {
+    return axios.request({ url: `${apiPrefix}/list`, method: 'POST', data })
+}
+
+const export{{Entity}} = data => {
+    return exportExcel(`${apiPrefix}/export`, data)
+}
+
+export default { search{{Entity}}, save{{Entity}}, delete{{Entity}}, list{{Entity}}, export{{Entity}} }
+```
+
+### 列表页（index.vue）
+
+```vue
+<template>
+    <div class="master-index">
+        <search-table v-show="showIndexPage" ref="searchTable" :option="option" :columns="tableColumns">
+            <template #condition-form>
+                <Form ref="conditionForm" class="search-condition-form" label-colon @keyup.enter.native="refresh">
+                    <!-- 搜索条件表单字段 -->
+                </Form>
+            </template>
+        </search-table>
+        <tw-card v-show="!showIndexPage" :back="triggerBack">
+            <{{Entity}}Form :readonly="readonly" :form="formData" :key="instanceKey"
+                @on-success="handleSuccess" />
+        </tw-card>
+    </div>
+</template>
+
+<script>
+import { indexPage } from '_c/table-form/index-mixin'
+import {{Entity}}Api from '@/api/{{domain}}/{{entity}}'
+import {{Entity}}Form from './{{entity}}-form'
+
+export default {
+    mixins: [indexPage],
+    components: { {{Entity}}Form },
+    data() {
+        return {
+            option: {
+                tableName: '{{entity}}',
+                searchForm: {},
+                fixedTableHeight: true,
+                add:    { enable: true, method: this.add },
+                edit:   { enable: true, method: this.edit },
+                view:   { enable: true, method: this.view },
+                delete: { enable: true, method: {{Entity}}Api.delete{{Entity}} },
+                export: { enable: true, method: {{Entity}}Api.export{{Entity}} },
+                search: { query: {{Entity}}Api.search{{Entity}} },
+            },
+            tableColumns: [
+                { type: 'selection' },
+                // 表格列定义
+                { title: this.$t('operate||操作'), slot: 'operate' }
+            ]
+        }
+    }
+}
+</script>
+```
+
+### 表单页（{{entity}}-form.vue）
+
+```vue
+<template>
+    <master-sub :readonly="readonly">
+        <template v-if="!readonly" #master-header-toolbar>
+            <Button type="primary" :loading="loading" @click="doSubmit">{{ $t('submit||提交') }}</Button>
+        </template>
+        <template #master-form>
+            <Form ref="mform" :model="mform" :label-width="120" :disabled="readonly" class="form">
+                <!-- 表单字段 -->
+            </Form>
+        </template>
+    </master-sub>
+</template>
+
+<script>
+import { BaseMixin } from '@/mixin'
+import {{Entity}}Api from '@/api/{{domain}}/{{entity}}'
+
+export default {
+    mixins: [BaseMixin],
+    props: {
+        readonly: { type: Boolean, default: false },
+        form: { type: Object, default: () => ({}) }
+    },
+    data() { return { mform: {}, default: {} } },
+    created() {
+        this.mform = Object.assign({}, this.default, this.form)
+    },
+    methods: {
+        doSubmit() {
+            this.$refs.mform.validate(valid => {
+                if (valid) {
+                    this.asyncLoading({{Entity}}Api.save{{Entity}}(this.mform)).then(res => {
+                        this.$Message.success({ background: true, content: this.$t('submit.success||提交成功') })
+                        this.$emit('on-success', this.mform)
+                    })
+                }
+            })
+        }
+    }
+}
+</script>
+```
+
+---
+
+## 4. 接口定义
+
+| Method | Path | 描述 | 请求体 | 响应 |
+|--------|------|------|--------|------|
+| POST | /{{entity}}/search | 分页查询 | `PageForm<{{Entity}}>` | `ResponseWrapper<Page<{{Entity}}>>` |
+| POST | /{{entity}}/add | 新增 | `{{Entity}}` | `ResponseWrapper<String>` |
+| PUT | /{{entity}}/update | 修改 | `{{Entity}}` | `ResponseWrapper<String>` |
+| DELETE | /{{entity}}/delete | 批量删除 | `Long[]` | `ResponseWrapper<String>` |
+| GET | /{{entity}}/get/{id} | 详情 | — | `ResponseWrapper<{{Entity}}>` |
+| POST | /{{entity}}/list | 不分页列表 | `{{Entity}}` | `ResponseWrapper<List<{{Entity}}>>` |
+| POST | /{{entity}}/export | Excel 导出 | `{{Entity}}` | Excel 文件流 |
+
+---
+
+## 5. 前后端分工
+
+| 功能 | 前端 | 后端 |
+|------|------|------|
+| 列表页 | search-table + indexPage mixin | POST /search（PageForm 分页） |
+| 新增 | master-sub 表单 + save（无 id → add） | POST /add |
+| 编辑 | master-sub 表单 + save（有 id → update） | PUT /update |
+| 删除 | 确认弹窗 + delete(ids) | DELETE /delete |
+| 导出 | exportExcel Blob 下载 | POST /export（EasyExcel） |
+| 菜单 | 动态路由（后端返回 component 路径） | c_sys_resource 注册 |

package/builtin/schemas/mes-crud-module/templates/menu-register.md

@@ -0,0 +1,126 @@
+# 菜单注册: {{Entity}}
+
+> 模块: {{module}} | 实体: {{Entity}} | 组件路径: `{{domain}}/{{entity}}/index`
+
+---
+
+## 1. 菜单配置
+
+| 配置项 | 值 | 说明 |
+|--------|-----|------|
+| 菜单名称 | {{moduleName}} | 显示在侧边栏的名称 |
+| 父级菜单 | 根据实际选择 | c_sys_resource.pid |
+| 排序 | 100 | 同级菜单排序 |
+| 图标 | ios-folder | ViewUI 图标名称 |
+| 路由路径 | /{{domain}}/{{entity}} | 前端路由 |
+| 组件路径 | {{domain}}/{{entity}}/index | Vue 组件路径（相对 src/views/） |
+
+---
+
+## 2. c_sys_resource 表结构
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | bigint | 主键（雪花算法） |
+| title | varchar | 菜单/按钮显示名称 |
+| pid | bigint | 父级 ID（0 = 顶级） |
+| sort | int | 排序号 |
+| enable | int | 1=启用 |
+| type | int | 1=路由菜单, 2=按钮权限, 3=API 资源 |
+| path | varchar | URL 路径 |
+| component | varchar | Vue 组件路径 |
+| icon | varchar | 图标 |
+| permission | varchar | 权限标识 |
+
+---
+
+## 3. SQL 插入语句
+
+```sql
+-- ============================================================
+-- 菜单注册（c_sys_resource）
+-- ============================================================
+
+-- 1. 菜单项（type=1 路由菜单）
+-- 请先确认父级菜单 ID（替换下面的 @parentId）
+-- 可通过 SELECT id FROM c_sys_resource WHERE title = '父级菜单名' 获取
+
+INSERT INTO c_sys_resource (id, title, pid, sort, enable, type, path, component, icon, permission, created_by, created_date, last_updated_by, last_updated_date)
+VALUES (
+  -- id: 使用雪花算法生成，或手动指定一个不冲突的大数字
+  {{menu_id}},                    -- 菜单 ID（需唯一）
+  '{{moduleName}}',               -- 菜单名称
+  {{parent_id}},                  -- 父级菜单 ID（0=顶级）
+  100,                            -- 排序号
+  1,                              -- 启用
+  1,                              -- type=1 路由菜单
+  '/{{domain}}/{{entity}}',       -- 路由路径
+  '{{domain}}/{{entity}}/index',  -- 组件路径
+  'ios-folder',                   -- 图标
+  '{{module}}:{{entity}}:view',   -- 权限标识
+  'admin',
+  SYSTIMESTAMP,
+  'admin',
+  SYSTIMESTAMP
+);
+
+-- 2. 按钮权限（type=2 按钮）
+-- @menuId 替换为上面插入的菜单 ID
+
+INSERT INTO c_sys_resource (id, title, pid, sort, enable, type, path, component, icon, permission, created_by, created_date, last_updated_by, last_updated_date)
+VALUES
+-- 查询按钮
+({{menu_id}} + 1, '{{moduleName}}查询', {{menu_id}}, 1, 1, 2, '#', '', '', '{{module}}:{{entity}}:view', 'admin', SYSTIMESTAMP, 'admin', SYSTIMESTAMP),
+-- 新增按钮
+({{menu_id}} + 2, '{{moduleName}}新增', {{menu_id}}, 2, 1, 2, '#', '', '', '{{module}}:{{entity}}:add', 'admin', SYSTIMESTAMP, 'admin', SYSTIMESTAMP),
+-- 修改按钮
+({{menu_id}} + 3, '{{moduleName}}修改', {{menu_id}}, 3, 1, 2, '#', '', '', '{{module}}:{{entity}}:edit', 'admin', SYSTIMESTAMP, 'admin', SYSTIMESTAMP),
+-- 删除按钮
+({{menu_id}} + 4, '{{moduleName}}删除', {{menu_id}}, 4, 1, 2, '#', '', '', '{{module}}:{{entity}}:delete', 'admin', SYSTIMESTAMP, 'admin', SYSTIMESTAMP),
+-- 导出按钮
+({{menu_id}} + 5, '{{moduleName}}导出', {{menu_id}}, 5, 1, 2, '#', '', '', '{{module}}:{{entity}}:export', 'admin', SYSTIMESTAMP, 'admin', SYSTIMESTAMP);
+```
+
+---
+
+## 4. 权限标识
+
+| 权限标识 | 描述 | 前端使用方式 |
+|---------|------|-------------|
+| `{{module}}:{{entity}}:view` | 查看 | `v-hasPerm="'{{module}}:{{entity}}:view'"` |
+| `{{module}}:{{entity}}:add` | 新增 | `v-hasPerm="'{{module}}:{{entity}}:add'"` |
+| `{{module}}:{{entity}}:edit` | 修改 | `v-hasPerm="'{{module}}:{{entity}}:edit'"` |
+| `{{module}}:{{entity}}:delete` | 删除 | `v-hasPerm="'{{module}}:{{entity}}:delete'"` |
+| `{{module}}:{{entity}}:export` | 导出 | `v-hasPerm="'{{module}}:{{entity}}:export'"` |
+
+---
+
+## 5. 前端路由（参考）
+
+> MES 项目使用动态路由：后端通过 `c_sys_resource` 返回路由配置，前端通过 `router.addRoutes()` 注册。
+> 以下仅为参考，实际路由由后端 `GET /resource/listTreeByUser` 接口返回。
+
+```javascript
+// 后端返回的路由数据结构（resources）
+{
+  title: '{{moduleName}}',
+  path: '/{{domain}}/{{entity}}',
+  component: '{{domain}}/{{entity}}/index',  // 前端 import.meta.glob 解析
+  icon: 'ios-folder',
+  permission: '{{module}}:{{entity}}:view',
+}
+```
+
+---
+
+## 6. 刷新缓存
+
+执行 SQL 后，需要刷新 Redis 中的资源缓存：
+
+```bash
+# 通过 API 刷新
+curl -X GET http://localhost:8000/api/sys/resource/reloadCache \
+  -H "Authorization: Bearer <token>"
+```
+
+> **注意**: 执行 SQL 前请先确认 `pid` 的值（根据实际父级菜单调整），菜单 ID 需确保全局唯一。

package/builtin/schemas/mes-crud-module/templates/proposal.md

@@ -0,0 +1,64 @@
+# MES CRUD 模块提案
+
+## 模块信息
+
+| 配置项 | 值 |
+|--------|-----|
+| 模块名称 | {{moduleName}} |
+| 所属业务中心 | modules-center/{{module}}-center |
+| 后端包名 | com.twsz.mom.{{module}} |
+| 前端域 | src/views/{{domain}}/ |
+
+## 核心实体
+
+| 配置项 | 值 |
+|--------|-----|
+| 实体类名 | {{Entity}} |
+| 表名 | {{table_name}} |
+| 表注释 | {{table_comment}} |
+| 描述 | {{description}} |
+
+## CRUD 操作
+
+- [ ] 分页查询（POST /{{entity}}/search）
+- [ ] 详情查询（GET /{{entity}}/get/{id}）
+- [ ] 新增（POST /{{entity}}/add）
+- [ ] 修改（PUT /{{entity}}/update）
+- [ ] 批量删除（DELETE /{{entity}}/delete）
+- [ ] 不分页列表（POST /{{entity}}/list）
+- [ ] Excel 导出（POST /{{entity}}/export）
+
+## 字段清单
+
+| 字段名 | 数据库列名 | Oracle 类型 | Java 类型 | 必填 | 说明 |
+|--------|-----------|-------------|-----------|------|------|
+| id | id | NUMBER(19) | Long | 自动 | 主键（雪花算法，BaseModel 提供） |
+| — | created_by | VARCHAR2(64) | String | 自动 | 创建人（TimeModel 提供） |
+| — | created_date | TIMESTAMP | LocalDateTime | 自动 | 创建时间（TimeModel 提供） |
+| — | last_updated_by | VARCHAR2(64) | String | 自动 | 更新人（TimeModel 提供） |
+| — | last_updated_date | TIMESTAMP | LocalDateTime | 自动 | 更新时间（TimeModel 提供） |
+| | | | | | |
+| is_effect | is_effect | NUMBER(1) | Integer | 是 | 启用状态（1=启用, 0=停用） |
+
+> 请补充业务字段。审计字段（created_by 等）和主键（id）由 BaseModel 自动提供，无需在 Entity 中声明。
+
+## 业务规则
+
+1. 
+2. 
+3. 
+
+## 查询条件
+
+| 字段 | 查询方式 | 说明 |
+|------|---------|------|
+| | LIKE / = / BETWEEN / IN | |
+
+## 非目标
+
+- 不包含: 
+
+## 关联模块
+
+- 依赖: 
+- 被依赖: 

package/builtin/schemas/mes-crud-module/templates/spec.md

@@ -0,0 +1,94 @@
+# MES CRUD 接口规范: {{Entity}}
+
+> 模块: {{module}} | 实体: {{Entity}} | 表: {{table_name}}
+
+## ADDED Requirements
+
+### API-001: 分页查询
+系统应当提供 `POST /{{entity}}/search` 接口，接收 `PageForm<{{Entity}}>` 请求体，返回分页结果。
+
+**验收标准:**
+- **Given** 数据库中存在 {{Entity}} 记录
+- **When** 用户请求 `POST /{{entity}}/search`，请求体为 `{ "size": 20, "current": 1, "condition": {} }`
+- **Then** 返回 `ResponseWrapper<Page<{{Entity}}>>`，包含 records 数组和 total 总数
+
+### API-002: 详情查询
+系统应当提供 `GET /{{entity}}/get/{id}` 接口。
+
+**验收标准:**
+- **Given** 存在 ID 为 1 的记录
+- **When** 用户请求 `GET /{{entity}}/get/1`
+- **Then** 返回 `ResponseWrapper<{{Entity}}>`，data 为该记录详情
+
+### API-003: 新增
+系统应当提供 `POST /{{entity}}/add` 接口，接收实体 JSON。
+
+**验收标准:**
+- **Given** 用户提供必填字段，请求体为合法的 {{Entity}} JSON
+- **When** 用户请求 `POST /{{entity}}/add`
+- **Then** 创建记录（雪花 ID 自动生成，审计字段自动填充），返回 `ResponseWrapper<String>` 成功
+
+### API-004: 修改
+系统应当提供 `PUT /{{entity}}/update` 接口。
+
+**验收标准:**
+- **Given** 存在待修改的记录
+- **When** 用户请求 `PUT /{{entity}}/update`，请求体包含 id 和修改字段
+- **Then** 更新记录（last_updated_by/last_updated_date 自动更新），返回 `ResponseWrapper<String>` 成功
+
+### API-005: 批量删除
+系统应当提供 `DELETE /{{entity}}/delete` 接口，接收 ID 数组。
+
+**验收标准:**
+- **Given** 存在待删除的记录
+- **When** 用户请求 `DELETE /{{entity}}/delete`，请求体为 `[1, 2, 3]`
+- **Then** 删除指定记录，返回 `ResponseWrapper<String>` 成功
+
+### API-006: 不分页列表
+系统应当提供 `POST /{{entity}}/list` 接口。
+
+**验收标准:**
+- **Given** 数据库中存在匹配记录
+- **When** 用户请求 `POST /{{entity}}/list`
+- **Then** 返回 `ResponseWrapper<List<{{Entity}}>>`（限制最多 10000 条）
+
+### API-007: Excel 导出
+系统应当提供 `POST /{{entity}}/export` 接口。
+
+**验收标准:**
+- **Given** 存在可导出的记录
+- **When** 用户请求 `POST /{{entity}}/export`
+- **Then** 返回 Excel 文件流（EasyExcel），文件名包含模块名
+
+---
+
+## 前端接口规范
+
+### FE-001: API 接口文件
+系统应当在 `src/api/{{domain}}/{{entity}}.js` 中封装以下方法：
+- `search{{Entity}}(data)` — POST /{{entity}}/search
+- `save{{Entity}}(data)` — POST /{{entity}}/add 或 PUT /{{entity}}/update（根据是否有 id 判断）
+- `delete{{Entity}}(ids)` — DELETE /{{entity}}/delete
+- `list{{Entity}}(data)` — POST /{{entity}}/list
+- `export{{Entity}}(data)` — POST /{{entity}}/export
+
+**验收标准:**
+- **Given** API 文件已创建
+- **When** 前端页面调用 API 方法
+- **Then** 正确发送 HTTP 请求并返回 Promise
+
+### FE-002: 列表页
+系统应当在 `src/views/{{domain}}/{{entity}}/index.vue` 中实现列表页。
+
+**验收标准:**
+- **Given** 用户有查看权限
+- **When** 用户访问列表页
+- **Then** 展示搜索条件表单 + 数据表格 + 分页，支持新增/编辑/查看/删除/导出操作
+
+### FE-003: 表单页
+系统应当在 `src/views/{{domain}}/{{entity}}/{{entity}}-form.vue` 中实现表单页。
+
+**验收标准:**
+- **Given** 用户点击新增或编辑按钮
+- **When** 表单页展示
+- **Then** 展示可编辑表单，必填字段有验证规则，提交后返回列表

package/builtin/schemas/mes-crud-module/templates/tasks.md

@@ -0,0 +1,208 @@
+# MES CRUD 任务列表: {{Entity}}
+
+## 全局约束
+
+- 后端: `modules-center/{{module}}-center/{{module}}-service/`
+- 前端: `implat-ui/src/`
+- 数据库: Oracle
+- 分支: `feature/{{entity}}-crud`
+
+---
+
+## 后端任务
+
+### Task-001: 建表 SQL（Oracle）
+
+- 文件: `sql/{{table_name}}.sql`
+- 依赖: 无
+- 描述: 创建数据库表，字段与提案中的字段清单对应
+- 代码模板:
+
+```sql
+CREATE TABLE {{table_name}} (
+  id                    NUMBER(19)      NOT NULL,
+  -- 业务字段（根据提案补充）
+  is_effect             NUMBER(1)       DEFAULT 1,
+  created_by            VARCHAR2(64)    DEFAULT '',
+  created_date          TIMESTAMP       DEFAULT SYSTIMESTAMP,
+  last_updated_by       VARCHAR2(64)    DEFAULT '',
+  last_updated_date     TIMESTAMP       DEFAULT SYSTIMESTAMP,
+  CONSTRAINT pk_{{table_name}} PRIMARY KEY (id)
+);
+COMMENT ON TABLE {{table_name}} IS '{{table_comment}}';
+```
+
+- 验证: SQL 可在 Oracle 客户端执行
+
+### Task-002: 创建 Entity 实体类
+
+- 文件: `modules-center/{{module}}-center/{{module}}-service/src/main/java/com/twsz/mom/{{module}}/model/{{Entity}}.java`
+- 依赖: Task-001
+- 描述: 继承 `BaseModel`，声明业务字段。审计字段（createdBy 等）和主键（id）由 BaseModel 自动提供。
+- 代码模板:
+
+```java
+package com.twsz.mom.{{module}}.model;
+
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.twsz.mom.common.ds.model.BaseModel;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+@Data
+@EqualsAndHashCode(callSuper = true)
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@TableName("{{table_name}}")
+public class {{Entity}} extends BaseModel {
+    // 业务字段（审计字段由 BaseModel → TimeModel 提供）
+    private Integer isEffect;
+    // ... 根据提案中的字段清单补充
+}
+```
+
+- 验证: 编译通过
+
+### Task-003: 创建 Mapper 接口 + XML
+
+- 文件:
+  - `modules-center/{{module}}-center/{{module}}-service/src/main/java/com/twsz/mom/{{module}}/mapper/{{Entity}}Mapper.java`
+  - `modules-center/{{module}}-center/{{module}}-service/src/main/resources/mapper/{{Entity}}Mapper.xml`
+- 依赖: Task-002
+- 描述: 继承 `BaseMapper<{{Entity}}>`，XML 包含标准的 Columns/Where/Joins 片段
+- 代码模板（Mapper 接口）:
+
+```java
+package com.twsz.mom.{{module}}.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.baomidou.mybatisplus.core.metadata.IPage;
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.twsz.mom.{{module}}.model.{{Entity}};
+import org.apache.ibatis.annotations.Mapper;
+import org.apache.ibatis.annotations.Param;
+import java.util.List;
+
+@Mapper
+public interface {{Entity}}Mapper extends BaseMapper<{{Entity}}> {
+    IPage<{{Entity}}> pageSearch(Page<{{Entity}}> page, @Param("entity") {{Entity}} entity);
+    List<{{Entity}}> list(@Param("entity") {{Entity}} entity);
+}
+```
+
+- 代码模板（XML）: 参见 design.md 中的标准 XML 模板
+- 验证: 编译通过，namespace 与 Mapper 接口全限定名匹配
+
+### Task-004: 创建 Service 接口 + 实现
+
+- 文件:
+  - `modules-center/{{module}}-center/{{module}}-service/src/main/java/com/twsz/mom/{{module}}/service/{{Entity}}Service.java`
+  - `modules-center/{{module}}-center/{{module}}-service/src/main/java/com/twsz/mom/{{module}}/service/impl/{{Entity}}ServiceImpl.java`
+- 依赖: Task-003
+- 描述: 继承 `IService<{{Entity}}>` / `ServiceImpl<Mapper, Entity>`，实现标准 CRUD 方法
+- 代码模板: 参见 design.md 中的 Service 模板
+- 验证: 编译通过
+
+### Task-005: 创建 Controller
+
+- 文件: `modules-center/{{module}}-center/{{module}}-service/src/main/java/com/twsz/mom/{{module}}/controller/{{Entity}}Controller.java`
+- 依赖: Task-004
+- 描述: `@RestController`，`@RequestMapping("/{{entity}}")`，返回 `ResponseWrapper<T>`
+- 代码模板: 参见 design.md 中的 Controller 模板
+- 验证: 编译通过，启动后可访问接口
+
+---
+
+## 前端任务
+
+### Task-006: 创建 API 接口文件
+
+- 文件: `implat-ui/src/api/{{domain}}/{{entity}}.js`
+- 依赖: Task-005
+- 描述: 封装 search/save/delete/list/export 五个标准方法
+- 代码模板:
+
+```js
+import axios from '@/libs/request'
+import { exportExcel } from '../file'
+
+const apiPrefix = '/{{entity}}'
+
+const search{{Entity}} = data =>
+    axios.request({ url: `${apiPrefix}/search`, method: 'POST', data })
+
+const save{{Entity}} = data => {
+    const url = data.id ? `${apiPrefix}/update` : `${apiPrefix}/add`
+    const method = data.id ? 'PUT' : 'POST'
+    return axios.request({ url, method, data })
+}
+
+const delete{{Entity}} = ids =>
+    axios.request({ url: `${apiPrefix}/delete`, method: 'DELETE', data: Array.isArray(ids) ? ids : [ids] })
+
+const list{{Entity}} = data =>
+    axios.request({ url: `${apiPrefix}/list`, method: 'POST', data })
+
+const export{{Entity}} = data =>
+    exportExcel(`${apiPrefix}/export`, data)
+
+export default { search{{Entity}}, save{{Entity}}, delete{{Entity}}, list{{Entity}}, export{{Entity}} }
+```
+
+- 验证: 无语法错误
+
+### Task-007: 创建列表页
+
+- 文件: `implat-ui/src/views/{{domain}}/{{entity}}/index.vue`
+- 依赖: Task-006
+- 描述: 使用 `indexPage` mixin + `<search-table>` 组件，配置 option 对象和 tableColumns
+- 代码模板: 参见 design.md 中的列表页模板
+- 关键约定:
+  - `mixins: [indexPage]` — 提供 showIndexPage/add/edit/view/refresh/triggerBack
+  - `option.search.query` — 绑定 API search 方法
+  - `option.delete.method` — 绑定 API delete 方法
+  - `$t('key||中文')` — i18n 格式
+- 验证: 页面可渲染，表格可加载数据
+
+### Task-008: 创建表单页
+
+- 文件: `implat-ui/src/views/{{domain}}/{{entity}}/{{entity}}-form.vue`
+- 依赖: Task-006
+- 描述: 使用 `<master-sub>` 组件 + `BaseMixin`，实现新增/编辑表单
+- 代码模板: 参见 design.md 中的表单页模板
+- 关键约定:
+  - `mixins: [BaseMixin]` — 提供 loading/asyncLoading
+  - `this.$refs.mform.validate()` — 表单验证
+  - `this.$emit('on-success', data)` — 提交成功回调
+  - `class="form"` — 自动两列布局
+- 验证: 表单验证生效，提交成功返回列表
+
+### Task-009: 菜单注册
+
+- 文件: `sql/menu_{{entity}}.sql`
+- 依赖: Task-008
+- 描述: 向 `c_sys_resource` 表插入菜单和按钮权限记录
+- 代码模板: 参见 menu-register.md
+- 权限标识:
+  - `{{module}}:{{entity}}:view` — 查看
+  - `{{module}}:{{entity}}:add` — 新增
+  - `{{module}}:{{entity}}:edit` — 修改
+  - `{{module}}:{{entity}}:delete` — 删除
+  - `{{module}}:{{entity}}:export` — 导出
+- 验证: 执行 SQL 后刷新缓存，菜单可见
+
+---
+
+## 任务依赖图
+
+```
+Task-001 (建表)
+  └─ Task-002 (Entity)
+       └─ Task-003 (Mapper + XML)
+            └─ Task-004 (Service)
+                 └─ Task-005 (Controller)
+                      └─ Task-006 (API 接口)
+                           ├─ Task-007 (列表页)
+                           └─ Task-008 (表单页)
+                                └─ Task-009 (菜单注册)
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specpow/framework",
-  "version": "0.5.21",
+  "version": "0.5.22",
   "description": "Spec-Powered AI Development Framework - 融合 OpenSpec 规范驱动 + Superpowers 执行引擎的企业级 AI 辅助编程框架",
   "type": "module",
   "main": "dist/index.js",