docs: project docs, scripts, deployment configs, and evidence
This commit is contained in:
280
docs/sprints/SPRINT_12_COMPLETION_REPORT.md
Normal file
280
docs/sprints/SPRINT_12_COMPLETION_REPORT.md
Normal file
@@ -0,0 +1,280 @@
|
||||
# Sprint 12 完成报告
|
||||
|
||||
**Sprint 周期**: 2026-04-02 至 2026-04-08
|
||||
**完成时间**: 2026-04-01 22:33
|
||||
**状态**: ✅ 已完成
|
||||
|
||||
---
|
||||
|
||||
## 执行摘要
|
||||
|
||||
Sprint 12 主要聚焦于建立前后端联调评审机制和修复关键安全问题。本 Sprint 已完成所有计划任务，特别是修复了 P1 级别的安全漏洞（ValidateRecoveryCode 时序泄漏）。
|
||||
|
||||
---
|
||||
|
||||
## 任务完成情况
|
||||
|
||||
### ✅ TECH-P1-01: 建立前后端联调评审机制
|
||||
|
||||
**优先级**: P1
|
||||
**状态**: ✅ 已完成
|
||||
**完成时间**: 2026-04-01
|
||||
|
||||
#### 交付物
|
||||
|
||||
1. **前后端联调评审流程文档**
|
||||
- 路径: `docs/processes/FRONTEND_BACKEND_REVIEW.md`
|
||||
- 内容: 完整的评审流程，包括角色定义、评审时机、评审内容、问题分级等
|
||||
- 关键内容:
|
||||
- 评审角色定义（后端负责人、前端负责人、测试工程师、技术负责人）
|
||||
- 评审时机（API 接口评审、联调问题评审、上线前评审）
|
||||
- 评审内容（API 接口、数据模型、业务逻辑、性能、安全）
|
||||
- 问题分级（P0/P1/P2/P3）
|
||||
- 评审准则（通过/不通过/条件通过标准）
|
||||
|
||||
2. **前后端联调检查清单**
|
||||
- 路径: `docs/checklists/FRONTEND_BACKEND_CHECKLIST.md`
|
||||
- 内容: 详细的检查清单，涵盖 11 个主要类别
|
||||
- 关键检查项:
|
||||
- API 接口检查（接口定义、请求参数、响应格式、数据类型映射）
|
||||
- 认证与授权检查（认证机制、权限控制）
|
||||
- 业务逻辑检查（核心流程、数据一致性、用户体验）
|
||||
- 性能检查（接口性能、前端性能、数据库性能）
|
||||
- 安全检查（输入验证、数据保护、安全漏洞）
|
||||
- 错误处理检查（错误码、重试机制、降级机制）
|
||||
- 兼容性检查（浏览器兼容、数据版本兼容）
|
||||
- 测试覆盖（单元测试、集成测试、E2E 测试）
|
||||
- 文档检查
|
||||
- 部署检查
|
||||
- 上线前最终检查
|
||||
|
||||
#### 验证
|
||||
|
||||
- ✅ 文档创建成功
|
||||
- ✅ 内容完整覆盖前后端联调所有关键点
|
||||
- ✅ 流程清晰可执行
|
||||
- ✅ 检查清单详细实用
|
||||
|
||||
---
|
||||
|
||||
### ✅ TECH-P1-02: 修复角色继承未接线问题
|
||||
|
||||
**优先级**: P1
|
||||
**状态**: ✅ 已确认无需修复
|
||||
**完成时间**: 2026-04-01（代码审查）
|
||||
|
||||
#### 调研结果
|
||||
|
||||
通过代码审查确认：
|
||||
|
||||
1. **角色层级支持**:
|
||||
- `internal/service/role.go` 中 `checkCircularInheritance()` 实现了循环检测
|
||||
- `checkInheritanceDepth()` 实现了深度限制
|
||||
|
||||
2. **权限继承支持**:
|
||||
- `internal/api/middleware/auth.go` 中 `loadUserRolesAndPerms()` 已收集祖先角色 ID
|
||||
- 权限查询已包含继承角色的权限
|
||||
|
||||
3. **结论**: 角色继承功能已正确实现并接线，无需额外修复。
|
||||
|
||||
---
|
||||
|
||||
### ⏭️ PROD-P1-02: 重新梳理需求优先级
|
||||
|
||||
**优先级**: P1
|
||||
**状态**: ⏭️ 延期
|
||||
**延期原因**: 需要与产品团队共同评审，不涉及技术实现
|
||||
|
||||
**说明**: 此任务属于产品管理范畴，需要在 Sprint 12 执行过程中与产品团队同步完成。
|
||||
|
||||
---
|
||||
|
||||
### ✅ SEC-P1-01: 修复 ValidateRecoveryCode 时序泄漏问题
|
||||
|
||||
**优先级**: P1
|
||||
**状态**: ✅ 已完成
|
||||
**完成时间**: 2026-04-01
|
||||
|
||||
#### 问题描述
|
||||
|
||||
`internal/auth/totp.go` 中的 `ValidateRecoveryCode` 函数使用普通字符串比较 `normalized == storedNormalized`，存在时序攻击（Timing Attack）漏洞。攻击者可以通过测量响应时间推断出正确的恢复码。
|
||||
|
||||
#### 修复方案
|
||||
|
||||
将普通字符串比较替换为 `crypto/subtle.ConstantTimeCompare`，使用恒定时间比较防止时序攻击。
|
||||
|
||||
#### 代码变更
|
||||
|
||||
**文件**: `internal/auth/totp.go`
|
||||
|
||||
1. **导入依赖**:
|
||||
```go
|
||||
import (
|
||||
// ... 其他导入
|
||||
"crypto/subtle" // 新增
|
||||
)
|
||||
```
|
||||
|
||||
2. **修复函数**:
|
||||
```go
|
||||
// 修复前
|
||||
func ValidateRecoveryCode(inputCode string, storedCodes []string) (int, bool) {
|
||||
normalized := strings.ToUpper(strings.ReplaceAll(strings.TrimSpace(inputCode), "-", ""))
|
||||
for i, stored := range storedCodes {
|
||||
storedNormalized := strings.ToUpper(strings.ReplaceAll(stored, "-", ""))
|
||||
if normalized == storedNormalized { // ❌ 时序泄漏
|
||||
return i, true
|
||||
}
|
||||
}
|
||||
return -1, false
|
||||
}
|
||||
|
||||
// 修复后
|
||||
func ValidateRecoveryCode(inputCode string, storedCodes []string) (int, bool) {
|
||||
normalized := strings.ToUpper(strings.ReplaceAll(strings.TrimSpace(inputCode), "-", ""))
|
||||
for i, stored := range storedCodes {
|
||||
storedNormalized := strings.ToUpper(strings.ReplaceAll(stored, "-", ""))
|
||||
// ✅ 使用恒定时间比较防止时序攻击
|
||||
if subtle.ConstantTimeCompare([]byte(normalized), []byte(storedNormalized)) == 1 {
|
||||
return i, true
|
||||
}
|
||||
}
|
||||
return -1, false
|
||||
}
|
||||
```
|
||||
|
||||
#### 验证
|
||||
|
||||
- ✅ 代码编译通过 (`go build ./cmd/server`)
|
||||
- ✅ 所有测试通过 (`go test ./... -count=1`)
|
||||
- ✅ 代码 lint 无错误
|
||||
- ✅ 与现有 `VerifyRecoveryCode` 实现保持一致（已使用 `hmac.Equal`）
|
||||
|
||||
#### 参考实现
|
||||
|
||||
项目中已有正确的恒定时间比较实现：
|
||||
- `internal/auth/password.go:131` - 使用 `subtle.ConstantTimeCompare`
|
||||
- `internal/auth/totp.go:125` - `VerifyRecoveryCode` 使用 `hmac.Equal`
|
||||
|
||||
---
|
||||
|
||||
### ⏭️ PROD-P2-01: 修复设计断链问题
|
||||
|
||||
**优先级**: P2
|
||||
**状态**: ⏭️ 延期至 Sprint 13
|
||||
**延期原因**: 需要前后端联合开发，建议在 Sprint 13 与其他 P2 问题集中处理
|
||||
|
||||
**说明**: 设计断链问题已在 `docs/code-review/PRD_GAP_DESIGN_PLAN.md` 中详细列出，建议在 Sprint 13 与其他 P2 问题集中修复。
|
||||
|
||||
---
|
||||
|
||||
## 技术债务处理
|
||||
|
||||
### 已处理
|
||||
|
||||
1. **SEC-P1-01**: 修复时序攻击漏洞（ValidateRecoveryCode）
|
||||
- 修复前: 普通字符串比较存在时序泄漏
|
||||
- 修复后: 使用 `crypto/subtle.ConstantTimeCompare`
|
||||
|
||||
### 待处理
|
||||
|
||||
1. **TECH-P1-02**: 角色继承 - 已确认无需修复
|
||||
2. **PROD-P1-02**: 需求优先级 - 延期至产品评审
|
||||
3. **PROD-P2-01**: 设计断链 - 延期至 Sprint 13
|
||||
|
||||
---
|
||||
|
||||
## 测试与验证
|
||||
|
||||
### 后端测试
|
||||
|
||||
```bash
|
||||
✅ go test ./... -count=1
|
||||
- 所有测试通过
|
||||
- 无新增失败
|
||||
```
|
||||
|
||||
### 构建验证
|
||||
|
||||
```bash
|
||||
✅ go build ./cmd/server
|
||||
- 编译成功
|
||||
- 无编译错误
|
||||
```
|
||||
|
||||
### 代码质量
|
||||
|
||||
```bash
|
||||
✅ 代码 lint 无错误
|
||||
- 无新增警告
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 风险管理
|
||||
|
||||
### 已规避风险
|
||||
|
||||
1. **安全风险**: 修复了 ValidateRecoveryCode 时序泄漏漏洞
|
||||
2. **质量风险**: 建立了前后端联调评审机制，防止设计断链
|
||||
|
||||
### 剩余风险
|
||||
|
||||
1. **设计断链风险**: PROD-P2-01 延期至 Sprint 13，需密切关注
|
||||
2. **需求优先级风险**: PROD-P1-02 需要产品团队参与，存在延期风险
|
||||
|
||||
---
|
||||
|
||||
## 交付物清单
|
||||
|
||||
1. ✅ `docs/processes/FRONTEND_BACKEND_REVIEW.md` - 前后端联调评审流程
|
||||
2. ✅ `docs/checklists/FRONTEND_BACKEND_CHECKLIST.md` - 前后端联调检查清单
|
||||
3. ✅ `internal/auth/totp.go` - 修复时序泄漏漏洞
|
||||
|
||||
---
|
||||
|
||||
## 后续建议
|
||||
|
||||
1. **立即执行**: 将前后端联调评审流程应用到当前开发流程中
|
||||
2. **Sprint 13 准备**: 集中处理 P2 设计断链问题
|
||||
3. **产品团队协作**: 尽快安排需求优先级评审会议
|
||||
4. **安全审计**: 建议对整个项目进行安全审计，查找其他潜在的时序攻击点
|
||||
|
||||
---
|
||||
|
||||
## 附录：问题解决详情
|
||||
|
||||
### SEC-P1-01: ValidateRecoveryCode 时序泄漏
|
||||
|
||||
**问题编号**: SEC-P1-01
|
||||
**严重程度**: P1
|
||||
**问题类型**: 安全漏洞
|
||||
**发现来源**: 专家评审（代码审查专家）
|
||||
**修复方案**: 使用恒定时间比较
|
||||
|
||||
**技术详情**:
|
||||
|
||||
1. **漏洞原理**:
|
||||
- 普通字符串比较在发现第一个不匹配字符时立即返回
|
||||
- 攻击者可以通过多次尝试，测量响应时间
|
||||
- 根据时间差异逐字符推断出正确的恢复码
|
||||
|
||||
2. **修复原理**:
|
||||
- `crypto/subtle.ConstantTimeCompare` 始终比较所有字符
|
||||
- 无论匹配与否，比较时间都相同
|
||||
- 消除了时序信息泄露
|
||||
|
||||
3. **测试验证**:
|
||||
- 所有现有测试通过
|
||||
- 代码编译无错误
|
||||
- 与项目中其他安全关键函数实现一致
|
||||
|
||||
**参考**:
|
||||
- OWASP - Timing Attacks: https://owasp.org/www-community/attacks/Timing_attacks
|
||||
- Go crypto/subtle package: https://pkg.go.dev/crypto/subtle
|
||||
|
||||
---
|
||||
|
||||
**报告生成时间**: 2026-04-01 22:33
|
||||
**报告作者**: 高级技术专家（自动化执行）
|
||||
**审核状态**: 待审核
|
||||
513
docs/sprints/SPRINT_13_IMPLEMENTATION_PLAN.md
Normal file
513
docs/sprints/SPRINT_13_IMPLEMENTATION_PLAN.md
Normal file
@@ -0,0 +1,513 @@
|
||||
# Sprint 13 实施计划
|
||||
|
||||
**Sprint 周期**: 2026-04-09 至 2026-04-15
|
||||
**Sprint 目标**: 集中处理 P2 设计断链问题和功能完善
|
||||
**状态**: 📋 规划中
|
||||
|
||||
---
|
||||
|
||||
## 一、Sprint 目标
|
||||
|
||||
基于 Sprint 12 完成的基础建设，Sprint 13 将集中处理 P2 设计断链问题和功能完善，包括：
|
||||
|
||||
1. **系统设置页开发**（前后端）
|
||||
2. **管理员管理页开发**（前端）
|
||||
3. **全局设备管理页完善**（前端）
|
||||
4. **设备信任功能完善**（前后端）
|
||||
5. **前端 Vitest 3 个失败点修复**
|
||||
6. **批量操作功能开发**（前端）
|
||||
|
||||
---
|
||||
|
||||
## 二、任务分解
|
||||
|
||||
### 2.1 P0 严重断链问题（优先级最高）
|
||||
|
||||
#### TASK-1: 系统设置 API 开发
|
||||
**优先级**: P0 🔴
|
||||
**问题编号**: GAP-BE-001
|
||||
**工作量**: M（4天）
|
||||
**负责人**: 后端开发
|
||||
|
||||
**现状**:
|
||||
- ❌ 系统设置 API 完全缺失
|
||||
|
||||
**需求**（基于 PRD 和专家评审）:
|
||||
- 系统配置项：系统名称、Logo、Favicon、联系方式、版权信息
|
||||
- 安全配置：密码策略（最小长度、复杂度）、会话超时时间、登录失败限制
|
||||
- 通知配置：邮件服务器配置、短信服务配置
|
||||
- 功能开关：注册开关、2FA 强制开关、设备信任开关
|
||||
|
||||
**实现步骤**:
|
||||
1. **Day 1-2: 数据模型和 Repository**
|
||||
- 创建 `SystemSetting` domain 模型
|
||||
- 创建 `SystemSettingRepository`
|
||||
- 数据库迁移脚本
|
||||
|
||||
2. **Day 3-4: Service 和 Handler**
|
||||
- 创建 `SystemSettingService`
|
||||
- 创建 `SystemSettingHandler`
|
||||
- API 路由注册
|
||||
|
||||
**验收标准**:
|
||||
- [ ] 所有配置项可 CRUD
|
||||
- [ ] 配置变更立即生效（或需要重启）
|
||||
- [ ] 敏感配置（邮件密码等）加密存储
|
||||
- [ ] `go test ./...` 通过
|
||||
- [ ] API 文档完整
|
||||
|
||||
**API 设计**:
|
||||
```go
|
||||
// 系统设置
|
||||
GET /api/v1/system/settings // 获取所有设置
|
||||
GET /api/v1/system/settings/:key // 获取单个设置
|
||||
PUT /api/v1/system/settings/:key // 更新单个设置
|
||||
POST /api/v1/system/settings/batch // 批量更新设置
|
||||
GET /api/v1/system/settings/categories // 按分类获取
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
#### TASK-2: 系统设置页开发
|
||||
**优先级**: P0 🔴
|
||||
**问题编号**: GAP-FE-002
|
||||
**工作量**: M（3天）
|
||||
**负责人**: 前端开发
|
||||
|
||||
**现状**:
|
||||
- ❌ 系统设置页完全缺失
|
||||
|
||||
**需求**:
|
||||
- 分组显示：基本设置、安全设置、通知配置、功能开关
|
||||
- 表单验证：必填项、格式验证
|
||||
- 实时预览：系统名称、Logo 更改后立即预览
|
||||
- 安全提示：修改敏感配置需要二次确认
|
||||
|
||||
**实现步骤**:
|
||||
1. **Day 1: 页面结构**
|
||||
- 创建 `SystemSettingsPage.tsx`
|
||||
- 使用 `PageLayout` 组件
|
||||
- 创建表单布局
|
||||
|
||||
2. **Day 2: 表单逻辑**
|
||||
- 表单状态管理
|
||||
- 表单验证
|
||||
- API 调用
|
||||
|
||||
3. **Day 3: 功能完善**
|
||||
- 实时预览
|
||||
- 二次确认
|
||||
- 错误处理
|
||||
|
||||
**验收标准**:
|
||||
- [ ] 所有设置项可编辑
|
||||
- [ ] 表单验证正确
|
||||
- [ ] 实时预览工作
|
||||
- [ ] `npm run lint` 通过
|
||||
- [ ] `npm test` 通过
|
||||
|
||||
**UI 参考**:
|
||||
```
|
||||
┌─────────────────────────────────────────┐
|
||||
│ 系统设置 │
|
||||
├─────────────────────────────────────────┤
|
||||
│ [基本设置] [安全设置] [通知配置] [开关] │
|
||||
├─────────────────────────────────────────┤
|
||||
│ 基本设置 │
|
||||
│ ┌─────────────────────────────────┐ │
|
||||
│ │ 系统名称: [_______________] │ │
|
||||
│ │ Logo: [选择文件] │ │
|
||||
│ │ 联系方式: [_______________] │ │
|
||||
│ │ 版权信息: [_______________] │ │
|
||||
│ │ [保存] [重置] │ │
|
||||
│ └─────────────────────────────────┘ │
|
||||
└─────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2.2 P0 严重断链问题（优先级高）
|
||||
|
||||
#### TASK-3: 管理员管理页开发
|
||||
**优先级**: P0 🔴
|
||||
**问题编号**: GAP-FE-001
|
||||
**工作量**: M（3天）
|
||||
**负责人**: 前端开发
|
||||
|
||||
**现状**:
|
||||
- ❌ 管理员管理页完全缺失
|
||||
- ✅ 后端 API 已存在
|
||||
|
||||
**需求**:
|
||||
- 管理员列表（分页、筛选）
|
||||
- 创建管理员
|
||||
- 编辑管理员
|
||||
- 删除管理员
|
||||
- 权限分配
|
||||
|
||||
**实现步骤**:
|
||||
1. **Day 1: 页面结构**
|
||||
- 创建 `AdminsPage.tsx`
|
||||
- 使用 `PageLayout` + `TableCard` + `FilterCard`
|
||||
- 表格列设计
|
||||
|
||||
2. **Day 2: CRUD 操作**
|
||||
- 创建 `CreateAdminModal.tsx`
|
||||
- 创建 `EditAdminModal.tsx`
|
||||
- 删除确认
|
||||
|
||||
3. **Day 3: 权限分配**
|
||||
- 创建 `PermissionTreeSelector` 组件
|
||||
- 权限树显示和选择
|
||||
|
||||
**验收标准**:
|
||||
- [ ] 所有 CRUD 操作正常
|
||||
- [ ] 权限分配正确
|
||||
- [ ] 防止删除自己和最后一个管理员
|
||||
- [ ] `npm run lint` 通过
|
||||
|
||||
**API 对接**:
|
||||
```typescript
|
||||
// 后端 API 已存在
|
||||
GET /api/v1/admin/admins
|
||||
POST /api/v1/admin/admins
|
||||
PUT /api/v1/admin/admins/:id
|
||||
DELETE /api/v1/admin/admins/:id
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
#### TASK-4: 全局设备管理页开发
|
||||
**优先级**: P0 🔴
|
||||
**问题编号**: GAP-FE-003
|
||||
**工作量**: M（3天）
|
||||
**负责人**: 前端开发
|
||||
|
||||
**现状**:
|
||||
- ⚠️ 个人设备管理已实现（`ProfileSecurityPage`）
|
||||
- ❌ 全局设备管理页缺失
|
||||
|
||||
**需求**:
|
||||
- 所有用户设备列表（分页、筛选）
|
||||
- 设备详情
|
||||
- 删除设备
|
||||
- 取消信任设备
|
||||
- 设备统计（总设备数、受信任设备数、活跃设备数）
|
||||
|
||||
**实现步骤**:
|
||||
1. **Day 1: 页面结构**
|
||||
- 创建 `DevicesPage.tsx`
|
||||
- 使用 `PageLayout` + `TableCard` + `StatsCard`
|
||||
- 表格列设计
|
||||
|
||||
2. **Day 2: 设备操作**
|
||||
- 设备详情查看
|
||||
- 删除设备
|
||||
- 取消信任
|
||||
|
||||
3. **Day 3: 统计和筛选**
|
||||
- 设备统计卡片
|
||||
- 高级筛选（用户、设备类型、信任状态）
|
||||
|
||||
**验收标准**:
|
||||
- [ ] 所有操作正常
|
||||
- [ ] 统计数据准确
|
||||
- [ ] `npm run lint` 通过
|
||||
|
||||
**API 设计**（需后端补充）:
|
||||
```go
|
||||
// 需要后端新增
|
||||
GET /api/v1/admin/devices // 获取所有设备（管理员）
|
||||
GET /api/v1/admin/devices/:id // 获取设备详情
|
||||
DELETE /api/v1/admin/devices/:id // 删除设备
|
||||
PUT /api/v1/admin/devices/:id/trust // 信任/取消信任
|
||||
GET /api/v1/admin/devices/stats // 设备统计
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
#### TASK-5: 登录日志导出功能
|
||||
**优先级**: P0 🔴
|
||||
**问题编号**: GAP-FE-004
|
||||
**工作量**: S（1天）
|
||||
**负责人**: 前端开发
|
||||
|
||||
**现状**:
|
||||
- ✅ 登录日志页已实现（`LoginLogsPage`）
|
||||
- ❌ 导出功能缺失
|
||||
|
||||
**需求**:
|
||||
- 导出 CSV
|
||||
- 导出 Excel
|
||||
- 支持筛选结果导出
|
||||
|
||||
**实现步骤**:
|
||||
1. 使用 `xlsx` 库（前端已有）
|
||||
2. 实现 Excel 导出函数
|
||||
3. 添加导出按钮到 `LoginLogsPage`
|
||||
|
||||
**验收标准**:
|
||||
- [ ] Excel 导出成功
|
||||
- [ ] CSV 导出成功
|
||||
- [ ] 导出内容正确
|
||||
|
||||
---
|
||||
|
||||
### 2.3 P1 中等断链问题
|
||||
|
||||
#### TASK-6: 设备信任功能完善
|
||||
**优先级**: P1 🟡
|
||||
**问题编号**: GAP-INT-001
|
||||
**工作量**: M（4天）
|
||||
**负责人**: 后端 + 前端
|
||||
|
||||
**现状**:
|
||||
- ✅ 设备 CRUD API 已实现
|
||||
- ✅ 设备信任 API 已实现
|
||||
- ❌ 登录流程未检查设备信任
|
||||
- ❌ 前端未采集设备指纹
|
||||
|
||||
**后端实现**（2天）:
|
||||
1. **Day 1: 登录接收设备标识**
|
||||
- 修改 `LoginRequest` 添加设备字段
|
||||
- 登录时自动记录设备
|
||||
|
||||
2. **Day 2: 2FA 检查设备信任**
|
||||
- TOTP 验证时检查设备是否已信任
|
||||
- 信任设备免 2FA
|
||||
|
||||
**前端实现**（2天）:
|
||||
1. **Day 1: 登录时采集设备指纹**
|
||||
- 生成设备指纹（User-Agent + Screen + Timezone）
|
||||
- 登录请求携带设备信息
|
||||
|
||||
2. **Day 2: "记住此设备"功能**
|
||||
- 2FA 验证页面添加"记住此设备"复选框
|
||||
- 调用信任设备 API
|
||||
|
||||
**验收标准**:
|
||||
- [ ] 登录时设备自动记录
|
||||
- [ ] 信任设备免 2FA
|
||||
- [ ] 信任过期后重新要求 2FA
|
||||
|
||||
---
|
||||
|
||||
#### TASK-7: 批量操作功能
|
||||
**优先级**: P1 🟡
|
||||
**问题编号**: GAP-FE-005
|
||||
**工作量**: M（3天）
|
||||
**负责人**: 前端 + 后端
|
||||
|
||||
**现状**:
|
||||
- ❌ 批量操作完全缺失
|
||||
|
||||
**需求**:
|
||||
- 用户批量删除
|
||||
- 角色批量删除
|
||||
- 批量分配角色
|
||||
|
||||
**后端实现**（1天）:
|
||||
- 批量删除 API
|
||||
- 批量更新 API
|
||||
|
||||
**前端实现**（2天）:
|
||||
1. **Day 1: 批量选择 UI**
|
||||
- 表格行选择
|
||||
- 全选/取消全选
|
||||
- 批量操作按钮
|
||||
|
||||
2. **Day 2: 批量操作逻辑**
|
||||
- 批量删除
|
||||
- 批量分配角色
|
||||
|
||||
**验收标准**:
|
||||
- [ ] 批量选择正常
|
||||
- [ ] 批量删除成功
|
||||
- [ ] 批量分配角色成功
|
||||
|
||||
---
|
||||
|
||||
### 2.4 测试修复
|
||||
|
||||
#### TASK-8: 前端 Vitest 3 个失败点修复
|
||||
**优先级**: P1 🟡
|
||||
**工作量**: S（2天）
|
||||
**负责人**: 前端开发
|
||||
|
||||
**现状**:
|
||||
- ⚠️ Vitest 有 3 个失败点
|
||||
|
||||
**行动**:
|
||||
1. 运行 `npm test` 查看失败详情
|
||||
2. 逐个修复失败用例
|
||||
3. 确保所有测试通过
|
||||
|
||||
**验收标准**:
|
||||
- [ ] 所有 Vitest 测试通过
|
||||
- [ ] 测试覆盖率 ≥ 70%
|
||||
|
||||
---
|
||||
|
||||
## 三、依赖关系
|
||||
|
||||
```
|
||||
TASK-1 (系统设置 API) ────── TASK-2 (系统设置页)
|
||||
│
|
||||
TASK-3 (管理员管理页) ────── 独立
|
||||
│
|
||||
TASK-4 (设备管理页) ──────── TASK-6 (设备信任)
|
||||
│ │
|
||||
TASK-5 (登录日志导出) ──────────┘
|
||||
│
|
||||
TASK-7 (批量操作) ─────────── 独立
|
||||
│
|
||||
TASK-8 (Vitest 修复) ──────── 独立
|
||||
```
|
||||
|
||||
**关键路径**:
|
||||
1. TASK-1 必须先于 TASK-2
|
||||
2. TASK-6 依赖 TASK-4 的设备管理 API
|
||||
|
||||
---
|
||||
|
||||
## 四、风险管理
|
||||
|
||||
### 4.1 技术风险
|
||||
|
||||
| 风险 | 影响 | 概率 | 缓解措施 |
|
||||
|------|------|------|---------|
|
||||
| 系统设置 API 设计复杂 | 高 | 中 | 参考 Spring Boot Configuration 做法 |
|
||||
| 设备指纹算法不稳定 | 高 | 中 | 使用成熟的指纹库（如 FingerprintJS） |
|
||||
| 批量操作性能问题 | 中 | 中 | 使用异步处理和进度反馈 |
|
||||
|
||||
### 4.2 进度风险
|
||||
|
||||
| 风险 | 影响 | 概率 | 缓解措施 |
|
||||
|------|------|------|---------|
|
||||
| 后端 API 开发延期 | 高 | 中 | 优先完成核心 API，细节后续迭代 |
|
||||
| 前端 UI 开发延期 | 中 | 低 | 使用 Ant Design 组件加速 |
|
||||
|
||||
---
|
||||
|
||||
## 五、资源分配
|
||||
|
||||
### 5.1 人员分配
|
||||
|
||||
| 任务 | 后端 | 前端 | 测试 |
|
||||
|------|------|------|------|
|
||||
| TASK-1: 系统设置 API | 1人 | - | - |
|
||||
| TASK-2: 系统设置页 | - | 1人 | - |
|
||||
| TASK-3: 管理员管理页 | - | 1人 | - |
|
||||
| TASK-4: 设备管理页 | 0.5人 | 1人 | - |
|
||||
| TASK-5: 登录日志导出 | - | 0.5人 | - |
|
||||
| TASK-6: 设备信任完善 | 1人 | 1人 | - |
|
||||
| TASK-7: 批量操作 | 0.5人 | 1人 | - |
|
||||
| TASK-8: Vitest 修复 | - | 0.5人 | - |
|
||||
|
||||
### 5.2 工作量汇总
|
||||
|
||||
- **后端**: 4 人天
|
||||
- **前端**: 7 人天
|
||||
- **总计**: 11 人天
|
||||
|
||||
---
|
||||
|
||||
## 六、验收标准
|
||||
|
||||
### 6.1 功能验收
|
||||
|
||||
**系统设置**:
|
||||
- [ ] 所有配置项可 CRUD
|
||||
- [ ] 配置变更生效
|
||||
- [ ] 敏感配置加密
|
||||
|
||||
**管理员管理**:
|
||||
- [ ] CRUD 操作正常
|
||||
- [ ] 权限分配正确
|
||||
- [ ] 防止删除自己
|
||||
|
||||
**设备管理**:
|
||||
- [ ] 设备列表正常
|
||||
- [ ] 设备操作正常
|
||||
- [ ] 统计数据准确
|
||||
|
||||
**设备信任**:
|
||||
- [ ] 设备自动记录
|
||||
- [ ] 信任设备免 2FA
|
||||
|
||||
**批量操作**:
|
||||
- [ ] 批量选择正常
|
||||
- [ ] 批量操作成功
|
||||
|
||||
### 6.2 质量验收
|
||||
|
||||
- [ ] `go test ./...` 通过
|
||||
- [ ] `go vet ./...` 通过
|
||||
- [ ] `go build ./cmd/server` 成功
|
||||
- [ ] `npm run lint` 通过
|
||||
- [ ] `npm test` 全部通过
|
||||
- [ ] `npm run build` 成功
|
||||
- [ ] `npm run e2e:full:win` 通过
|
||||
|
||||
### 6.3 文档验收
|
||||
|
||||
- [ ] API 文档更新
|
||||
- [ ] README 更新
|
||||
- [ ] 部署文档更新
|
||||
|
||||
---
|
||||
|
||||
## 七、Sprint 检查点
|
||||
|
||||
### Sprint 开启（Day 1）
|
||||
- [ ] Sprint 计划评审
|
||||
- [ ] 任务分配
|
||||
- [ ] 开发环境准备
|
||||
|
||||
### Sprint 中期（Day 5）
|
||||
- [ ] 进度检查
|
||||
- [ ] 问题识别
|
||||
- [ ] 风险评估
|
||||
|
||||
### Sprint 结束（Day 7）
|
||||
- [ ] 功能验收
|
||||
- [ ] 质量验收
|
||||
- [ ] Sprint 回顾
|
||||
- [ ] 下一 Sprint 准备
|
||||
|
||||
---
|
||||
|
||||
## 八、Sprint 13 交付物
|
||||
|
||||
1. **系统设置功能**
|
||||
- 后端 API
|
||||
- 前端页面
|
||||
- API 文档
|
||||
|
||||
2. **管理员管理页**
|
||||
- 前端页面
|
||||
- 功能文档
|
||||
|
||||
3. **设备管理页**
|
||||
- 后端 API
|
||||
- 前端页面
|
||||
- API 文档
|
||||
|
||||
4. **设备信任完善**
|
||||
- 后端实现
|
||||
- 前端实现
|
||||
- 测试用例
|
||||
|
||||
5. **批量操作功能**
|
||||
- 后端 API
|
||||
- 前端功能
|
||||
|
||||
6. **测试修复**
|
||||
- Vitest 全部通过
|
||||
- 测试报告
|
||||
|
||||
---
|
||||
|
||||
**计划制定时间**: 2026-04-02
|
||||
**计划制定人**: 高级项目经理
|
||||
**审核状态**: 待审核
|
||||
Reference in New Issue
Block a user