Phase 1 剩余任务 — 2天技术任务分解

文档版本: v1.0
生成日期: 2026-07-22
基于: 统一执行计划 + 5个真正未完成项
目标: 将 Phase 1 剩余工作分解为 2 天可完成的技术任务

任务分解原则

每个任务 ≤ 2 天（16 小时）
明确输入/输出/验收标准
独立可并行（标注依赖）
包含测试验证步骤

任务清单（按优先级排序）

P0 任务（2个）

T1-1: 辈分重构 - Phase 1 基础设施（2天）

目标: 完成 GenerationLevel 枚举、实体变更、数据库列添加

输入:

现有 FamilyMember.java 实体
DatabaseInitializer.java 迁移框架

输出:

GenerationLevel.java 枚举（7级）
修改 FamilyMember.java（删除 relationshipType/roleOverride，新增 generation/isSpouse）
AddFamilyMemberDTO.java（新建）
DatabaseInitializer 迁移 1 & 2（添加列 + 旧数据填充）

验收标准:

mvn clean compile 零错误
数据库 family_members 表存在 generation、is_spouse 列
旧数据 generation 按规则映射（spouse→0, parent→1, child→-1, sibling→0）
GenerationLevel 枚举包含 7 个级别，可通过单元测试

依赖: 无

分配: 后端开发 1 人

T1-2: 富维度子维度拆分 - EnergyService 重构（2天）

目标: 重构 calcChildWealth / calcParentWealth，拆分为子维度，集成身克富杠杆

输入:

EnergyService.java v2.1（已有核心算法）
MemberEnergyDTO.java

输出:

MemberEnergyDTO 新增 8 个子维度字段 + 2 个身克富字段
EnergyService.calcChildWealth() 拆分为 3 个子方法（education/social/points）
EnergyService.calcParentWealth() 拆分为 3 个子方法（income/achievement/network）
EnergyService.applyBodyWealthRestraint() 新方法（身克富杠杆）
在 calcParentEnergy / calcChildEnergy 末尾调用身克富检测

验收标准:

单元测试覆盖所有子维度计算逻辑（≥ 80%）
身克富三种状态（normal/overdraw/penalty）可触发
集成测试验证能量概览 API 返回子维度数据
无编译错误，无 LSP 警告

依赖: T1-1（可并行，不阻塞）

分配: 后端开发 1 人

P1 任务（5个）

T1-3: 辈分重构 - Phase 2 后端逻辑重写（2天）

目标: 重写 FamilyMemberService 核心方法，删除关系类型管理

输入:

T1-1 完成的实体和 DTO
现有 FamilyMemberService.java

输出:

重写 computeEffectiveRole()（基于 generation）
重写 computeRelativeLabel()（纯 generation diff 计算）
重写 addMember()（使用 relativeMemberId + generationLevel + peerType）
修改 listMembers() 和 toFamilyMemberVO()（移除 relationshipType 相关字段）
删除管理端关系类型管理方法
修改 FamilyMembersController 请求/响应 DTO

验收标准:

单元测试覆盖 computeRelativeLabel() 所有辈分组合（≥ 90%）
API 测试：添加配偶（peer+spouse）成功，generation=0, is_spouse=1
API 测试：添加子侄辈（child）成功，generation=-1
旧代码引用搜索：grep -r "relationshipType" cfc-backend/src/main/java 返回空

依赖: T1-1

分配: 后端开发 1 人

T1-4: 辈分重构 - Phase 3 清理 + 管理端（2天）

目标: 删除废弃列和表，同步 schema.sql，更新 cfc-web 管理端

输入:

T1-3 完成的后端逻辑
cfc-backend/src/main/resources/schema.sql

输出:

DatabaseInitializer 迁移 3：删除 relationship_type、role_override 列
DatabaseInitializer 迁移 4：删除 relationship_types 表
同步 schema.sql 表结构
删除 RelationshipType.java、RelationshipTypeMapper.java、RelationshipTypeService.java（如存在）
删除 cfc-web 管理端关系类型管理页面和路由
更新 cfc-web 成员添加页面（替换为辈分选择器）

验收标准:

grep -r "relationship_type" cfc-backend/src/main/java 返回空
grep -r "RelationshipType" cfc-backend/src/main/java 返回空
schema.sql 中 family_members 表无 relationship_type/role_override 列
cfc-web 路由无 /admin/relationship-type 路径
管理端成员添加页面显示辈分选择器（GenerationPicker）

依赖: T1-3

分配: 后端开发 1 人 + Web前端 1 人

T1-5: 辈分重构 - Phase 4 小程序前端（2天）

目标: 新建 GenerationPicker 组件，更新成员添加页面

输入:

T1-4 完成的后端 API
现有 RelationshipPicker.vue（如有）

输出:

generationLevel.js 常量文件（7级辈分 + 同辈类型）
GenerationPicker.vue 组件（单选辈分 + 同辈配偶选项）
修改成员添加页面（pages/family/member-add.vue 或类似）
删除 RelationshipPicker.vue（如存在）
更新 utils/api.js 调用参数（relationshipType → generationLevel + peerType）

验收标准:

GenerationPicker 组件可正常选择辈分和配偶类型
添加成员 API 调用成功（relativeMemberId + generationLevel + peerType）
成员列表显示 generation 字段（调试模式）
小程序编译无警告，LSP 诊断零错误

依赖: T1-4（API 变更）

分配: 小程序前端 1 人

T1-6: 富维度拆分 - 前端页面重写（2天）

目标: 重写 pages/wealth/index.vue，角色感知的富展示

输入:

T1-2 完成的 GET /api/energy/wealth-detail API
现有 pages/wealth/index.vue

输出:

新页面布局：PageBanner → 身克富状态条 → 三子维度卡片 → 增值服务入口 → 底部菜单
WealthSubScores.vue 组件（成人版/孩子版）
BodyWealthAlert.vue 组件（三种状态：normal/overdraw/penalty）
utils/api.js 新增 getWealthDetail() 方法
删除原页面"行动数据"区块（任务数/购买数/活动数/课程数）

验收标准:

家长端显示 3 个子维度（金钱收入/社会成就/资源网络）
孩子端显示 3 个子维度（学业成绩/社交筹码/积分效率）
身克富预警在条件触发时显示（身<40 且富>60）
页面加载时间 ≤ 1.5s（模拟数据）
小程序编译零错误

依赖: T1-2（API 就绪）

分配: 小程序前端 1 人

T1-7: DAN测评题目录入优化（2天）

目标: 优化认知测评题目录入流程

输入:

现有 DanAssessmentController.java
设计文档 assessment-market-plan.md

输出:

确认具体优化点（批量导入？富文本编辑器？题目预览？）
实现对应功能（根据设计文档）
更新前端题目录入页面

验收标准:

题目录入效率提升 ≥ 30%（对比旧流程）
支持批量导入（如需要）
题目预览功能正常
后端 API 响应时间 ≤ 500ms

依赖: 无

分配: 后端 1 人 + 前端 1 人

T1-8: 维度页面缺口修复 Phase 2（2天）

目标: 补全五维页面的缺失功能（珍珠图/圈子系统 Phase 1）

输入:

plans/2026-07-12-dimension-pages-gap-fix.md
五维 TabBar 页面（已完成）

输出:

P1-1 身页: HealthCheckinCard.vue 组件 + 插入到 pages/body/index.vue
P1-2 智页: 阅读时长展示卡片 + API 对接（确认或新增 POST /api/article/reading-stats）
P1-3 心页: 天盘相性卡片 + API 对接（POST /api/tianpan/compatibility）

验收标准:

身页健康打卡卡片显示今日状态 + 连续天数
智页显示"本月阅读 X 小时"
心页显示家庭天盘相性评分
三个卡片均可点击跳转详情页
无登录态不显示（或显示占位符）

依赖: 五维 TabBar 完成（已完成）

分配: 小程序前端 1-2 人

T1-9: CFC原生电商扩展 - 数据库迁移（2天）

目标: 创建 shop_ 前缀表，完成 DatabaseInitializer 迁移

输入:

specs/2026-06-24-cfc-ecommerce-extension-design.md
DatabaseInitializer.java

输出:

确认 shop_ 表完整 DDL（至少：shop_products, shop_orders, shop_categories）
DatabaseInitializer 新增建表迁移
同步 schema.sql
创建对应 Entity 类（ShopProduct.java, ShopOrder.java 等）

验收标准:

SHOW TABLES LIKE 'shop_%' 返回预期表数量（≥ 3）
schema.sql 包含 shop_ 表定义
Entity 类字段与 DDL 完全一致
mvn clean compile 零错误

依赖: 无

分配: 后端开发 1 人

T1-10: CFC原生电商扩展 - Service + Controller（2天）

目标: 实现电商 CRUD 逻辑，适配 ProductController

输入:

T1-9 完成的 Entity 和 Mapper
现有 ProductController.java（161行）

输出:

ShopProductMapper.java + ShopProductService.java + ShopProductController.java
或扩展现有 ProductController 支持 shop_ 表
实现商品列表/详情/下单/订单查询基础 API
更新 utils/api.js 新增电商相关方法

验收标准:

商品列表 API 返回正确数据（mock 数据可查询）
商品详情 API 可查询单个商品
下单 API 创建订单成功（订单状态 pending）
前端小程序商城页面可浏览商品

依赖: T1-9

分配: 后端开发 1 人 + 小程序前端 1 人

技术债务任务（3个）

T5-1: 确定性缺口修复（2天）

目标: 修复系统确定性缺口（具体内容见 plans/2026-07-10-determinism-gap-fix-plan.md）

输入:

确定性缺口计划文档
现有代码中随机数/时间戳依赖

输出:

识别所有 Math.random()、new Date()、UUID.randomUUID() 等非确定性调用
替换为可 seed 的伪随机生成器或固定时间戳（测试环境）
添加 DeterministicTest 基类，确保测试可重复

验收标准:

所有单元测试运行两次结果一致
集成测试无 flaky 失败（连续运行 5 次 100% 通过）
代码审查：无新增非确定性代码

依赖: 无

分配: 后端开发 1 人

T5-2: Web端E2E测试修复（2天）

目标: 修复 14 个 E2E 测试失败用例

输入:

plans/2026-06-20-cfc-web-e2e-test-fix.md
Web 端 E2E 测试报告

输出:

逐项修复失败测试（选择器过时、异步等待、数据依赖）
更新测试数据 fixture
增加测试稳定性（retry 机制、等待策略）

验收标准:

E2E 测试通过率从当前提升至 ≥ 90%
连续运行 3 次无 flaky 失败
测试执行时间 ≤ 10 分钟

依赖: 无

分配: Web前端 1 人

T5-3: 综合差异修复（2天）

目标: 系统性扫描和修复代码与设计差异

输入:

所有 specs/ 设计文档
现有代码库

输出:

使用 ast-grep 扫描设计规范违反（如可选链、CSS Grid、GetMapping 等）
批量修复 AI slop 模式
更新文档与代码同步

验收标准:

扫描报告：0 个严重违反项
所有页面符合设计 Token 体系
代码审查：无设计文档已定义但未实现的功能

依赖: 无

分配: 全栈开发 1 人

任务分配汇总（Sprint 1）

开发者	任务数	总工作量	并行任务
Dev A（BE）	T1-1, T1-3, T1-4, T1-9	4 个	3 个并行（T1-1/T1-3/T1-9）
Dev B（FE-mini）	T1-5, T1-6, T1-8, T1-10	4 个	3 个并行（T1-5/T1-6/T1-8）
Dev C（BE）	T1-2, T1-7	2 个	1 个并行（T1-2）
Dev D（Web）	T1-4 (Web部分), T5-2	2 个	1 个并行（T5-2）
Dev E（BE）	T5-1, T5-3	2 个	1 个并行（T5-1）

总工作量: 13 个任务 × 2 天 = 26 人天
并行度: 4-5 人同时工作
预计完成时间: 2 周（考虑 50% 并行效率）

关键路径

T1-1 (2d) → T1-3 (2d) → T1-4 (2d) → T1-5 (2d)
              ↓
           T1-2 (2d) → T1-6 (2d)
              ↓
           T1-7 (2d)
              ↓
           T1-8 (2d)
              ↓
           T1-9 (2d) → T1-10 (2d)

关键路径长度: 10 天（不含技术债务）

风险与缓解

风险	影响	缓解
T1-1 数据库迁移失败	阻塞 T1-3/T1-4	预生产环境先演练，备份数据
T1-2 身克富算法争议	阻塞 T1-6	产品经理确认算法细节，提供 mock 数据
T1-9 shop_ 表设计与 danshop 冲突	阻塞 T1-10	与 danshop 团队确认表结构兼容性
T1-7 DAN 优化范围不明确	阻塞任务	启动前召开需求澄清会（≤ 1 小时）

验证清单

每日验证

代码提交前运行 mvn clean compile（后端）或 npm run build（前端）
单元测试通过率 100%
LSP 诊断零错误

Sprint 结束验证

所有任务标记为 completed
集成测试通过率 ≥ 95%
无阻塞性 Bug（Blocker/Critical）
文档更新（PLAN 文件 + PROJECT-OVERVIEW.md）

文档结束

phase1-remaining.md 13 KB Permalink Geschiedenis Ruwe

Phase 1 剩余任务 — 2天技术任务分解

任务分解原则

任务清单（按优先级排序）

P0 任务（2个）

T1-1: 辈分重构 - Phase 1 基础设施（2天）

T1-2: 富维度子维度拆分 - EnergyService 重构（2天）

P1 任务（5个）

T1-3: 辈分重构 - Phase 2 后端逻辑重写（2天）

T1-4: 辈分重构 - Phase 3 清理 + 管理端（2天）

T1-5: 辈分重构 - Phase 4 小程序前端（2天）

T1-6: 富维度拆分 - 前端页面重写（2天）

T1-7: DAN测评题目录入优化（2天）

T1-8: 维度页面缺口修复 Phase 2（2天）

T1-9: CFC原生电商扩展 - 数据库迁移（2天）

T1-10: CFC原生电商扩展 - Service + Controller（2天）

技术债务任务（3个）

T5-1: 确定性缺口修复（2天）

T5-2: Web端E2E测试修复（2天）

T5-3: 综合差异修复（2天）

任务分配汇总（Sprint 1）

关键路径

风险与缓解

验证清单

每日验证

Sprint 结束验证

phase1-remaining.md 13 KB

Permalink Geschiedenis Ruwe