@specpow/framework 0.5.21 → 0.5.23

package/builtin/schemas/prd-to-tech-doc/templates/tech-design.md

@@ -0,0 +1,263 @@
+# 技术设计: <功能名称>
+
+> 输入: 需求分析报告 (analysis.md)
+> 设计日期: <日期>
+
+---
+
+## 1. 数据库设计
+
+### 1.1 表结构
+
+#### 表: <table_name>
+
+```sql
+CREATE TABLE <table_name> (
+    id              NUMBER(19)      NOT NULL,
+    -- 业务字段
+    <column>        <type>          <constraint>,
+    -- 审计字段
+    created_by      VARCHAR2(64),
+    created_date    DATE            DEFAULT SYSDATE,
+    last_updated_by VARCHAR2(64),
+    last_updated_date DATE          DEFAULT SYSDATE,
+    CONSTRAINT pk_<table_name> PRIMARY KEY (id)
+);
+
+COMMENT ON TABLE <table_name> IS '<表中文名>';
+COMMENT ON COLUMN <table_name>.id IS '主键';
+-- 其他字段注释
+```
+
+**索引**:
+
+| 索引名 | 字段 | 类型 | 说明 |
+|--------|------|------|------|
+| | | UNIQUE / NORMAL | |
+
+**数据库操作方式**:
+- [ ] 优先使用 dbx MCP 工具建表
+- [ ] 备选: 执行 SQL 脚本
+
+---
+
+## 2. API 接口设计
+
+### 2.1 接口清单
+
+| # | Method | Path | 描述 | 请求体 | 响应体 |
+|:-:|--------|------|------|--------|--------|
+| 1 | POST | `/{entity}/search` | 分页查询 | PageForm<Entity> | Page<Entity> |
+| 2 | POST | `/{entity}/add` | 新增 | Entity | — |
+| 3 | PUT | `/{entity}/update` | 修改 | Entity | — |
+| 4 | DELETE | `/{entity}/delete` | 批量删除 | Long[] ids | — |
+| 5 | POST | `/{entity}/export` | 导出 Excel | Entity | file |
+| 6 | POST | `/{entity}/uploadExcel` | 导入 Excel | file | — |
+
+### 2.2 接口详情
+
+#### API-1: 分页查询
+
+- **路径**: `POST /{entity}/search`
+- **描述**: 分页查询<实体>列表
+- **请求体**:
+```json
+{
+    "size": 20,
+    "current": 1,
+    "condition": {
+        "<field1>": "<value>"
+    }
+}
+```
+- **响应体**:
+```json
+{
+    "code": 200,
+    "message": "success",
+    "data": {
+        "records": [...],
+        "total": 100,
+        "size": 20,
+        "current": 1
+    }
+}
+```
+
+<!-- 按需补充其他接口详情 -->
+
+---
+
+## 3. 后端代码结构
+
+### 3.1 Entity
+
+**路径**: `modules-center/{module}-center/{module}-service/src/main/java/com/twsz/mom/{module}/{sub}/model/{Entity}.java`
+
+```java
+@Data
+@EqualsAndHashCode(callSuper = false)
+@JsonInclude(JsonInclude.Include.NON_NULL)
+@TableName("<table_name>")
+public class {Entity} extends BaseModel implements Serializable {
+
+    private static final long serialVersionUID = 1L;
+
+    @TableId(type = IdType.ASSIGN_ID)
+    @JsonSerialize(using = ToStringSerializer.class)
+    private Long id;
+
+    // 业务字段（含 @ExcelProperty 注解）
+}
+```
+
+### 3.2 Mapper
+
+**接口路径**: `.../{module}/mapper/{Entity}Mapper.java`
+**XML 路径**: `resources/mapper/{module}/{Entity}Mapper.xml`
+
+```java
+@Mapper
+public interface {Entity}Mapper extends BaseMapper<{Entity}> {
+    IPage<{Entity}> pageSearch(Page<{Entity}> p, @Param("entity") {Entity} entity);
+    List<{Entity}> list(@Param("entity") {Entity} entity);
+}
+```
+
+**XML 关键片段**:
+- `<sql id="Columns">` — 字段列表
+- `<sql id="Where">` — 查询条件
+- `pageSearch` — 分页查询
+- `list` — 不分页列表
+
+### 3.3 Service
+
+**接口路径**: `.../{module}/service/{Entity}Service.java`
+
+```java
+public interface {Entity}Service extends IService<{Entity}> {
+    ResponseWrapper<?> insert({Entity} entity);
+    ResponseWrapper<String> update({Entity} entity);
+    ResponseWrapper<String> deleteByIds(Collection<BigDecimal> ids);
+    ResponseWrapper<Page<{Entity}>> search(PageForm<{Entity}> pageForm);
+    List<{Entity}> list({Entity} entity);
+}
+```
+
+### 3.4 ServiceImpl
+
+**路径**: `.../{module}/service/impl/{Entity}ServiceImpl.java`
+
+关键逻辑:
+- `insert()`: 校验唯一性等
+- `update()`: 校验存在性 + 唯一性
+- `deleteByIds()`: 批量删除
+- `search()`: 分页查询
+
+### 3.5 Controller
+
+**路径**: `.../{module}/controller/{Entity}Controller.java`
+
+```java
+@RestController
+@RequestMapping("/api/{api-path}/{entity}")
+public class {Entity}Controller {
+
+    @PostMapping("/search")
+    public ResponseWrapper<Page<{Entity}>> search(@RequestBody PageForm<{Entity}> pageForm) { ... }
+
+    @PostMapping("/add")
+    public ResponseWrapper<?> add(@RequestBody {Entity} entity) { ... }
+
+    @PutMapping("/update")
+    public ResponseWrapper<String> update(@RequestBody {Entity} entity) { ... }
+
+    @DeleteMapping("/delete")
+    public ResponseWrapper<String> delete(@RequestBody Collection<BigDecimal> ids) { ... }
+
+    @PostMapping("/export")
+    public void export(@RequestBody {Entity} entity, HttpServletResponse response) { ... }
+
+    @PostMapping("/uploadExcel")
+    public ResponseWrapper<?> uploadExcel(@RequestParam("file") MultipartFile file) { ... }
+}
+```
+
+---
+
+## 4. 前端代码结构
+
+### 4.1 API 文件
+
+**路径**: `src/api/{domain}/{entity}.js`
+
+```javascript
+import axios from '@/libs/request'
+import { exportExcel } from '../file'
+const root = '/mm/api'  // 根据实际微服务调整
+
+// search, add, update, delete, export, uploadExcel
+```
+
+### 4.2 列表页
+
+**路径**: `src/views/{domain}/{entity}/index.vue`
+
+- 组件: `search-table` + `indexPage` mixin
+- 搜索条件: <列出搜索字段>
+- 表格列: <列出列定义>
+- 工具栏: 新增 / 编辑 / 查看 / 删除 / 导出 / 导入
+
+### 4.3 表单页
+
+**路径**: `src/views/{domain}/{entity}/{entity}-form.vue`
+
+- 组件: `master-sub`
+- 表单字段: <列出字段及校验规则>
+- 提交逻辑: 判断新增/编辑 → 调用对应 API
+
+---
+
+## 5. 业务逻辑流程
+
+### 5.1 核心流程
+
+```
+<ASCII 流程图>
+```
+
+### 5.2 校验规则
+
+| 编号 | 校验项 | 规则 | 错误提示 |
+|:----:|--------|------|----------|
+| V-01 | | | |
+
+### 5.3 状态流转（如有）
+
+```
+<状态机图>
+```
+
+---
+
+## 6. 集成点
+
+### 6.1 被调用方
+
+| 调用方 | 接口方式 | 说明 |
+|--------|----------|------|
+| | | |
+
+### 6.2 菜单权限
+
+| 菜单名 | 权限标识 | 类型 |
+|--------|----------|------|
+| | | 路由 / 按钮 / API |
+
+---
+
+## 7. 设计决策记录
+
+| 决策 | 选项 | 结论 | 原因 |
+|------|------|------|------|
+| | | | |

package/builtin/schemas/prd-to-tech-doc/templates/tech-tasks.md

@@ -0,0 +1,134 @@
+# 实施任务: <功能名称>
+
+> 输入: 技术设计文档 (tech-design.md)
+> 创建日期: <日期>
+> 
+> 这些任务将由 SDD (子代理驱动开发) 引擎逐个执行。
+> 每个任务应该足够小（2-5分钟），包含精确的文件路径和验证步骤。
+
+---
+
+## 数据库任务
+
+- [ ] **Task-001**: 创建数据库表 <table_name>
+  - **文件**: SQL 脚本 或 dbx MCP
+  - **操作**:
+    ```sql
+    -- 如果使用 dbx MCP，通过 dbx 工具建表
+    -- 如果使用 SQL 脚本，执行以下 DDL:
+    CREATE TABLE <table_name> (
+        ...
+    );
+    ```
+  - **验证**: 表创建成功，字段和约束正确
+  - **依赖**: 无
+
+---
+
+## 后端任务
+
+- [ ] **Task-002**: 创建 Entity 实体类
+  - **文件**: `modules-center/{module}-center/{module}-service/src/main/java/com/twsz/mom/{module}/{sub}/model/{Entity}.java`
+  - **操作**: 创建实体类，继承 BaseModel，定义字段和注解
+  - **验证**: 编译通过
+  - **依赖**: Task-001
+
+- [ ] **Task-003**: 创建 Mapper 接口
+  - **文件**: `.../{module}/mapper/{Entity}Mapper.java`
+  - **操作**: 创建 Mapper 接口，继承 BaseMapper，定义查询方法
+  - **验证**: 编译通过
+  - **依赖**: Task-002
+
+- [ ] **Task-004**: 创建 Mapper XML
+  - **文件**: `resources/mapper/{module}/{Entity}Mapper.xml`
+  - **操作**: 创建 XML，定义 Columns/Where 片段和查询语句
+  - **验证**: XML 格式正确，SQL 语法正确
+  - **依赖**: Task-003
+
+- [ ] **Task-005**: 创建 Service 接口
+  - **文件**: `.../{module}/service/{Entity}Service.java`
+  - **操作**: 创建 Service 接口，定义 CRUD 方法签名
+  - **验证**: 编译通过
+  - **依赖**: Task-002
+
+- [ ] **Task-006**: 创建 ServiceImpl 实现
+  - **文件**: `.../{module}/service/impl/{Entity}ServiceImpl.java`
+  - **操作**: 实现 Service 接口，包含业务校验逻辑
+  - **验证**: 编译通过，单元测试通过
+  - **依赖**: Task-004, Task-005
+
+- [ ] **Task-007**: 创建 Controller
+  - **文件**: `.../{module}/controller/{Entity}Controller.java`
+  - **操作**: 创建 Controller，定义 REST 接口
+  - **验证**: 编译通过，接口可访问
+  - **依赖**: Task-006
+
+---
+
+## 前端任务
+
+- [ ] **Task-008**: 创建 API 文件
+  - **文件**: `src/api/{domain}/{entity}.js`
+  - **操作**: 创建 API 模块，定义 search/add/update/delete/export 等方法
+  - **验证**: 语法检查通过
+  - **依赖**: Task-007
+
+- [ ] **Task-009**: 创建列表页
+  - **文件**: `src/views/{domain}/{entity}/index.vue`
+  - **操作**: 创建列表页组件，配置 search-table + indexPage mixin
+  - **验证**: 页面可渲染，查询功能正常
+  - **依赖**: Task-008
+
+- [ ] **Task-010**: 创建表单页
+  - **文件**: `src/views/{domain}/{entity}/{entity}-form.vue`
+  - **操作**: 创建表单页组件，配置 master-sub + Form 字段
+  - **验证**: 新增/编辑/查看功能正常
+  - **依赖**: Task-009
+
+---
+
+## 配置任务
+
+- [ ] **Task-011**: 菜单注册
+  - **文件**: SQL 脚本
+  - **操作**: 在 c_sys_resource 表插入菜单和按钮权限记录
+  - **验证**: 菜单可见，权限生效
+  - **依赖**: 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** |

package/package.json

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