之舞 - softflow 瑜伽小程序

项目概述

产品名称

之舞 - softflow

产品定位

轻量级互动瑜伽小程序，通过签到、成就、排行榜和1v1对战功能，提升用户坚持练习的动力和趣味性。

目标用户

瑜伽初学者到中级练习者，希望养成每日练习习惯的人，喜欢社交互动、追求成就感的用户。

核心价值

持续互动：签到和成就系统
社交激励：排行榜和1v1对战
简单易用：低开发难度，体验流畅

核心功能

每日签到

每天签到一次，连续签到获得额外奖励

成就系统

完成特定动作可解锁成就（徽章+称号+进度条）

排行榜

按签到天数、对战胜场、成就数量排序

1v1对战PK

两人同时开始练习，比较练习时长和体式完成数量

代码覆盖

前端页面覆盖

首页	100%
签到页面	100%
成就页面	100%
排行榜页面	100%
个人中心	100%
对战页面	100%

后端云函数覆盖

user	100%
sign	100%
achievement	100%
leaderboard	100%
battle	100%

云函数说明

user - 用户管理

管理用户基本信息和排名

// 功能
getProfile - 获取用户资料
updateProfile - 更新用户资料（带乐观锁）
getRank - 获取用户排行榜

sign - 签到管理

处理签到逻辑，保证数据一致性

// 核心特性
• 事务保证原子性
• 乐观锁防止并发修改
• 重复签到拦截
• 连续签到自动计算

reconciliation - 对账

每日自动检查数据一致性

// 对账内容
• 签到对账（检查重复签到）
• 积分对账（检查异常积分）
• 成就对账（检查异常记录）
• 生成对账报告

backup - 备份

定期备份数据，防止数据丢失

// 备份类型
• 全量备份（用户、签到、成就）
• 增量备份（仅签到记录）
• 备份历史管理（30天）
• 数据恢复功能

重构功能

API层增强

统一日志系统（INFO/WARN/ERROR）
云函数调用超时控制（3秒）
自动重试机制（最多3次）
统一错误处理和记录

安全机制

乐观锁防止并发修改
事务保证原子性
重复签到拦截
时间限制检查

可观测性

所有操作都有日志记录
每日自动对账
异常检测和告警
对账报告生成

灾备方案

全量备份（每天）
增量备份（每天）
保留30次备份记录
支持快速恢复

部署状态

代码开发完成

所有代码已按照PRD要求完成重构

待部署项

上传云函数待部署

4个云函数需上传

设置定时任务待配置

reconciliation每天2点，backup每天3点

初始化数据库待配置

3个新集合需创建

数据库结构

signin_records

签到记录集合

                                    {

                                      openid: String,

                                      date: Date,

                                      streak: Number,

                                      reward: Number,

                                      created_at: Date

                                    }

reconciliation_reports

对账报告集合

                                    {

                                      date: Date,

                                      summary: {...},

                                      issues: Array,

                                      details: {...}

                                    }

backup_records

备份记录集合

                                    {

                                      backupId: String,

                                      backupType: String,

                                      data: {...},

                                      stats: {...}

                                    }

部署步骤

1. 上传云函数

                                        cd cloudfunctions/user &&

                                        wx-server-sdk deploy

                                        cd ../sign &&

                                        wx-server-sdk deploy

                                        cd ../reconciliation &&

                                        wx-server-sdk deploy

                                        cd ../backup &&

                                        wx-server-sdk deploy

2. 设置定时触发器

                                        函数：reconciliation

                                        Cron：0 0 2 * * * *

                                        函数：backup

                                        Cron：0 0 3 * * * *

3. 初始化数据库

                                        创建集合：

                                        • signin_records

                                        • reconciliation_reports

                                        • backup_records

监控指标

API成功率

API响应时间

>99.5%

API成功率

<500ms

P95响应时间

PRD覆盖率

100% 覆盖

异常&边界

✅ 超时处理
✅ 重复处理
✅ 并发控制
✅ 对账机制
✅ 灾备方案

验收标准

✅ 用例验收
✅ 指标监控
✅ 日志规范
✅ 追踪方案
✅ 灰度/回滚