@specpow/framework 0.5.23 → 0.5.24

package/builtin/schemas/mes-prd-to-code/references.md

@@ -0,0 +1,150 @@
+# MES 项目公共工具方法参考
+
+> 本文件为 AI 代码生成时的参考手册，列出项目中可直接复用的公共工具类和方法。
+> 生成代码时应优先使用这些方法，避免重复实现。
+
+## 后端工具类
+
+### ResponseWrapper (com.twsz.mom.core.common.ResponseWrapper)
+- `ofSuccess(T data)` → 返回 code=200 + data
+- `ofFail(String message)` → 返回 code=600 + 错误消息
+- `defaultSuccess()` → 返回 code=200 + data=null（无数据成功）
+- `ofStatus(IHttpStatus status)` → 返回自定义状态码
+- `ofException(BaseException e)` → 从异常构造响应
+- `ofFlat(int code, String message, T data)` → 不截断消息的响应
+- `ofMessage(String message)` → 返回 code=200 + 消息（无数据）
+- `isSuccess()` → 判断是否成功（code==200 或 200<=code<300）
+
+### AIHttpStatus (com.twsz.mom.core.common.AIHttpStatus)
+- 枚举类，实现 IHttpStatus 接口
+- 新增 code 规则: 取枚举中已有 code 最大值 + 1（maxCode + 1），禁止硬编码数字
+- 枚举命名: 中文提示的缩写，如 "类型不能为空" → `TYPE_NOT_EMPTY`
+- 定义格式: `TYPE_NOT_EMPTY(10000000X, "类型不能为空")`
+- code 格式: 100000001, 100000002, ... 递增
+- message 支持 `[{0}]` 占位符，通过 data 数组传参
+- 使用方式: `throw new BaseException(AIHttpStatus.XXX.getCode(), AIHttpStatus.XXX.getMessage())`
+- 带参数: `throw new BaseException(AIHttpStatus.XXX.getCode(), AIHttpStatus.XXX.getMessage(), param1)`
+- 响应: `ResponseWrapper.ofStatus(AIHttpStatus.XXX, Arrays.asList("param1"))`
+
+### PageForm<T> (com.twsz.mom.core.common.PageForm)
+- `getSize()` → 每页条数
+- `getCurrent()` → 当前页码（1-based）
+- `getCondition()` → 查询条件对象（泛型 T）
+- `getRecords()` → 结果记录列表
+
+### BaseException (com.twsz.mom.core.exception.BaseException)
+- `new BaseException(HttpStatus status)` → 从状态码构造
+- `new BaseException(String message)` → 从消息构造
+- `new BaseException(HttpStatus status, Object... args)` → 带参数格式化
+
+### ExcelUtil (com.twsz.mom.core.utils.ExcelUtil)
+- `importExcel(InputStream is)` → `List<Map<String, Object>>`（原始导入）
+- `importExcel(InputStream is, Class<T> clazz)` → `List<T>`（类型化导入）
+- `export(HttpServletResponse resp, Class<T> clazz, Boolean isCsv, Collection<?> data)` → 标准导出
+- `export(HttpServletResponse resp, Class<T> clazz, Boolean isCsv, Supplier<Collection<?>> supplier)` → 懒加载导出
+- `responseJson(HttpServletResponse resp, ResponseWrapper<T> wrapper)` → 写 JSON 错误响应
+- `exportException(HttpServletResponse resp, Throwable e)` → 写异常为 JSON
+
+### SecurityUtils (com.twsz.mom.core.utils.SecurityUtils)
+- `getCurrentUsername()` → 获取当前登录用户名
+- `getCurrentOrgId()` → 获取当前组织 ID（通常不需要调用，多租户插件自动处理）
+- `getCurrentUserId()` → 获取当前用户 ID
+
+### IdUtil (cn.hutool.core.util.IdUtil)
+- `fastSimpleUUID()` → 生成无横线 UUID（用于导出文件名等）
+
+### EasyExcel (com.alibaba.excel.EasyExcel)
+- `EasyExcel.write(OutputStream, Class<T>).sheet("sheet").doWrite(List)` → 简单导出
+- `EasyExcel.read(InputStream, Class<T>, ReadListener).sheet().doRead()` → 监听式导入
+
+### BaseExcelExportTemplate (com.twsz.mom.core.web.excel.BaseExcelExportTemplate)
+- 抽象类：`getTotal()` + `getData(Integer start, Integer size)` → 分批导出模板
+- 默认 batch size: 1000, sheet max: 1,048,576
+
+### ViewModel 常量 (com.twsz.mom.ds.model.ViewModel)
+- `ViewModel.OPT_ADD = "1"` — 新增标记
+- `ViewModel.OPT_MODIFY = "2"` — 修改标记
+- `ViewModel.OPT_DELETE = "3"` — 删除标记
+- `ViewModel.OPT_NOT_MODIFY_DATE = "0"` — 不修改日期标记
+
+### MetaHandler (com.twsz.mom.ds.handler.MetaHandler)
+- 自动填充: INSERT 时自动设置 createdBy/createdDate/lastUpdatedBy/lastUpdatedDate
+- 自动填充: UPDATE 时自动设置 lastUpdatedBy/lastUpdatedDate
+- 通过 @TableField(fill = FieldFill.INSERT/INSERT_UPDATE) 触发
+
+---
+
+## 前端工具方法
+
+### 请求封装 (@/libs/request)
+- `axios.request({ url, method, data })` → 统一请求方法
+- 响应拦截器: 自动提取 data.data，错误自动 toast 提示
+
+### 导出工具 (@/api/file)
+- `exportExcel(url, data)` → 下载 Excel（Blob → 创建下载链接）
+- `downloadFile(url, data)` → 通用文件下载
+- `uploadFile(url, data)` → 文件上传
+
+### indexPage Mixin (_c/table-form/index-mixin)
+- `this.add(formData)` → 打开新增表单
+- `this.edit(row)` → 打开编辑表单（传入行数据）
+- `this.view(row)` → 打开查看表单（只读模式）
+- `this.refresh()` → 刷新列表（重新搜索第 2 页）
+- `this.triggerBack(showIndexPage)` → 切换列表/表单视图
+- `this.handleSuccess(item, back)` → 表单提交成功回调
+- `this.showIndexPage` → 控制列表/表单显示状态
+- `this.formData` → 传递给表单的数据
+- `this.readonly` → 只读模式标记
+- `this.dataSelections` → 当前选中行
+
+### BaseMixin (@/mixin)
+- `this.startLoading()` → 开始 loading
+- `this.finishLoading()` → 结束 loading
+- `this.asyncLoading(Promise)` → 自动管理 loading 的异步调用
+- `this.loading` → loading 状态
+
+### tw-table Option 常用配置
+- `option.tableName` → 唯一标识（必须）
+- `option.searchForm` → 搜索条件双向绑定
+- `option.fixedTableHeight` → 自动填充剩余高度
+- `option.add.enable` → 启用新增按钮
+- `option.delete.enable` → 启用删除（支持函数动态判断）
+- `option.delete.before(rows)` → 删除前校验（return false 阻止）
+- `option.edit.enable` → 启用编辑（支持函数动态判断）
+- `option.view.enable` → 启用查看
+- `option.search.query` → 查询 API 方法
+- `option.export.enable` → 启用导出
+- `option.export.method` → 导出 API 方法
+
+### 国际化 ($t)
+- `$t('key||中文默认值')` → 带默认值的国际化
+- `$t('table.entityName.fieldName||字段中文名')` → 表格字段
+- `$t('operate||操作')`, `$t('add||新增')`, `$t('edit||编辑')`
+- `$t('submit||提交')`, `$t('submit.success||提交成功')`
+- `$t('error.input.notEmpty||输入不能为空')`
+
+---
+
+## MyBatis-Plus 拦截器链
+
+按执行顺序:
+1. `TenantLineInnerInterceptor` — 多租户 org_id 自动注入
+2. `AdvanceQueryInterceptor` — 高级查询（Oracle）
+3. `PaginationInnerInterceptor` — 分页（overflow 已启用）
+4. `OptimisticLockerInnerInterceptor` — 乐观锁（@Version 字段）
+5. `BatchUpdateInterceptor` — 批量更新
+6. `AuditLogInterceptor` — 审计日志
+
+---
+
+## 全局注册组件
+
+通过 `Vue.component()` 全局注册，可直接使用:
+- `tw-table` — 核心表格组件
+- `master-sub` — 主子表布局（垂直分栏）
+- `tw-card` — 卡片容器
+- `RemoteSelect` — 远程下拉选择
+- `RemoteCheckbox` — 远程复选框
+- `RemoteRadio` — 远程单选框
+- `TableSelect` — 表格弹窗选择（放大镜）
+- `SelectModal` — 选择弹窗

package/builtin/schemas/mes-prd-to-code/rules.md

@@ -0,0 +1,204 @@
+# MES PRD to Code — 项目规范规则集
+
+> 本文件由 specpow 框架的 `extractRulesFromSchemaFiles` 自动加载。
+> 所有以 `-` 开头的行会被提取为约束规则，通过 `{{rules}}` 注入到 AI instruction 中。
+> 来源: 项目实际代码（BaseModel/ViewModel/ServiceImpl/Mapper XML/Vue 组件）+ DATABASE.md + JAVA.md + TESTING.md
+
+## 数据库 DDL 规范
+
+- 表名格式: `{模块简称}_{功能描述}`，小写下划线，模块前缀: BD/MM/WIP/FG/PM/QM/EM/MCC/AGV/RPT
+- 子表命名: `{主表名}_DETAIL`，配置表: `{功能}_CONFIG`，历史表: `{功能}_H_T`
+- 主键字段: `id NUMBER(19) NOT NULL`，使用雪花算法生成（IdType.ASSIGN_ID），禁止 Oracle SEQUENCE
+- 多租户字段: `org_id NUMBER(19) NOT NULL`，仅在 DDL 中定义，不在 Entity 中声明（TenantLineInnerInterceptor 自动处理）
+- 审计字段: `created_by NVARCHAR2(64)`, `created_date DATE DEFAULT SYSDATE`, `last_updated_by NVARCHAR2(64)`, `last_updated_date DATE DEFAULT SYSDATE`
+- 字符串类型统一使用 NVARCHAR2，禁止使用 VARCHAR2 或 VARCHAR
+- 数值类型: 主键用 NUMBER(19)，状态/标志用 NUMBER(2) 或 NUMBER(1)，数量/金额用 NUMBER(18,4)
+- 日期类型: DATE，默认值 DEFAULT SYSDATE
+- 扩展字段: ATTRIBUTE1~ATTRIBUTE5 NVARCHAR2(150)（预留扩展，按需添加）
+- 表名字段名全部小写下划线命名（snake_case），Java 中自动映射为驼峰（camelCase）
+
+## 数据库索引规范
+
+- 主键索引命名: `{tableName}_PK`
+- 普通索引命名: `{tableName}_N1` ~ `{tableName}_N5`
+- 唯一索引命名: `{tableName}_U1` ~ `{tableName}_U5`
+- 唯一索引必须以 org_id 为首列: `(org_id, 业务字段1, 业务字段2...)`
+- 数据表空间: TABLESPACE MES_DATA_{WORKS|WMS|COM}（生产/仓储/通用）
+- 索引表空间: USING INDEX TABLESPACE MES_IDX_{WORKS|WMS|COM}
+- 主键约束: `CONSTRAINT {表名}_PK PRIMARY KEY (id) USING INDEX TABLESPACE {索引表空间}`
+- 每张表和每个字段必须有 COMMENT ON 注释
+- 禁止使用 SELECT *，必须明确列出字段名
+
+## 后端 Entity 规范
+
+- 必须继承 `com.twsz.mom.ds.model.BaseModel`（不是 com.twsz.mom.common.base.BaseModel）
+- BaseModel 继承链: ViewModel → TimeModel → BaseModel，已提供 id/审计字段/查询字段
+- BaseModel 已提供: id(Long, ASSIGN_ID, ToStringSerializer), createdBy, createdDate, lastUpdatedBy, lastUpdatedDate
+- ViewModel 已提供: opt("1"=新增,"2"=修改,"3"=删除), columns, orderBy, fields, csv, rowNum — Entity 中禁止重复声明
+- @EqualsAndHashCode(callSuper = true)（不是 false）
+- @JsonInclude(JsonInclude.Include.NON_NULL)
+- @TableName("表名")
+- id 字段必须在 Entity 中显式声明: @TableId(type = IdType.ASSIGN_ID) + @JsonSerialize(using = ToStringSerializer.class)（覆盖 BaseModel 声明以确保序列化）
+- org_id 禁止在 Entity 中声明（TenantLineInnerInterceptor 自动注入）
+- 每个业务字段使用 @ExcelProperty("中文名") 注解（支持导入导出）
+- 非数据库字段使用 @TableField(exist = false) + @ExcelIgnore
+- Long 类型字段暴露给前端时必须加 @JsonSerialize(using = ToStringSerializer.class)（防止 JS 精度丢失）
+- 日期输出格式化: @JsonFormat(pattern = "yyyy/MM/dd HH:mm:ss") 或 @JsonSerialize(using = LocalDateTimeSerializer.class)
+- 使用 Lombok: @Data, @EqualsAndHashCode, @Builder, @NoArgsConstructor, @AllArgsConstructor
+- 编号字段使用 @AutoGenCode 注解（自动生成编号）
+- 主子表的子表集合字段: @TableField(exist = false) private List<DetailEntity> details
+
+## 后端 Controller 规范
+
+- @RestController + @RequestMapping("/api/v1/entity-kebab-case")（含版本号 /api/v1/）
+- 使用 @Autowired 或 @Resource 字段注入（项目惯例，非构造器注入）
+- 统一返回 ResponseWrapper<T>（com.twsz.mom.core.common.ResponseWrapper）
+- 标准方法: search(POST) / save(POST) / delete(DELETE) / list(POST) / export(POST)
+- save 方法: id==null 时 insert，id!=null 时 update（Controller 层判断或 Service 层 saveModel）
+- Controller 只做参数校验和结果封装，禁止写业务逻辑
+- 禁止在 Controller 中 try-catch（全局异常处理器 @ControllerAdvice 统一处理）
+- delete 接口: @DeleteMapping，接收 `Long[] ids`
+- export 接口: 使用 ExcelUtil.export() 或 EasyExcel 直接写入 HttpServletResponse
+- import 接口: 接收 MultipartFile，使用 ExcelUtil.importExcel() 或 EasyExcel.read()
+
+## 后端 Service 规范
+
+- 接口继承 IService<T>，实现类继承 ServiceImpl<Mapper, Entity> 并实现接口
+- @Slf4j + @Service 注解
+- saveModel 方法: @Transactional(rollbackFor = Exception.class)，id==null 调 insert，否则检查乐观锁后调 update
+- 主子表保存模式: 先保存主表，再遍历明细列表按 opt 标记处理（1=新增, 2=修改, 3=删除）
+- saveOrUpdateOrDelete 模式: 按 ViewModel.OPT_ADD/MODIFY/DELETE 分组，批量 saveBatch/updateBatchById/delete
+- 乐观锁: 编辑时查库比对 lastUpdatedDate（withNano(0) 去掉纳秒），不匹配则 throw new BaseException
+- 异常抛出: `throw new BaseException(AIHttpStatus.XXX.getCode(), AIHttpStatus.XXX.getMessage())`
+- 带参数占位: `throw new BaseException(AIHttpStatus.XXX.getCode(), AIHttpStatus.XXX.getMessage(), param1, param2)`
+- AIHttpStatus 新增 code 规则: 取 AIHttpStatus 枚举中已有 code 最大值 + 1（maxCode + 1），禁止硬编码数字
+- AIHttpStatus 枚举命名: 中文提示的缩写，如 "类型不能为空" → TYPE_NOT_EMPTY
+- 禁止在 Service 中手动设置 orgId（多租户插件自动注入）
+- 禁止在循环中执行数据库查询（N+1 问题），必须批量查询后内存处理
+- 新增/修改操作后必须清除相关 Redis 缓存
+- 使用 LambdaQueryWrapper / LambdaUpdateWrapper，禁止硬编码字符串字段名
+- @Transactional 写在 ServiceImpl 方法上，不写在接口上
+
+## 后端 Mapper XML 规范
+
+- 使用 <sql id="EntityColumns"> 定义字段列表（t.前缀），支持 entity.columns 动态列选择，默认 t.*
+- 使用 <sql id="EntityWhere"> 定义条件（动态 <if> 判断非空），字符串检查 `!= null and != ''`，数值/日期只检查 `!= null`
+- 使用 <sql id="EntityJoins"> 定义关联（LEFT JOIN），默认为空
+- 分页查询: IPage<Entity> pageSearch(Page<Entity> p, @Param("entity") Entity entity)
+- list 查询: 使用 Oracle rownum 限制行数，默认 10000，通过 entity.rowNum 可配置
+- Oracle 字符串拼接用 || 而非 CONCAT: `LIKE '%' || #{entity.field} || '%'`
+- CDATA 用于特殊字符: `<![CDATA[<=]]>` for rownum <=
+- 排序默认: ORDER BY t.id DESC，支持 entity.orderBy 动态排序
+- XML 中不包含 org_id 列和 org_id 条件（多租户插件自动注入）
+- 逻辑删除过滤: t.is_deleted = 0 或 t.is_delete = 0（如适用）
+- 表别名统一使用 t
+- XML 文件位置: src/main/resources/mapper/{submodule}/EntityMapper.xml
+
+## 后端公共类引用
+
+- ResponseWrapper: ofSuccess(data) / ofFail(msg) / defaultSuccess() / ofStatus(AIHttpStatus) — com.twsz.mom.core.common.ResponseWrapper
+- AIHttpStatus: 枚举类，code 从已有最大值+1 递增（maxCode+1），禁止硬编码 — com.twsz.mom.core.common.AIHttpStatus
+- BaseException: `new BaseException(AIHttpStatus.XXX.getCode(), AIHttpStatus.XXX.getMessage())` — com.twsz.mom.core.exception.BaseException
+- PageForm<T>: size(页大小), current(页码,1-based), condition(查询条件对象) — com.twsz.mom.core.common.PageForm
+- SecurityUtils: 获取当前用户信息 — com.twsz.mom.core.utils.SecurityUtils
+- ExcelUtil: importExcel/export — com.twsz.mom.core.utils.ExcelUtil
+- EasyExcel: com.alibaba.excel.EasyExcel
+- ViewModel.OPT_ADD = "1", OPT_MODIFY = "2", OPT_DELETE = "3", OPT_NOT_MODIFY_DATE = "0"
+- IdUtil: cn.hutool.core.util.IdUtil（fastSimpleUUID 等）
+
+## 前端 API 规范
+
+- 使用 `import axios from '@/libs/request'`
+- 导出使用 `import { exportExcel } from '@/api/file'` 或 `import { exportExcel } from '../../file'`
+- API 文件放在 `src/api/{domain}/{entity}.js`
+- 标准方法: save, deleteById, list, search, exportData
+- save: POST, data 为实体对象
+- deleteById: DELETE, data 为数组 `Array.isArray(id) ? id : [id]`
+- search: POST, data 为 PageForm 对象
+- list: POST, data 为查询条件对象
+- exportData: 调用 exportExcel(url, data)
+- URL 前缀根据模块不同有多种模式: `/mm/{entity}`, `/api/{entity}`, `/mm/api/{sub}/{entity}`
+- 导入接口: `{ headers: { 'Content-Type': 'multipart/form-data' } }`
+
+## 前端列表页规范（index.vue）
+
+- 使用 indexPage mixin: `import { indexPage } from '_c/table-form/index-mixin'`
+- 使用 tw-table 组件（非 search-table）
+- option 配置: tableName(唯一标识), searchForm, fixedTableHeight, add/delete/edit/view/search/export
+- option.add: `{ enable: true, method: this.add }`
+- option.delete: `{ enable: true|fn(row), method: Api.deleteById, before: fn(rows) }`
+- option.edit: `{ enable: true|fn(row), method: this.edit }`
+- option.view: `{ enable: true, method: this.view }`
+- option.search: `{ query: Api.search }`
+- option.export: `{ enable: true, method: Api.exportData }`
+- 表格列顺序: selection → 业务列 → 审计列(createdBy/createdDate/lastUpdatedBy/lastUpdatedDate) → operate
+- 搜索条件: `<Form ref="conditionForm" class="search-condition-form" label-colon @keyup.enter.native="refresh" @submit.native.prevent>`
+- 国际化: $t('key||中文')，如 $t('table.entityName.fieldName||字段中文名')
+- 操作列: `<template slot-scope="{ row }" slot="operate">` 内含编辑/查看/删除按钮
+- 权限控制: v-if="$auth('permission:key')"
+- 列表/表单切换: showIndexPage 控制，triggerBack(false) 切换到表单，triggerBack(true) 回到列表
+
+## 前端表单页规范（form.vue）
+
+- 使用 BaseMixin: `import BaseMixin from '@/mixin'`，mixins: [BaseMixin]
+- props: readonly(Boolean), form(Object)
+- data: `{ default: {}, mform: {} }`，created 中 `this.mform = Object.assign({}, this.default, this.form)`
+- 使用 master-sub 组件（主子表布局）:
+  - `<template #master-header-toolbar>` — 提交按钮
+  - `<template #master-form>` — 主表 Form
+  - `<template #sub-table>` — 子表组件
+- 表单提交: doSubmit() → this.$refs.mform.validate() → Api.save(this.mform) → $emit('on-success', data)
+- 按钮状态: `<Button type="primary" :loading="loading" @click="doSubmit">`
+- 只读模式: `<Form :disabled="readonly">`, 按钮 `v-if="!readonly"`
+- 主子表提交: `this.asyncLoading(this.$refs.SubTableForm.save())` 委托子表 save()
+
+## 前端子表规范（table-form.vue）
+
+- 使用 tw-table: `<tw-table ref="searchTable" :option="option" :mainItem="mainItem" :columns="tableColumns" :tableRules="rules" :readonly="readonly">`
+- option.save: 指向主表 Api.save（saveTable() 时使用）
+- option.search.beforeQuery: `this.searchBefore` — 注入 mainId 过滤
+- searchBefore(searchParam): `Object.assign(searchParam.condition, { mainId: this.mainItem.id }); return Boolean(this.mainItem.id)`
+- 行内编辑 slot: `<template slot-scope="{ row, column, index, tableData, editIndex }" slot="input">`
+- 编辑条件: `v-if="index === editIndex && !(column.disabled && Boolean(row.id))"`
+- 必填列: `className: 'table-column-required'`
+- 只读列: `readonly: true, disabled: 'true'`（审计字段等）
+- tableRules: 定义每列校验规则 `{ fieldName: { required: true, type: 'string', message: '...' } }`
+- save() 方法: 自定义校验 → `this.$refs.searchTable.saveTable()`
+- opt 标记: 新增行 opt='1'，修改行 opt='2'，删除行 opt='3'
+
+## 测试规范
+
+- 测试类名: 原类名 + MockTest（如 PcCadDataServiceImpl → PcCadDataServiceImplMockTest）
+- 框架: JUnit 5 + Mockito（@ExtendWith(MockitoExtension.class)，不是 @RunWith）
+- @Mock 模拟依赖（Mapper、其他 Service）
+- @InjectMocks 注入被测类
+- setUp 中使用 ReflectionTestUtils.setField(entityService, "baseMapper", entityMapper) 注入 baseMapper
+- 使用 @Nested 类按方法分组测试
+- 使用 @DisplayName 描述测试场景（中文）
+- 测试方法命名: testMethod_scenario() 或 should_预期行为_when_条件()
+- 每个测试方法只测试一个行为
+- Mock 外部依赖（Feign 调用、Redis、数据库），不依赖外部环境
+- Arrange-Act-Assert 模式: when() → 调用方法 → assertEquals/verify
+- 执行命令: mvn test -pl <module> -Dtest=ClassNameMockTest
+
+## Java 通用编码规范
+
+- 必须使用 Java 8 语法，禁止 Java 9+ 特性（var、模块化、HttpClient）
+- 禁止 System.out.println，必须使用 @Slf4j + log.info/warn/error
+- 禁止硬编码密码、密钥、连接串（使用 Jasypt 加密或 Nacos 配置中心）
+- 禁止硬编码 IP 地址和端口
+- 方法体不超过 80 行，超过必须拆分子方法
+- 所有公共方法必须添加 Javadoc 注释
+- 使用 4 空格缩进，禁止 Tab
+- 禁止在 for 循环中发起数据库查询或远程调用
+
+## Vue 通用编码规范
+
+- 必须使用 Vue 2 Options API（data/methods/computed/watch）
+- 禁止使用 Vue 3 Composition API（setup/ref/reactive）
+- 组件 name 属性必须与文件名一致（PascalCase）
+- props 必须定义 type 和 default
+- 禁止直接修改 props，必须通过 $emit 通知父组件
+- 统一使用 View Design 4.x 组件，禁止引入其他 UI 库
+- 全局状态使用 Vuex，禁止在组件中直接修改 state
+- 组件库: tw-table, master-sub, tw-card, RemoteSelect, TableSelect, RemoteCheckbox 等全局注册组件

package/builtin/schemas/mes-prd-to-code/schema.yaml

@@ -1,6 +1,6 @@
 # MES PRD to Code Schema
 # 功能文档 → 技术文档 → 完整代码
-# 工件流: parse → confirm-scope → tech-design → tasks → code
+# 工件流: parse → confirm-scope → tech-design → tasks → test-gen → code
 
 name: mes-prd-to-code
 description: |
@@ -147,6 +147,28 @@ artifacts:
       - 如果有外部接口 → 确认接口鉴权方式
       - 如果涉及已有模块修改 → 确认修改范围和回归测试
 
+      ### Q7: 表名前缀
+      - 提问："表名的模块前缀是什么？例如 pcba_（PCBA）、mm_（仓储）、wip_（生产）、bd_（基础数据）"
+      - 根据模块推断建议值，等待用户确认
+      - 所有新建表将使用此前缀，如 `{prefix}_cad_data`
+
+      ### Q8: 表空间选择
+      - 提问："数据表归属哪个业务模块？（决定表空间）"
+      - 表空间映射规则：
+        - 生产/车间数据 → MES_DATA_WORKS（数据）/ MES_IDX_WORKS（索引）
+        - 仓储/物流数据 → MES_DATA_WMS（数据）/ MES_IDX_WMS（索引）
+        - 基础/通用数据 → MES_DATA_COM（数据）/ MES_IDX_COM（索引）
+      - 默认根据模块推断，等待用户确认
+
+      ### Q9: 索引策略
+      - 根据解析结果中的业务规则，分析需要建索引的字段，提出建议：
+        - 唯一性校验字段 → 唯一索引（U1, U2...）
+        - 高频搜索字段 → 普通索引（N1, N2...）
+        - 外键关联字段 → 普通索引
+      - **唯一索引规范**：必须以 `org_id` 作为首列，组成联合唯一索引，格式：`(org_id, 业务字段1, 业务字段2...)`
+      - 向用户展示建议的索引清单，等待确认或调整
+      - 这是持续交互过程，用户可以增减索引字段
+
       ## 确认结果记录
       将所有确认结果写入 confirm-scope 记录中，作为技术文档的输入。
       格式：
@@ -157,9 +179,12 @@ artifacts:
       - 后端包路径: com.twsz.mom.xxx
       - 前端 API 目录: src/api/xxx/
       - 前端页面目录: src/views/xxx/
+      - 表名前缀: {prefix}_
+      - 表空间: MES_DATA_xxx（数据）/ MES_IDX_xxx（索引）
       - 编号生成: @AutoGenCode / 无
       - 状态流转: 有(审核/弃审) / 无
       - 已有代码影响: [列表]
+      - 索引策略: [索引清单]
       ```
 
   - id: tech-design
@@ -173,15 +198,29 @@ artifacts:
       ## 文档结构
 
       ### 1. 数据库设计
+      - 读取 confirm-scope 中的表名前缀、表空间、索引策略
       - 将功能文档的 DDL 适配为 Oracle 语法
       - 适配规则：
         - INT/BIGINT AUTO_INCREMENT → NUMBER(19) 雪花算法
-        - VARCHAR(n) → VARCHAR2(n)
+        - VARCHAR(n) → NVARCHAR2(n)
         - DATETIME → DATE
         - CURRENT_TIMESTAMP → SYSDATE
         - 审计字段统一为: created_by, created_date, last_updated_by, last_updated_date
         - 去除 is_deleted 逻辑删除字段（MES 使用物理删除）
-      - 包含完整 DDL + 索引 + 注释
+        - 每张表必须包含 org_id NUMBER(19) NOT NULL 字段（多租户字段）
+          **重要**: org_id 仅在 DDL 中定义（用于唯一索引组合列），不在 Entity 中声明。
+          MyBatis-Plus TenantLineInnerInterceptor 已配置多租户，INSERT/SELECT 自动注入 org_id，业务代码无需显式处理。
+      {{rules}}
+      - 包含完整 DDL + 索引 + 注释 + 表空间
+      - **表名**: 使用 confirm-scope 确认的模块前缀，如 `{prefix}_cad_data`
+      - **索引命名规范**（严格遵守）:
+        - 主键索引: `{tableName}_PK`
+        - 普通索引: `{tableName}_N1`, `{tableName}_N2`, ... `{tableName}_N5`
+        - 唯一索引: `{tableName}_U1`, `{tableName}_U2`, ... `{tableName}_U5`
+        - 唯一索引必须以 `org_id` 为首列: `UNIQUE INDEX xxx_U1(tableName, org_id, 业务字段1, ...)`
+      - **表空间**（使用 confirm-scope 确认的值）:
+        - 数据段: TABLESPACE {data_tablespace}
+        - 索引段: USING INDEX TABLESPACE {index_tablespace}
       - 标注建表方式: dbx MCP（优先）/ SQL 脚本
 
       ### 2. API 接口设计
@@ -204,12 +243,20 @@ artifacts:
       对每个 Entity 给出：
 
       #### Entity（完整代码模板）
-      - 继承 BaseModel
-      - @TableName, @Data, @EqualsAndHashCode(callSuper=false)
-      - @TableId(type=IdType.ASSIGN_ID) + @JsonSerialize(ToStringSerializer)
+      - 继承 BaseModel（com.twsz.mom.ds.model.BaseModel，不是 com.twsz.mom.common.base.BaseModel）
+      - @TableName, @Data, @EqualsAndHashCode(callSuper=true)
+      - @JsonInclude(JsonInclude.Include.NON_NULL)
+      - @TableId(type=IdType.ASSIGN_ID) + @JsonSerialize(ToStringSerializer) — id 字段必须在 Entity 中显式声明
+      - BaseModel 已提供审计字段(createdBy/Date, lastUpdatedBy/Date)，Entity 中禁止重复声明
+      - ViewModel 已提供 opt 字段，Entity 中禁止重复声明
+      - org_id 禁止在 Entity 中声明（多租户 TenantLineInnerInterceptor 自动处理）
+      - @ExcelProperty("中文名")（每个业务字段，支持导入导出）
+      - 非数据库字段: @TableField(exist = false) + @ExcelIgnore
+      - Long 类型字段: @JsonSerialize(using = ToStringSerializer.class)（防止 JS 精度丢失）
       - @AutoGenCode（如有编号字段）
-      - @ExcelProperty（每个业务字段）
+      - 主子表: @TableField(exist = false) private List<DetailEntity> details
       - 给出完整 Java 代码
+      {{rules}}
 
       #### Mapper（完整代码模板）
       - 接口继承 BaseMapper<T>
@@ -227,9 +274,13 @@ artifacts:
       - 不要求完整实现代码
 
       #### Controller（完整代码模板）
-      - @RestController + @RequestMapping
-      - 每个方法的签名和参数
+      - @RestController + @RequestMapping("/api/v1/entity-kebab-case")（含版本号 /api/v1/）
+      - @Autowired 或 @Resource 字段注入（项目惯例，非构造器注入）
+      - 统一返回 ResponseWrapper<T>（com.twsz.mom.core.common.ResponseWrapper）
+      - 标准方法: search(POST) / save(POST) / delete(DELETE) / list(POST) / export(POST)
+      - Controller 只做参数校验和结果封装，禁止写业务逻辑
       - 给出完整代码
+      {{rules}}
 
       ### 4. 前端代码结构
       对每个页面给出：
@@ -303,9 +354,13 @@ artifacts:
       8. API 文件（完整代码）
       9. 列表页 index.vue（完整代码）
       10. 表单页 form.vue（完整代码）
+      11. 子表页 table-form.vue（如有主子表，完整代码）
+
+      ### 测试任务（每个 ServiceImpl 一组）
+      12. ServiceImpl 单元测试（XxxServiceImplMockTest.java）
 
       ### 配置任务
-      11. 菜单注册 SQL
+      13. 菜单注册 SQL
 
       ### 如有外部接口
       12. 外部接口 Controller（独立路径）
@@ -329,14 +384,52 @@ artifacts:
 
     output: tasks.md
 
+  - id: test-gen
+    name: 测试代码生成
+    description: 基于 ServiceImpl 生成单元测试代码
+    requires: [tasks]
+    template: test-gen.md
+    instruction: |
+      基于 tasks.md 中的 ServiceImpl 代码，生成对应的单元测试。
+
+      生成前请先读取本 schema 目录下的 references.md，了解可用的公共工具类和方法，测试中 Mock 的依赖方法签名需与 references.md 一致。
+
+      ## 测试规范
+      - 测试类名 = 原类名 + MockTest（如 PcCadDataServiceImpl → PcCadDataServiceImplMockTest）
+      - 框架: JUnit 5 + Mockito
+      - @ExtendWith(MockitoExtension.class)
+      - @Mock 模拟依赖（Mapper、其他Service）
+      - @InjectMocks 注入被测类
+      - setUp 中使用 ReflectionTestUtils.setField 注入 baseMapper
+      - 使用 @Nested 类按方法分组，@DisplayName 描述场景
+      - 测试方法命名: should_预期行为_when_条件()
+
+      ## 必须覆盖的场景
+      - saveModel: 新增成功、编辑成功、乐观锁冲突
+      - deleteByIds: 批量删除+级联
+      - search: 分页查询
+      - list: 列表查询
+      - importExcel/uploadExcel: 逐行校验、跳过统计（如有）
+
+      ## 文件路径
+      测试文件放在: src/test/java/{与ServiceImpl相同的包路径}/
+
+      ## 输出
+      - 每个 ServiceImpl 对应一个测试文件
+      - 包含完整可编译的测试代码
+      {{rules}}
+    output: test-gen.md
+
   - id: code
     name: 代码生成
     description: 按任务清单生成完整代码文件
-    requires: [tasks]
+    requires: [tasks, test-gen]
     template: code-generation.md
     instruction: |
       按任务清单逐个生成代码文件。
 
+      生成前请先读取本 schema 目录下的 references.md，了解可用的公共工具类和方法，优先复用已有方法，避免重复实现。
+
       ## 执行方式
       1. 按任务依赖顺序执行
       2. 每个任务：
@@ -348,14 +441,18 @@ artifacts:
       ## 代码规范检查
       生成的代码必须符合以下 MES 规范：
       - Java 8 语法，不使用 Java 9+ 特性
-      - Lombok 注解（@Data, @Builder 等）
+      - Lombok 注解（@Data, @EqualsAndHashCode(callSuper=true) 等）
       - SLF4J 日志（@Slf4j），不用 System.out.println
       - LambdaQueryWrapper，不用字符串字段名
       - ResponseWrapper<T> 统一响应
-      - BaseModel 继承
+      - BaseModel 继承（com.twsz.mom.ds.model.BaseModel）
+      - Entity: callSuper=true, 不重复声明 id/orgId/opt/审计字段
+      - Controller: @Autowired, @RequestMapping("/api/v1/kebab-case")
+      - 数据库字符串字段使用 NVARCHAR2
       - Vue 2 Options API
       - View Design 4 组件
-      - indexPage mixin / master-sub 组件
+      - indexPage mixin / master-sub / tw-table 组件
+      {{rules}}
 
       ## 输出
       - 所有代码文件已写入磁盘

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

@@ -14,9 +14,13 @@
 | 后端包路径 | com.twsz.mom.{module}.{sub} |
 | 前端 API 目录 | src/api/{domain}/ |
 | 前端页面目录 | src/views/{domain}/{entity}/ |
+| 表名前缀 | {prefix}_ |
+| 数据表空间 | MES_DATA_xxx |
+| 索引表空间 | MES_IDX_xxx |
 | 编号生成 | @AutoGenCode / 无 |
 | 状态流转 | 有 / 无 |
 | 已有代码影响 | <列表或无> |
+| 索引策略 | <索引清单> |
 
 ---
 
@@ -49,3 +53,15 @@
 ### Q6: 特殊技术决策
 
 <对话内容>
+
+### Q7: 表名前缀
+
+<对话内容 — 确认表的模块前缀，如 pc_、wm_、pd_ 等>
+
+### Q8: 表空间选择
+
+<对话内容 — 根据业务模块确认数据表空间和索引表空间>
+
+### Q9: 索引策略
+
+<对话内容 — 确认每张表需要哪些索引，字段列表，索引类型>

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

@@ -15,10 +15,25 @@
   - **操作**:
     ```sql
     CREATE TABLE <table_name> (
-        ...
-    );
+        id                NUMBER(19)      NOT NULL,
+        org_id            NUMBER(19)      NOT NULL,
+        -- 业务字段
+        <column_name>     <oracle_type>   <constraint>,
+        -- 审计字段
+        created_by        VARCHAR2(64),
+        created_date      DATE            DEFAULT SYSDATE,
+        last_updated_by   VARCHAR2(64),
+        last_updated_date DATE            DEFAULT SYSDATE,
+        CONSTRAINT <tableName>_PK PRIMARY KEY (id) USING INDEX TABLESPACE <index_tablespace>
+    ) TABLESPACE <data_tablespace>;
+
+    -- 唯一索引（org_id 联合，命名: 表名_U1..U5）
+    CREATE UNIQUE INDEX <tableName>_U1 ON <table_name>(org_id, <业务字段>) TABLESPACE <index_tablespace>;
+
+    -- 普通索引（命名: 表名_N1..N5）
+    CREATE INDEX <tableName>_N1 ON <table_name>(<字段>) TABLESPACE <index_tablespace>;
     ```
-  - **验证**: 表创建成功，字段和约束正确
+  - **验证**: 表创建成功，索引创建成功，表空间正确
   - **依赖**: 无
 
 ---

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

@@ -24,13 +24,42 @@
 
 ## 1. 数据库设计
 
-### 1.1 新建表
+### 1.1 索引设计规范
+
+**索引命名规范**（严格遵守）：
+
+| 索引类型 | 命名格式 | 示例 | 说明 |
+|----------|----------|------|------|
+| 主键索引 | `{tableName}_PK` | `pc_cad_data_PK` | 主键约束自动命名 |
+| 普通索引 | `{tableName}_N1` ~ `N5` | `pc_cad_data_N1` | 按顺序编号，最多 5 个 |
+| 唯一索引 | `{tableName}_U1` ~ `U5` | `pc_cad_data_U1` | 按顺序编号，最多 5 个 |
+
+**唯一索引规范**：
+- 必须以 `org_id` 作为首列，组成联合唯一索引
+- 格式: `(org_id, 业务字段1, 业务字段2, ...)`
+- 示例: `CREATE UNIQUE INDEX pc_cad_data_U1 ON pc_cad_data(org_id, material_code) TABLESPACE MES_IDX_COM;`
+
+**表空间定义**：
+
+| 表空间名称 | 用途 | 说明 |
+|------------|------|------|
+| MES_DATA_WORKS | 生产数据表空间 | 存储基础数据表、车间数据表 |
+| MES_DATA_WMS | 仓库数据表空间 | 存储仓库表 |
+| MES_DATA_COM | 基础数据表空间 | 存储基础数据表 |
+| MES_IDX_WORKS | 生产索引表空间 | 存储基础数据、主车间索引 |
+| MES_IDX_WMS | 仓库索引表空间 | 存储仓库表索引 |
+| MES_IDX_COM | 基础数据表索引空间 | 存储基础数据索引 |
+
+> 使用 confirm-scope 中确认的表空间。数据表使用 `MES_DATA_xxx`，索引使用 `MES_IDX_xxx`。
+
+### 1.2 新建表
 
 #### 表: <table_name>
 
 ```sql
 CREATE TABLE <table_name> (
     id                NUMBER(19)      NOT NULL,
+    org_id            NUMBER(19)      NOT NULL,
     -- 业务字段
     <column_name>     <oracle_type>   <constraint>,
     -- 审计字段
@@ -38,24 +67,40 @@ CREATE TABLE <table_name> (
     created_date      DATE            DEFAULT SYSDATE,
     last_updated_by   VARCHAR2(64),
     last_updated_date DATE            DEFAULT SYSDATE,
-    CONSTRAINT pk_<table_name> PRIMARY KEY (id)
-);
+    CONSTRAINT <tableName>_PK PRIMARY KEY (id) USING INDEX TABLESPACE <index_tablespace>
+) TABLESPACE <data_tablespace>;
 
 COMMENT ON TABLE <table_name> IS '<表中文名>';
 COMMENT ON COLUMN <table_name>.id IS '主键';
+COMMENT ON COLUMN <table_name>.org_id IS '组织ID';
 -- 其他字段注释
 ```
 
 **索引**:
 
-| 索引名 | 字段 | 类型 | 说明 |
-|--------|------|------|------|
-| | | UNIQUE / NORMAL | |
+| 索引名 | 字段 | 类型 | 表空间 | 说明 |
+|--------|------|------|--------|------|
+| `<tableName>_U1` | org_id, <业务字段> | UNIQUE | `<index_tablespace>` | 联合唯一（org_id 首列） |
+| `<tableName>_N1` | <字段> | NORMAL | `<index_tablespace>` | 普通索引 |
+
+**索引创建语句**:
+
+```sql
+-- 唯一索引（org_id 联合）
+CREATE UNIQUE INDEX <tableName>_U1 ON <table_name>(org_id, <业务字段>) TABLESPACE <index_tablespace>;
+
+-- 普通索引
+CREATE INDEX <tableName>_N1 ON <table_name>(<字段>) TABLESPACE <index_tablespace>;
+```
 
 **建表方式**:
 - [ ] dbx MCP 工具（优先）
 - [ ] SQL 脚本执行
 
+> **org_id 处理说明**: org_id 仅在 DDL 中定义（用于唯一索引组合列），**不在 Entity 中声明**。
+> MyBatis-Plus `TenantLineInnerInterceptor` 已配置多租户，INSERT/SELECT/UPDATE/DELETE 自动注入 `org_id` 条件。
+> 业务代码（Entity、Mapper XML、Service、Controller）无需显式处理 org_id。
+
 ### 1.2 修改表（如有）
 
 #### 表: <existing_table_name>

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

@@ -0,0 +1,77 @@
+# 测试生成报告: {{changeName}}
+
+> 输入: 任务清单 (tasks.md) 中的 ServiceImpl 代码
+> 生成日期: {{date}}
+
+---
+
+## 1. 测试文件清单
+
+| # | 测试文件 | 被测类 | Mock 依赖 | 测试方法数 |
+|:-:|----------|--------|-----------|:----------:|
+| 1 | `src/test/java/{package}/XxxServiceImplMockTest.java` | XxxServiceImpl | Mapper, DetailService | N |
+
+---
+
+## 2. 测试详情
+
+### 2.1 XxxServiceImplMockTest
+
+**被测类**: `com.twsz.mom.xxx.service.impl.XxxServiceImpl`
+
+**Mock 依赖**:
+| # | 字段 | 类型 | 说明 |
+|:-:|------|------|------|
+| 1 | xxxMapper | XxxMapper | 主表 Mapper |
+| 2 | detailService | XxxDetailService | 子表 Service |
+
+**测试用例**:
+
+| # | @Nested 分组 | 方法名 | 场景 | 断言 |
+|:-:|-------------|--------|------|------|
+| 1 | saveModel方法测试 | should_insert_when_idIsNull | 新增成功 | verify(mapper).insert(any) |
+| 2 | saveModel方法测试 | should_update_when_idNotNull | 编辑成功 | verify(mapper).updateById(any) |
+| 3 | saveModel方法测试 | should_throw_when_optimisticLockFails | 乐观锁冲突 | assertThrows(BaseException) |
+| 4 | deleteByIds方法测试 | should_deleteByIds_when_givenIds | 批量删除 | verify(mapper).deleteBatchIds(any) |
+| 5 | search方法测试 | should_returnPage_when_search | 分页查询 | assertNotNull(result) |
+| 6 | list方法测试 | should_returnList_when_list | 列表查询 | assertNotNull(result) |
+
+**测试代码结构**:
+
+```java
+@ExtendWith(MockitoExtension.class)
+class XxxServiceImplMockTest {
+
+    @Mock
+    private XxxMapper xxxMapper;
+
+    @Mock
+    private XxxDetailService detailService;
+
+    @InjectMocks
+    private XxxServiceImpl xxxService;
+
+    @BeforeEach
+    void setUp() {
+        ReflectionTestUtils.setField(xxxService, "baseMapper", xxxMapper);
+    }
+
+    @Nested
+    @DisplayName("saveModel方法测试")
+    class SaveModelTests {
+        @Test
+        @DisplayName("新增成功")
+        void should_insert_when_idIsNull() { ... }
+    }
+}
+```
+
+---
+
+## 3. 统计
+
+| 维度 | 数量 |
+|------|:----:|
+| 测试文件数 | N |
+| 测试方法总数 | N |
+| Mock 依赖总数 | N |

package/package.json

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