Initial commit: 1人+2AI协作框架 - 完整目录结构和AI宪法

2026-05-22 15:27:36 +08:00
commit 837d067928
30 changed files with 1498 additions and 0 deletions
@@ -0,0 +1,20 @@
+# CROSS-001 - 验收标准
+
+## 功能验收
+- [ ] 字符串处理工具优化完成
+- [ ] 日期格式化工具添加完成
+- [ ] 日志工具bug修复完成
+- [ ] P01 项目测试通过
+- [ ] P02 项目测试通过
+
+## 非功能验收
+- [ ] 工具函数性能提升 >= 20%
+- [ ] 代码覆盖率 >= 80%
+
+## 测试覆盖要求
+- P01 回归测试覆盖率: >= 90%
+- P02 回归测试覆盖率: >= 90%
+
+## 验收通过条件
+- 所有功能点验证通过
+- 两个项目回归测试通过
@@ -0,0 +1,23 @@
+# CROSS-001 - P01 测试反馈
+
+## 测试执行信息
+- 测试时间: 2026-05-23
+- 测试项目: P01_errlens_app
+- 测试人员: QA AI
+
+## 测试结果概览
+- 测试用例总数: 15
+- 通过: 14
+- 失败: 1
+- 跳过: 0
+
+## 失败用例详情
+- **测试点**: API响应日期格式
+- **预期结果**: 返回 ISO 8601 格式日期
+- **实际结果**: 返回格式不一致
+- **严重程度**: MEDIUM
+- **建议修复**: 统一日期格式化输出
+
+## 代码质量评估
+- 代码覆盖率: 85%
+- 静态检查警告: 0 个
@@ -0,0 +1,19 @@
+# CROSS-001 - P02 测试反馈
+
+## 测试执行信息
+- 测试时间: 2026-05-23
+- 测试项目: P02_errlens_training
+- 测试人员: QA AI
+
+## 测试结果概览
+- 测试用例总数: 12
+- 通过: 12
+- 失败: 0
+- 跳过: 0
+
+## 代码质量评估
+- 代码覆盖率: 88%
+- 静态检查警告: 0 个
+
+## 测试结论
+P02 项目测试全部通过，工具库更新未引入新问题。
@@ -0,0 +1,22 @@
+# CROSS-001 - 变更影响范围
+
+## 修改的文件
+| 文件路径 | 修改类型 | 影响等级 |
+|---------|---------|---------|
+| shared/utils/stringUtils.js | 更新 | HIGH |
+| shared/utils/dateUtils.js | 新增 | MEDIUM |
+| shared/utils/logUtils.js | 更新 | HIGH |
+
+## 影响的项目和模块
+- **P01_errlens_app**:
+  - [x] API模块
+  - [x] 工具模块
+- **P02_errlens_training**:
+  - [x] 数据处理模块
+  - [x] 日志模块
+
+## 需要回归测试的场景
+- P01: API响应格式验证
+- P01: 日志记录完整性
+- P02: 数据处理流程
+- P02: 训练日志输出
@@ -0,0 +1,26 @@
+# CROSS-001 - 共享工具库更新
+
+## 任务信息
+- 任务编号: CROSS-001
+- 项目: 跨项目任务
+- 创建时间: 2026-05-22
+- 负责人: Dev AI
+- 状态: TODO
+
+## 任务描述
+更新 shared/utils/ 中的工具函数，修复影响 P01 和 P02 的通用问题：
+1. 优化字符串处理工具
+2. 添加日期格式化工具
+3. 修复日志工具的bug
+
+## 影响项目
+- P01_errlens_app
+- P02_errlens_training
+
+## 需求来源
+- 技术债务清理计划
+
+## 交付物
+- `shared/utils/stringUtils.js` - 字符串处理工具
+- `shared/utils/dateUtils.js` - 日期格式化工具
+- `shared/utils/logUtils.js` - 日志工具修复
@@ -0,0 +1,24 @@
+# P01-001 - 验收标准
+
+## 功能验收
+- [ ] 用户可以注册新账户
+- [ ] 用户可以使用邮箱密码登录
+- [ ] 登录成功返回 JWT Token
+- [ ] 密码错误时返回明确的错误信息
+- [ ] 支持密码重置功能
+
+## 非功能验收
+- [ ] 密码使用 bcrypt 加密存储
+- [ ] JWT Token 有效期为 24 小时
+- [ ] 密码强度验证（至少8位，包含大小写和数字）
+- [ ] API 响应时间 < 200ms
+
+## 测试覆盖要求
+- 单元测试覆盖率: >= 80%
+- 集成测试覆盖率: >= 60%
+- E2E 测试场景: 3 个
+
+## 验收通过条件
+- 所有功能点验证通过
+- 测试覆盖率达标
+- 无重大安全漏洞
@@ -0,0 +1,37 @@
+# P01-001 - 第一轮测试反馈
+
+## 测试执行信息
+- 测试时间: 2026-05-23
+- 测试人员: QA AI
+- 测试环境: 测试服务器
+
+## 测试结果概览
+- 测试用例总数: 12
+- 通过: 10
+- 失败: 2
+- 跳过: 0
+
+## 失败用例详情
+
+### 1. 用户注册 - 密码强度验证
+- **测试点**: 密码强度验证
+- **预期结果**: 密码不足8位时拒绝注册
+- **实际结果**: 密码6位也能注册成功
+- **严重程度**: HIGH
+- **建议修复**: 增加密码长度验证逻辑
+
+### 2. Token 过期测试
+- **测试点**: Token 过期处理
+- **预期结果**: Token 过期后返回 401 错误
+- **实际结果**: 返回 500 服务器错误
+- **严重程度**: MEDIUM
+- **建议修复**: 在中间件中正确处理 TokenExpiredError
+
+## 代码质量评估
+- 代码覆盖率: 78% (目标: 80%)
+- 静态检查警告: 3 个
+- 建议优化: authService.js 第45行有未使用的变量
+
+## 下一步行动
+- Dev AI 修复上述问题
+- 进行第二轮测试
@@ -0,0 +1,26 @@
+# P01-001 - 变更影响范围
+
+## 修改的文件
+| 文件路径 | 修改类型 | 影响等级 |
+|---------|---------|---------|
+| src/api/users.js | 新增 | HIGH |
+| src/controllers/userController.js | 新增 | HIGH |
+| src/services/authService.js | 新增 | HIGH |
+| docs/03_接口定义.md | 更新 | MEDIUM |
+| src/models/User.js | 更新 | MEDIUM |
+
+## 影响的功能模块
+- [x] 用户管理模块
+- [x] 认证授权模块
+- [ ] 代码分析模块（无影响）
+- [ ] AI服务模块（无影响）
+
+## 需要回归测试的场景
+- 场景1: 用户注册后立即登录
+- 场景2: 使用错误密码登录
+- 场景3: 密码重置流程
+- 场景4: Token 过期后重新登录
+
+## 外部依赖变更
+- 新增依赖: bcrypt, jsonwebtoken
+- 影响说明: 需更新 package.json
@@ -0,0 +1,30 @@
+# P01-001 - 用户登录功能开发
+
+## 任务信息
+- 任务编号: P01-001
+- 项目: P01_errlens_app
+- 创建时间: 2026-05-22
+- 负责人: Dev AI
+- 状态: TODO
+
+## 任务描述
+实现用户登录功能，包括：
+1. 用户注册
+2. 用户登录（邮箱+密码）
+3. JWT Token 生成
+4. 密码重置
+
+## 需求来源
+- 产品需求文档: PRD-001
+- 相关Issue: #123
+
+## 技术要求
+- 使用 bcrypt 进行密码加密
+- JWT Token 有效期 24 小时
+- 支持密码强度验证
+
+## 交付物
+- `src/api/users.js` - 用户API路由
+- `src/controllers/userController.js` - 用户控制器
+- `src/services/authService.js` - 认证服务
+- `docs/03_接口定义.md` - 更新接口文档
@@ -0,0 +1,21 @@
+# P01-002 - 验收标准
+
+## 功能验收
+- [ ] 支持 JavaScript/TypeScript 代码分析
+- [ ] 支持 Python 代码分析
+- [ ] 检测常见语法错误
+- [ ] 检测代码质量问题
+- [ ] 生成修复建议
+
+## 非功能验收
+- [ ] 分析时间 < 500ms
+- [ ] 支持最大 1000 行代码
+- [ ] 错误分类准确率 >= 90%
+
+## 测试覆盖要求
+- 单元测试覆盖率: >= 75%
+- 集成测试覆盖率: >= 50%
+
+## 验收通过条件
+- 所有功能点验证通过
+- 测试覆盖率达标
@@ -0,0 +1,18 @@
+# P01-002 - 变更影响范围
+
+## 修改的文件
+| 文件路径 | 修改类型 | 影响等级 |
+|---------|---------|---------|
+| src/api/analyze.js | 新增 | HIGH |
+| src/controllers/analyzeController.js | 新增 | HIGH |
+| src/services/analyzeService.js | 新增 | HIGH |
+
+## 影响的功能模块
+- [x] 代码分析模块
+- [x] AI服务模块
+- [ ] 用户管理模块（无影响）
+
+## 需要回归测试的场景
+- 场景1: JavaScript 代码分析
+- 场景2: Python 代码分析
+- 场景3: 大文件分析性能
@@ -0,0 +1,27 @@
+# P01-002 - 代码分析API开发
+
+## 任务信息
+- 任务编号: P01-002
+- 项目: P01_errlens_app
+- 创建时间: 2026-05-22
+- 负责人: Dev AI
+- 状态: TODO
+
+## 任务描述
+实现代码分析API，包括：
+1. 代码解析
+2. 错误检测
+3. 修复建议生成
+
+## 需求来源
+- 产品需求文档: PRD-002
+
+## 技术要求
+- 支持多种编程语言
+- 与AI服务模块集成
+- 返回结构化的错误信息
+
+## 交付物
+- `src/api/analyze.js` - 分析API路由
+- `src/controllers/analyzeController.js` - 分析控制器
+- `src/services/analyzeService.js` - 分析服务
@@ -0,0 +1,19 @@
+# P02-001 - 验收标准
+
+## 功能验收
+- [ ] 支持从 GitHub 下载代码仓库
+- [ ] 自动清洗无效代码
+- [ ] 支持人工标注接口
+- [ ] 提取代码特征向量
+
+## 非功能验收
+- [ ] 处理速度: 1000 文件/分钟
+- [ ] 内存占用: < 2GB
+- [ ] 数据准确率: >= 95%
+
+## 测试覆盖要求
+- 单元测试覆盖率: >= 80%
+
+## 验收通过条件
+- 所有功能点验证通过
+- 测试覆盖率达标
@@ -0,0 +1,18 @@
+# P02-001 - 变更影响范围
+
+## 修改的文件
+| 文件路径 | 修改类型 | 影响等级 |
+|---------|---------|---------|
+| src/data/download.py | 新增 | HIGH |
+| src/data/clean.py | 新增 | HIGH |
+| src/data/label.py | 新增 | MEDIUM |
+| src/data/features.py | 新增 | HIGH |
+
+## 影响的功能模块
+- [x] 数据处理模块
+- [x] 模型训练模块
+
+## 需要回归测试的场景
+- 场景1: 大规模数据下载
+- 场景2: 数据清洗质量
+- 场景3: 特征提取准确性
@@ -0,0 +1,29 @@
+# P02-001 - 数据集预处理模块
+
+## 任务信息
+- 任务编号: P02-001
+- 项目: P02_errlens_training
+- 创建时间: 2026-05-22
+- 负责人: Dev AI
+- 状态: TODO
+
+## 任务描述
+实现数据集预处理模块，包括：
+1. 数据下载
+2. 数据清洗
+3. 数据标注
+4. 特征提取
+
+## 需求来源
+- 模型训练需求文档
+
+## 技术要求
+- 支持多线程处理
+- 数据格式标准化
+- 支持增量更新
+
+## 交付物
+- `src/data/download.py` - 数据下载
+- `src/data/clean.py` - 数据清洗
+- `src/data/label.py` - 数据标注
+- `src/data/features.py` - 特征提取