peixue-dev/Archive/peidu-temp-files/docs/🚀家长端功能完善-第二阶段计划-2026-01-23.md

🚀 家长端功能完善 - 第二阶段计划

制定时间: 2026-01-23
基于: 📊家长端未关联功能最终检查报告

---

📊 当前进度

✅ 第一阶段已完成 (2026-01-23)

1. ✅ 消息中心页面 - 查看通知、未读数量、标记已读
2. ✅ 陪伴员详情页面 - 查看陪伴员信息、评价、统计
3. ✅ 次卡支付显示修复 - 修复次卡在支付页面不显示的问题

---

🎯 第二阶段目标

完成支付流程的完整闭环，实现所有支付方式的集成。

---

📋 实施计划

阶段 2A: 支付方式完整集成 🔴 高优先级

任务 1: 套餐支付集成 ⏳

预计时间: 30分钟

前端工作:

• ✅ 支付页面已有套餐选择UI
• ⏳ 需要验证套餐数据加载逻辑
• ⏳ 需要验证套餐扣减逻辑

后端工作:

• ✅ PackageController 已存在
• ✅ PackageUsageController 已存在
• ⏳ 需要验证支付接口中的套餐处理逻辑

测试要点:

1. 套餐列表正确显示
2. 套餐余额正确显示
3. 选择套餐后正确扣减
4. 套餐使用记录正确生成

---

任务 2: 优惠券支付集成 ⏳

预计时间: 30分钟

前端工作:

• ✅ 支付页面已有优惠券选择UI
• ⏳ 需要验证优惠券数据加载逻辑
• ⏳ 需要验证优惠券使用逻辑

后端工作:

• ✅ CouponController 已存在
• ✅ UserCouponController 已存在
• ⏳ 需要验证支付接口中的优惠券处理逻辑

测试要点:

1. 优惠券列表正确显示
2. 优惠券条件正确判断（满减金额）
3. 选择优惠券后金额正确计算
4. 优惠券使用后状态正确更新

---

任务 3: 钱包支付集成 ⏳

预计时间: 30分钟

前端工作:

• ✅ 支付页面已有钱包支付UI
• ✅ 钱包余额已正确显示
• ⏳ 需要验证钱包支付逻辑

后端工作:

• ✅ WalletController 已存在
• ✅ WalletService 已实现
• ⏳ 需要验证支付接口中的钱包处理逻辑

测试要点:

1. 钱包余额正确显示
2. 余额不足时正确提示
3. 钱包支付后余额正确扣减
4. 钱包交易记录正确生成

---

任务 4: 次卡支付集成测试 ⏳

预计时间: 20分钟

工作内容:

• ✅ 次卡显示问题已修复
• ⏳ 需要测试次卡支付完整流程
• ⏳ 需要验证次卡扣减逻辑
• ⏳ 需要验证次卡使用记录生成

测试要点:

1. 次卡列表正确显示
2. 次卡余额正确显示
3. 选择次卡后正确扣减
4. 次卡使用记录正确生成

---

阶段 2B: 地址管理集成 🔴 高优先级

任务 5: 订单地址关联 ⏳

预计时间: 40分钟

前端工作:

• ⏳ 下单页面添加地址选择
• ⏳ 地址列表页面对接
• ⏳ 地址编辑页面对接

后端工作:

• ✅ UserAddressController 已存在
• ⏳ 订单表需要添加地址字段
• ⏳ 订单详情需要返回地址信息

数据库修改:

ALTER TABLE `order` ADD COLUMN `address_id` BIGINT COMMENT '服务地址ID';
ALTER TABLE `order` ADD COLUMN `address_detail` VARCHAR(500) COMMENT '详细地址';
ALTER TABLE `order` ADD COLUMN `contact_name` VARCHAR(50) COMMENT '联系人';
ALTER TABLE `order` ADD COLUMN `contact_phone` VARCHAR(20) COMMENT '联系电话';

---

阶段 2C: 通知提醒完善 🟡 中优先级

任务 6: 过期提醒 ⏳

预计时间: 30分钟

需要添加的提醒:

1. 次卡即将过期提醒（提前7天、3天、1天）
2. 套餐即将过期提醒（提前7天、3天、1天）
3. 优惠券即将过期提醒（提前3天、1天）
4. 次卡用完提醒
5. 套餐用完提醒

实现方式:

• 后端定时任务扫描
• 生成通知记录
• 前端消息中心显示

---

任务 7: 订单状态通知 ⏳

预计时间: 20分钟

需要添加的通知:

1. 订单派单成功通知
2. 陪伴员接单通知
3. 陪伴员签到通知
4. 服务完成通知
5. 评价提醒通知

实现方式:

• 订单状态变更时触发
• 生成通知记录
• 前端消息中心显示

---

🧪 测试计划

支付流程完整测试

1. 微信支付测试

   • 创建订单 → 选择微信支付 → 支付成功 → 订单状态更新

2. 钱包支付测试

   • 创建订单 → 选择钱包支付 → 余额充足 → 支付成功 → 余额扣减

3. 次卡支付测试

   • 创建订单 → 选择次卡支付 → 次卡余额充足 → 支付成功 → 次卡扣减

4. 套餐支付测试

   • 创建订单 → 选择套餐支付 → 套餐余额充足 → 支付成功 → 套餐扣减

5. 优惠券使用测试

   • 创建订单 → 选择优惠券 → 满足条件 → 金额减免 → 优惠券使用

6. 组合支付测试

   • 创建订单 → 选择优惠券 → 选择钱包支付 → 金额正确计算 → 支付成功

---

📊 优先级说明

🔴 高优先级 (立即实施)

• 支付方式完整集成（次卡、套餐、优惠券、钱包）
• 地址管理集成
• 影响核心业务流程

🟡 中优先级 (本周完成)

• 通知提醒完善
• 日历功能关联
• 服务反馈流转
• 影响用户体验

🟢 低优先级 (后续优化)

• 积分系统完善
• 拼团功能完善
• 管理师申请流程
• 不影响核心功能

---

🎯 成功标准

第二阶段完成标准

1. ✅ 所有支付方式都能正常使用
2. ✅ 支付后相关资源正确扣减
3. ✅ 支付记录完整准确
4. ✅ 订单地址正确关联
5. ✅ 陪伴员能看到服务地址
6. ✅ 关键操作都有通知提醒

质量标准

1. ✅ 无编译错误
2. ✅ 无运行时错误
3. ✅ 数据一致性正确
4. ✅ 用户体验流畅
5. ✅ 边界情况处理完善

---

📝 实施记录

2026-01-23

• ✅ 完成消息中心页面
• ✅ 完成陪伴员详情页面
• ✅ 修复次卡支付显示问题
• ⏳ 准备开始第二阶段实施

---

🚀 下一步行动

1. 立即开始: 验证套餐支付逻辑
2. 然后: 验证优惠券支付逻辑
3. 接着: 验证钱包支付逻辑
4. 最后: 完整测试所有支付方式

预计完成时间: 2-3小时