@specpow/framework 0.5.21 → 0.5.23

package/builtin/schemas/mes-prd-to-code/templates/code-generation.md

@@ -0,0 +1,81 @@
+# 代码生成报告: <功能名称>
+
+> 输入: 任务清单 (tasks.md)
+> 生成日期: <日期>
+
+---
+
+## 执行摘要
+
+| 维度 | 数量 |
+|------|:----:|
+| 总任务数 | |
+| 已完成 | |
+| 跳过 | |
+| 失败 | |
+
+---
+
+## 文件清单
+
+### 后端文件
+
+| # | 任务 | 文件路径 | 状态 |
+|:-:|------|----------|:----:|
+| 1 | Task-002 | `modules-center/.../model/{Entity}.java` | ✅ / ❌ |
+| 2 | Task-003 | `.../mapper/{Entity}Mapper.java` | |
+| 3 | Task-004 | `resources/mapper/{module}/{Entity}Mapper.xml` | |
+| 4 | Task-005 | `.../service/{Entity}Service.java` | |
+| 5 | Task-006 | `.../service/impl/{Entity}ServiceImpl.java` | |
+| 6 | Task-007 | `.../controller/{Entity}Controller.java` | |
+
+### 前端文件
+
+| # | 任务 | 文件路径 | 状态 |
+|:-:|------|----------|:----:|
+| 7 | Task-008 | `src/api/{domain}/{entity}.js` | ✅ / ❌ |
+| 8 | Task-009 | `src/views/{domain}/{entity}/index.vue` | |
+| 9 | Task-010 | `src/views/{domain}/{entity}/{entity}-form.vue` | |
+
+### SQL 文件
+
+| # | 任务 | 文件路径 | 状态 |
+|:-:|------|----------|:----:|
+| 10 | Task-001 | 建表 DDL | ✅ / ⏳ 待手动执行 |
+| 11 | Task-011 | 菜单注册 SQL | ✅ / ⏳ 待手动执行 |
+
+---
+
+## 需要手动执行的操作
+
+| # | 操作 | SQL / 命令 | 说明 |
+|:-:|------|-----------|------|
+| 1 | 建表 | `<DDL>` | 在 Oracle 中执行 |
+| 2 | 菜单注册 | `<INSERT>` | 在 Oracle 中执行 |
+| 3 | 重启后端 | — | 加载新代码 |
+| 4 | 重启前端 | — | 加载新页面 |
+
+---
+
+## 代码规范检查
+
+| 检查项 | 状态 | 说明 |
+|--------|:----:|------|
+| Java 8 语法 | ✅ | 未使用 Java 9+ 特性 |
+| Lombok 注解 | ✅ | @Data, @EqualsAndHashCode 等 |
+| SLF4J 日志 | ✅ | @Slf4j，无 System.out |
+| LambdaQueryWrapper | ✅ | 无字符串字段名 |
+| ResponseWrapper | ✅ | 统一响应格式 |
+| BaseModel 继承 | ✅ | 审计字段自动填充 |
+| Vue 2 Options API | ✅ | 未使用 Composition API |
+| View Design 4 组件 | ✅ | 统一 UI 库 |
+
+---
+
+## 下一步
+
+1. 执行建表 SQL
+2. 执行菜单注册 SQL
+3. 重启后端服务
+4. 重启前端开发服务
+5. 验证功能

package/builtin/schemas/mes-prd-to-code/templates/confirm-scope.md

@@ -0,0 +1,51 @@
+# 范围确认记录
+
+> 确认日期: <日期>
+
+---
+
+## 确认结果
+
+| 维度 | 确认值 |
+|------|--------|
+| 项目根目录 | <绝对路径> |
+| 实施范围 | <模块列表> |
+| 后端 center | modules-center/{module}-center |
+| 后端包路径 | com.twsz.mom.{module}.{sub} |
+| 前端 API 目录 | src/api/{domain}/ |
+| 前端页面目录 | src/views/{domain}/{entity}/ |
+| 编号生成 | @AutoGenCode / 无 |
+| 状态流转 | 有 / 无 |
+| 已有代码影响 | <列表或无> |
+
+---
+
+## 对话记录
+
+### Q0: 项目根目录
+
+<对话内容>
+
+### Q1: 实施范围
+
+<对话内容>
+
+### Q2: 后端模块归属
+
+<对话内容>
+
+### Q3: 后端包路径
+
+<对话内容>
+
+### Q4: 前端目录
+
+<对话内容>
+
+### Q5: 已有代码影响
+
+<对话内容>
+
+### Q6: 特殊技术决策
+
+<对话内容>

package/builtin/schemas/mes-prd-to-code/templates/parse.md

@@ -0,0 +1,168 @@
+# 功能文档解析报告: <功能名称>
+
+> 输入文件:
+> - 功能文档: <*.md 文件路径>
+> - 流程图: <*.drawio 文件路径>（如有）
+> - 原型: <*.html 文件路径>（如有）
+> 解析日期: <日期>
+
+---
+
+## 1. 子模块清单
+
+| 编号 | 模块名称 | 类型 | 新建/修改 | 简述 |
+|:----:|----------|------|:---------:|------|
+| M-01 | | 新建CRUD / 修改已有 / 外部接口 / 记录表 | 新建 / 修改 | |
+| M-02 | | | | |
+
+> 如仅一个模块，此表只有一行。
+
+---
+
+## 2. 各模块解析详情
+
+### M-01: <模块名称>
+
+#### 2.1 功能简介
+
+| 项目 | 值 |
+|------|-----|
+| 菜单路径 | |
+| 应用设备 | |
+| 使用人员 | |
+| 功能描述 | |
+
+#### 2.2 数据表
+
+##### 表: <table_name>
+
+| 字段名 | 中文名 | 原始类型 | 长度 | 主键 | 非空 | 默认值 | 说明 | Java 类型 | 适配说明 |
+|--------|--------|----------|------|:----:|:----:|--------|------|-----------|----------|
+| id | 主键 | BIGINT | - | ✅ | ✅ | - | | Long | → NUMBER(19) 雪花算法 |
+| | | | | | | | | | |
+
+**适配变更**（功能文档 DDL → MES Oracle 规范）：
+- <列出所有需要适配的项>
+
+**审计字段**（自动补充）：
+- created_by VARCHAR2(64)
+- created_date DATE DEFAULT SYSDATE
+- last_updated_by VARCHAR2(64)
+- last_updated_date DATE DEFAULT SYSDATE
+
+##### 子表: <detail_table_name>（如有）
+
+| 字段名 | 中文名 | 原始类型 | 长度 | 主键 | 非空 | 说明 | Java 类型 |
+|--------|--------|----------|------|:----:|:----:|------|-----------|
+| | | | | | | | |
+
+**外键字段**: <关联主表的字段>
+
+#### 2.3 操作/按钮
+
+| 按钮 | 类型 | 对应接口 | 说明 |
+|------|------|----------|------|
+| 新增 | CRUD | POST /add | |
+| 编辑 | CRUD | PUT /update | |
+| 查看 | CRUD | GET /get/{id} | |
+| 删除 | CRUD | DELETE /delete | |
+| 导入 | 导入 | POST /uploadExcel | 模板: xxx |
+| 导出 | 导出 | POST /export | |
+
+#### 2.4 业务逻辑
+
+##### 校验规则
+
+| 编号 | 校验项 | 规则 | 错误提示 |
+|:----:|--------|------|----------|
+| V-01 | | | |
+
+##### 特殊逻辑
+
+1. <逻辑描述>
+2. <逻辑描述>
+
+##### 导入逻辑（如有）
+
+- 模板格式: <描述>
+- 校验规则: <列出>
+- 事务控制: 整批回滚 / 逐行处理
+
+##### 状态流转（如有）
+
+```
+<状态机 ASCII 图>
+```
+
+#### 2.5 外部接口（如有）
+
+| 接口名 | 方法 | 路径 | 调用方 | 描述 |
+|--------|------|------|--------|------|
+| | | | | |
+
+##### 接口详情
+
+**<接口名>**
+
+请求:
+```json
+{}
+```
+
+响应:
+```json
+{}
+```
+
+业务逻辑:
+1. <步骤>
+
+#### 2.6 流程图摘要
+
+从 *.drawio 提取的关键流程:
+
+```
+<ASCII 流程图>
+```
+
+---
+
+<!-- 重复以上结构，为每个子模块 M-02, M-03... 生成 -->
+
+---
+
+## 3. 依赖关系图
+
+```
+M-01 (新建CRUD)
+    │
+    ├──→ M-02 (修改已有，依赖 M-01 的数据)
+    │
+    └──→ M-03 (外部接口，读取 M-01 + M-02 的数据)
+```
+
+| 依赖 | 源模块 | 目标模块 | 类型 | 说明 |
+|------|--------|----------|------|------|
+| D-01 | M-01 | M-02 | 数据依赖 | M-02 读取 M-01 的表 |
+| D-02 | M-01 | M-03 | 功能依赖 | M-03 调用 M-01 的 Service |
+
+---
+
+## 4. 疑问点
+
+| 编号 | 类型 | 描述 | 建议 |
+|:----:|------|------|------|
+| Q-01 | 字段疑问 / 逻辑疑问 / 依赖疑问 | | |
+
+---
+
+## 5. 统计
+
+| 维度 | 数量 |
+|------|:----:|
+| 子模块数 | |
+| 新建表数 | |
+| 修改表数 | |
+| API 接口数 | |
+| 外部接口数 | |
+| 校验规则数 | |

package/builtin/schemas/mes-prd-to-code/templates/tasks.md

@@ -0,0 +1,162 @@
+# 实施任务: <功能名称>
+
+> 输入: 技术设计文档 (tech-design.md)
+> 创建日期: <日期>
+> 
+> 这些任务由 SDD 引擎逐个执行。
+> 每个任务包含完整代码，可直接写入文件。
+
+---
+
+## 数据库任务
+
+- [ ] **Task-001**: 创建数据库表 <table_name>
+  - **文件**: SQL 脚本 / dbx MCP
+  - **操作**:
+    ```sql
+    CREATE TABLE <table_name> (
+        ...
+    );
+    ```
+  - **验证**: 表创建成功，字段和约束正确
+  - **依赖**: 无
+
+---
+
+## 后端任务
+
+- [ ] **Task-002**: 创建 Entity 实体类
+  - **文件**: `modules-center/{module}-center/{module}-service/src/main/java/com/twsz/mom/{module}/{sub}/model/{Entity}.java`
+  - **代码**:
+    ```java
+    <完整 Entity 代码>
+    ```
+  - **验证**: 编译通过
+  - **依赖**: Task-001
+
+- [ ] **Task-003**: 创建 Mapper 接口
+  - **文件**: `.../{module}/mapper/{Entity}Mapper.java`
+  - **代码**:
+    ```java
+    <完整 Mapper 接口代码>
+    ```
+  - **验证**: 编译通过
+  - **依赖**: Task-002
+
+- [ ] **Task-004**: 创建 Mapper XML
+  - **文件**: `resources/mapper/{module}/{Entity}Mapper.xml`
+  - **代码**:
+    ```xml
+    <完整 Mapper XML 代码>
+    ```
+  - **验证**: XML 格式正确，SQL 语法正确
+  - **依赖**: Task-003
+
+- [ ] **Task-005**: 创建 Service 接口
+  - **文件**: `.../{module}/service/{Entity}Service.java`
+  - **代码**:
+    ```java
+    <完整 Service 接口代码>
+    ```
+  - **验证**: 编译通过
+  - **依赖**: Task-002
+
+- [ ] **Task-006**: 创建 ServiceImpl 实现
+  - **文件**: `.../{module}/service/impl/{Entity}ServiceImpl.java`
+  - **代码**:
+    ```java
+    <完整 ServiceImpl 代码，含业务逻辑>
+    ```
+  - **验证**: 编译通过，单元测试通过
+  - **依赖**: Task-004, Task-005
+
+- [ ] **Task-007**: 创建 Controller
+  - **文件**: `.../{module}/controller/{Entity}Controller.java`
+  - **代码**:
+    ```java
+    <完整 Controller 代码>
+    ```
+  - **验证**: 编译通过，接口可访问
+  - **依赖**: Task-006
+
+---
+
+## 前端任务
+
+- [ ] **Task-008**: 创建 API 文件
+  - **文件**: `src/api/{domain}/{entity}.js`
+  - **代码**:
+    ```javascript
+    <完整 API 文件代码>
+    ```
+  - **验证**: 语法检查通过
+  - **依赖**: Task-007
+
+- [ ] **Task-009**: 创建列表页
+  - **文件**: `src/views/{domain}/{entity}/index.vue`
+  - **代码**:
+    ```vue
+    <完整列表页代码>
+    ```
+  - **验证**: 页面可渲染，查询功能正常
+  - **依赖**: Task-008
+
+- [ ] **Task-010**: 创建表单页
+  - **文件**: `src/views/{domain}/{entity}/{entity}-form.vue`
+  - **代码**:
+    ```vue
+    <完整表单页代码>
+    ```
+  - **验证**: 新增/编辑/查看功能正常
+  - **依赖**: Task-009
+
+---
+
+## 配置任务
+
+- [ ] **Task-011**: 菜单注册
+  - **文件**: SQL 脚本
+  - **代码**:
+    ```sql
+    <c_sys_resource INSERT 语句>
+    ```
+  - **验证**: 菜单可见，权限生效
+  - **依赖**: Task-007
+
+---
+
+## 任务依赖图
+
+```
+Task-001 (建表)
+    │
+    ▼
+Task-002 (Entity)
+    │
+    ├──→ Task-003 (Mapper接口) ──→ Task-004 (Mapper XML)
+    │                                    │
+    ├──→ Task-005 (Service接口)          │
+    │         │                          │
+    │         ▼                          ▼
+    │    Task-006 (ServiceImpl) ◄────────┘
+    │         │
+    │         ▼
+    │    Task-007 (Controller)
+    │         │
+    │         ├──→ Task-008 (API JS) ──→ Task-009 (列表页) ──→ Task-010 (表单页)
+    │         │
+    │         └──→ Task-011 (菜单注册)
+    │
+```
+
+---
+
+## 任务统计
+
+| 类型 | 数量 |
+|------|:----:|
+| 数据库 | 1 |
+| 后端 | 6 |
+| 前端 | 3 |
+| 配置 | 1 |
+| **合计** | **11** |