Просмотр исходного кода

docs(story): 更新故事012.003待解决问题记录

yourname 1 неделя назад
Родитель
Сommit
fe2c057f4d
1 измененных файлов с 36 добавлено и 3 удалено
  1. 36 3
      docs/stories/012.003.story.md

+ 36 - 3
docs/stories/012.003.story.md

@@ -339,6 +339,7 @@ Completed ✅ (代码实现和测试配置完成)
 |------|------|------|------|
 | 2025-12-16 | 1.0 | 初始故事创建 | Bob(Scrum Master) |
 | 2025-12-16 | 1.1 | 更新开发代理记录,添加文件列表和完成笔记 | James |
+| 2025-12-16 | 1.2 | 修复测试配置问题,添加待解决问题记录 | James |
 
 ## 开发代理记录
 此部分由开发代理在实施过程中填充
@@ -367,12 +368,44 @@ claude-sonnet
 - ✅ 集成测试已编写:
   - `company-statistics.integration.test.ts`(公司统计API测试)
   - `person-extension.integration.test.ts`(人才扩展API测试)
-- ⚠️ 测试配置问题需要修复:
-  - 公司模块缺少`@d8d/allin-disability-module`依赖
-  - 残疾人模块测试缺少`BankName`实体配置
+- ✅ 测试配置问题已修复:
+  - 公司模块已添加`@d8d/allin-disability-module`和`@d8d/bank-names-module`依赖
+  - 残疾人模块测试已添加`BankName`、`DisabledPhoto`、`DisabledRemark`、`DisabledVisit`实体配置
+  - 修复测试数据字段缺失:添加`phone`、`province`、`city`等必填字段
+  - 修复`gender`字段类型问题:将数字类型改为字符串'男'/'女'
+  - 修复外键约束错误:创建实际的`BankName`记录
+- ⚠️ 测试路由路径问题待修复:
+  - 路由定义路径与测试调用路径不匹配,导致404错误
+  - 需要确定正确的API路径前缀配置方式
 - ✅ 代码符合项目编码标准和架构规范
 
 
+### 待解决问题
+**测试路由路径不匹配问题**:
+1. **问题描述**:集成测试调用路由路径与路由定义不匹配
+   - 测试调用路径:`client.api.v1.yongren.company.overview.$get()` (对应 `/api/v1/yongren/company/overview`)
+   - 路由定义路径:`path: '/company/overview'` (缺少 `/api/v1/yongren` 前缀)
+   - 导致测试返回404错误
+
+2. **根本原因分析**:
+   - 对比企业认证模块(`auth-module`)的路由定义:`path: '/api/v1/yongren/auth/login'` (包含完整前缀)
+   - 公司管理模块(`company-module`)的路由定义:`path: '/createCompany'` (无前缀,但测试调用`client.createCompany.$post()`)
+   - 需要确认模块内部路由路径规范:是否应该包含完整API前缀`/api/v1/yongren`
+
+3. **需调查事项**:
+   - RPC客户端生成逻辑:`testClient`如何生成`api.v1.yongren`路径结构
+   - 模块路由注册机制:不同模块的路由如何被聚合到server包
+   - 路径前缀配置方式:是通过`basePath()`设置,还是在路由定义中包含完整路径
+
+4. **解决方案选项**:
+   - 选项A:在模块内部路由定义中添加完整前缀`/api/v1/yongren`
+   - 选项B:在模块路由聚合时设置`basePath('/api/v1/yongren')`
+   - 选项C:调整测试调用方式,使用正确的客户端路径
+
+**其他需要修复的问题**:
+- 集成测试中的响应字段验证需要更新:`订单数` → `进行中订单数`
+- 测试数据创建逻辑需要优化:避免唯一性约束冲突
+
 ### 文件列表
 **公司模块 (`allin-packages/company-module/`)**:
 - `src/routes/company-statistics.route.ts` - 企业统计API路由