首次提交

docs/寸进_InchStep_详细需求说明书.md

@@ -0,0 +1,713 @@
+# 寸进（InchStep）综合成长打卡平台 — 详细需求说明书
+
+> 文档版本：v1.0  
+> 更新日期：2026-06-17  
+> 状态：初稿
+
+---
+
+## 目录
+
+1. 文档概述
+2. 产品背景与定位
+3. 目标用户画像
+4. 产品全局说明
+5. 功能需求详述
+6. 非功能需求
+7. 数据模型概要
+8. 优先级矩阵
+9. 验收标准
+10. 商业模式与盈利点
+10. 附录
+
+---
+
+## 1. 文档概述
+
+### 1.1 文档目的
+本文档旨在将《寸进（InchStep）综合成长打卡平台 简易需求文档》中的要点展开为一份结构化的详细需求说明，作为后续设计、开发、测试的统一参考。
+
+### 1.2 适用范围
+本文档覆盖寸进平台 v1.0 版本的全部功能范围，不含企业考勤、公司签到、员工管理、薪资绩效打卡相关功能。
+
+### 1.3 关键词定义
+
+| 术语 | 说明 |
+|------|------|
+| 打卡项 | 用户创建的单个打卡项目，如"每天背单词""每晚冥想" |
+| 打卡记录 | 用户在某个打卡项下某日的一次完成记录 |
+| 成长积分 | 平台通用积分，用于激励用户持续打卡 |
+| 成就徽章 | 满足特定条件后解锁的虚拟徽章 |
+| 打卡小组 | 用户自行创建或加入的多人打卡团体 |
+| 动态广场 | 用户分享打卡成果的社交 Feed 流 |
+
+---
+
+## 2. 产品背景与定位
+
+### 2.1 背景
+在自我提升与习惯养成领域，现有工具普遍存在几个痛点：
+- **功能割裂**：阅读打卡用一个 App，健身打卡用另一个，数据无法互通；
+- **缺乏社交激励**：单机打卡容易放弃，缺少同伴监督和竞争氛围；
+- **成长不可见**：很多工具只记录"打了没打"，缺少有温度的可视化反馈和阶段性总结；
+- **仪式感不足**：用户需要"被看见"和"被认可"，但现有产品在个人主页展示、成就系统上较弱。
+
+### 2.2 产品定位
+**寸进（InchStep）** 是一款面向个人的全场景成长打卡平台，覆盖学习、健康、习惯、兴趣、目标五大领域，融合数据可视化与社交比拼机制，帮助用户发现并量化自己的点滴进步。
+
+### 2.3 产品 slogan
+- 中文：**寸进，日日皆有成长**
+- 英文：**InchStep, Every inch counts.**
+
+### 2.4 差异化要点
+- 全品类覆盖，一个 App 管理所有成长打卡
+- 强社交比拼：好友 PK、小组竞赛、排行榜
+- 可视化成长闭环：数据图表 + 月度回顾报告
+- 存在感设计：个人主页、动态广场、成就徽章
+
+---
+
+## 3. 目标用户画像
+
+### 3.1 核心用户：自我提升爱好者（小 A）
+- **年龄**：18–35 岁
+- **特征**：有明确的自律或成长目标，尝试过多种打卡工具，需要一个统一阵地
+- **痛点**：用多个工具切换麻烦，缺少外部监督容易放弃
+- **使用场景**：每天早起/睡前花 5 分钟完成打卡，周末查看数据趋势
+
+### 3.2 次级用户：社交驱动型用户（小 B）
+- **特征**：喜欢和朋友较量，看到排行榜会更有动力
+- **痛点**：纯单机工具坚持不下来，想要竞争和观众
+- **使用场景**：创建小组拉朋友进来打卡，关注周榜排名
+
+### 3.3 边缘用户：轻度记录者（小 C）
+- **特征**：偶尔记录生活点滴，没有严格的坚持目标
+- **痛点**：不想被推送压力，需求简单
+- **使用场景**：偶尔点进来记录一次，发条动态
+
+---
+
+## 4. 产品全局说明
+
+### 4.1 平台
+- **前端三端同步**：Web 端（PC/移动端自适应）、移动端 App（iOS / Android）、微信小程序，三端功能对齐、同步上线
+- **技术选型建议**：
+  - Web 端：React / Next.js，响应式布局适配 PC 和移动浏览器
+  - 移动端 App：React Native（与 Web 端共享业务逻辑层）
+  - 微信小程序：原生小程序开发，或 Taro / uni-app 跨端编译
+- **后端管理系统**：独立 Web 管理后台，供运营和管理员使用，与用户前端分离部署
+### 4.2 设计风格
+
+整体设计语言借鉴 Apple 人机交互指南（HIG），追求**简约、通透、有质感**的视觉体验。
+
+#### 4.2.1 设计哲学
+- **内容优先**：减少装饰性元素，让打卡数据和用户内容成为页面主角
+- **留白呼吸**：使用充足的空间间距替代分割线来区分内容区块
+- **层级清晰**：通过字体大小、粗细、颜色深浅建立清晰的视觉层级，而非靠边框和底色堆砌
+- **一致性**：全局统一的圆角半径、间距系统、图标风格和交互范式
+- **年轻活力**：色彩明快有活力，融入微渐变和微动效，不沉闷不寡淡，贴合18-35岁用户的审美偏好
+
+#### 4.2.2 色彩系统
+
+| 角色 | 色值 | 用途 |
+|------|------|------|
+| 品牌主色 | #FF6B35（活力橙） | 核心操作按钮、选中态、品牌标识 |
+| 品牌渐变 | #FF6B35 -> #FF4D6D（橙粉渐变） | 品牌背景、引导页、成就特效 |
+| 品牌辅色 | #7209B7（亮紫） | 次要强调、徽章稀有度标识、数据图表点缀 |
+| 背景色 | #F5F5F7（浅灰） | 页面背景，类似iOS设置页质感 |
+| 卡片色 | #FFFFFF | 卡片、表单、弹窗背景 |
+| 主文字 | #1D1D1F | 标题、正文关键信息 |
+| 次要文字 | #86868B | 辅助说明、时间戳、占位符 |
+| 分割线 | #E5E5EA | 极细分割线，1px或0.5pt |
+| 成功 | #34C759（iOS绿） | 打卡完成、成就达成 |
+| 警示 | #FF9500（iOS橙） | 断签提醒、待打卡 |
+| 错误 | #FF3B30（iOS红） | 删除、错误提示 |
+| 图表色板 | #FF6B35 #4CC9F0 #7209B7 #06D6A0 #F72585 | 数据可视化图表配色，明快可区分 |
+
+> 年轻化不等于花哨。品牌主色+品牌渐变+亮紫点缀+图表色板，四层体系足够丰富但不杂乱。
+
+#### 4.2.3 字体排版
+- **中文字体**：PingFang SC（苹方），系统原生字体，无须额外加载
+- **西文字体**：SF Pro，Apple系统字体，与iOS系统文字一致
+- **字号层级**：
+  - 大标题：34pt / Bold
+  - 页面标题：28pt / Semibold
+  - 卡片标题：17pt / Semibold
+  - 正文：15pt / Regular
+  - 辅助文字：13pt / Regular
+  - 角标/标签：11pt / Medium
+- **行高**：正文行高1.4倍，标题行高1.2倍
+
+#### 4.2.4 间距与栅格
+- **基准间距**：8pt，所有间距以此倍数递增（8、16、24、32、40、64）
+- **安全边距**：左右各16pt（iOS标准），顶部44pt（避开状态栏）
+- **卡片圆角**：12pt（统一圆角，与iOS系统卡片保持一致）
+- **图标尺寸**：24pt x 24pt（导航栏）、28pt x 28pt（打卡项图标）
+- **按钮高度**：48pt（主要CTA按钮），38pt（次要按钮）
+
+#### 4.2.5 图标与动效
+- **图标风格**：SF Symbols风格线性图标，2pt描边，圆角端点；辅以少量面性图标用于高亮态
+- **动效原则**：
+  - 打卡成功：微缩放+淡入+品牌色绽放粒子动效（0.4s spring），伴随Haptic Feedback
+  - 页面切换：iOS原生导航推入动画（左侧滑入）
+  - 弹窗出现：从底部上滑（Action Sheet风格）或居中淡入（Alert风格）
+  - 数据图表：加载时序列动画，数据点逐一出现（0.3s stagger）
+  - 排行榜：用户排名变化时数字滚动动画
+  - 成就解锁：全屏庆祝动效（Lightshow风格），配合触感反馈
+- **禁用动效**：尊重系统减少动态效果无障碍设置
+
+#### 4.2.6 组件视觉规范
+| 组件 | 外观说明 |
+|------|----------|
+| 导航栏 | 半透明毛玻璃效果（Blur），标题居左或居中，与iOS系统导航栏一致 |
+| 选项卡 | 底部Tab Bar，SF Symbols图标+文字，选中态品牌色渐变填充 |
+| 打卡按钮 | 圆形按钮，直径48pt，品牌渐变填充，打卡后变为勾选态，带微动效 |
+| 日历视图 | 圆角网格，打卡日显示品牌色圆点，连续打卡显示火焰图标，补卡日特殊标记 |
+| 卡片 | 白色背景、12pt圆角、极轻微阴影 |
+| 列表 | 圆角分组列表（Inset Grouped样式），与iOS设置页风格一致 |
+| 排行列表 | 前三名以金银铜色突出显示，数据条带品牌渐变进度条 |
+| 成就徽章 | 稀有度视觉：铜#CD7F32/银#C0C0C0/金#FFD700，金质徽章带流光动效 |
+
+#### 4.2.7 深色模式（Dark Mode）
+- 跟随系统设置自动切换，也支持App内手动切换
+- 深色配色方案：
+  - 背景色：#000000（纯黑）或#1C1C1E（iOS系统灰）
+  - 卡片色：#2C2C2E
+  - 主文字：#FFFFFF
+  - 次要文字：#8E8E93
+  - 分割线：#38383A
+- 品牌色和品牌渐变在深色模式下饱和度适当降低，避免刺眼
+- 深色模式下毛玻璃效果透明度调整，确保文字可读性
+
+#### 4.2.8 设计参考
+- **直接参考**：iOS系统自带App（健康、健身、日历）、Apple设计模板
+- **年轻化参考**：Notion、GoodNotes、Lose It、Strava——简约但色彩有记忆点
+- **风格对标**：简约、不堆叠、不花哨，一屏只做好一件事，但色彩敢于表达
+- **不采纳风格**：拟物化、大面积渐变盖满全屏、卡片套卡片、暗黑背景加高饱和渐变
+### 4.3 语言
+- 中文简体（首发），后续支持繁体中文和英文
+
+---
+
+## 5. 功能需求详述
+
+### 5.1 用户模块
+
+#### 5.1.1 注册与登录
+- **手机号注册**：短信验证码登录/注册
+- **第三方登录**：微信、Apple ID
+- **自动登录**：Token 持久化，7 天内免密
+- **注销账号**：提供账户注销入口，含确认流程
+
+#### 5.1.2 个人主页
+| 功能 | 说明 |
+|------|------|
+| 头像 | 支持自定义上传或默认头像 |
+| 个性签名 | 最多 50 字 |
+| 个人目标简介 | 一句话介绍正在坚持的事，最多 100 字 |
+| 展示数据 | 累计打卡天数、连续打卡天数、获得徽章数、总积分 |
+| 隐私开关 | 可控制主页是否对非好友可见 |
+
+#### 5.1.3 成长档案
+- **累计打卡记录**：按时间线展示所有打卡项的历史记录
+- **连续天数**：各打卡项各自的连续天数，以及全局最高连续天数
+- **成就徽章墙**：已获得的徽章以网格展示，未获得的显示为锁定占位
+
+---
+
+### 5.2 打卡核心模块
+
+#### 5.2.1 打卡项管理
+
+**创建打卡项**
+| 字段 | 说明 | 必填 |
+|------|------|------|
+| 名称 | 打卡项名称，如"每天背单词" | 是 |
+| 图标 | 从系统图标库选择，或自定义 emoji | 是 |
+| 分类 | 学习/健康/习惯/兴趣/目标 | 是 |
+| 每日目标 | 文字描述，如"背 50 个单词" | 否 |
+| 提醒时间 | 每日定时推送，支持多时段 | 否 |
+| 打卡周期 | 每日/每周（可指定周几）/隔日/自定义间隔 | 是 |
+| 隐私设置 | 公开/仅好友可见/仅自己可见 | 是 |
+| 目标期限 | 选填，如"2026-09-01 前通过考试" | 否 |
+
+**打卡项操作**：编辑、暂停（冻结）、归档、删除（软删除，保留历史数据）
+
+#### 5.2.2 每日打卡
+
+**一键打卡流程**
+1. 首页展示今日待打卡项列表
+2. 点击打卡项旁的打卡按钮 → 完成打卡
+3. 打卡成功后：
+   - 按钮状态变为"已打卡"，显示打卡时间
+   - 弹出轻提示，可选添加文字/图片/视频备注
+   - 获得成长积分 +1
+4. 支持批量打卡（连续点按多个项）
+
+**打卡备注**
+- 支持纯文字（最多 500 字）
+- 支持上传图片（最多 9 张）
+- 支持上传短视频（≤30 秒）
+- 备注可在打卡详情页查看和编辑
+
+#### 5.2.3 补卡与断签提醒
+
+**补卡**
+- 允许补签最近 7 天的缺失记录
+- 每月免费补卡 3 次，超出可消耗成长积分兑换（5 积分/次）
+- 补卡后该日记录标注"已补卡"
+
+**断签提醒**
+- 当某个打卡项即将断签（当日 20:00 仍未打卡），推送提醒
+- 连续提醒间隔：20:00、21:00、22:00（用户可关闭）
+- 断签后，该打卡项的连续天数归零
+
+#### 5.2.4 定时推送打卡提醒
+- 按用户设定的提醒时间推送系统通知
+- 通知内容示例："📚 该背单词啦，今天还没打卡哦"
+- 用户可在设置中统一关闭推送
+
+---
+
+### 5.3 数据可视化模块
+
+#### 5.3.1 日历打卡视图
+- 按月切换，每个打卡项对应一个日历
+- 打卡日显示为实心圆点（颜色对应分类色）
+- 点击某日可查看当天的打卡详情
+- 支持日历分项筛选（只看学习/只看健康等）
+
+#### 5.3.2 统计总览
+| 指标 | 展示范围 | 展示形式 |
+|------|----------|----------|
+| 连续打卡天数 | 全局 / 单项 | 大数字 + 火焰图标 |
+| 本月完成率 | 单项 | 环形进度条 |
+| 年度完成率 | 全局 | 进度条 |
+| 累计完成次数 | 单项 | 数字 + 同比上月变化 |
+| 完成趋势 | 近 7 天 / 30 天 | 折线图 |
+| 坚持时长 | 单项 | 从首次打卡至今的天数 |
+
+#### 5.3.3 数据导出
+- 支持导出个人打卡数据为 CSV/Excel
+- 导出内容：打卡项、打卡日期、备注、连续天数
+
+---
+
+### 5.4 社交与比拼模块
+
+#### 5.4.1 好友系统
+- **添加好友**：搜索用户名/手机号、扫二维码、通讯录匹配
+- **好友列表**：按最近互动排序
+- **好友主页**：可查看好友公开的成长档案和动态
+
+#### 5.4.2 动态广场
+- 用户打卡时可选择"同步到动态广场"
+- 动态内容：打卡项名称 + 备注文字/图片/视频
+- 互动：点赞、评论（支持回复评论）
+- 动态排序：默认按时间倒序，支持切换为"热门"
+- 动态列表支持按分类筛选
+
+#### 5.4.3 排行榜
+
+| 排行类型 | 更新频率 | 范围 | 排名依据 |
+|----------|----------|------|----------|
+| 周榜 | 每周一 00:00 更新 | 好友 / 全平台 | 本周打卡完成率 |
+| 月榜 | 每月 1 日 00:00 更新 | 好友 / 全平台 | 本月完成率 + 连续天数加权 |
+| 小组榜 | 实时 | 小组内 | 个人对小组目标的贡献度 |
+
+**展示**：Top 10 显示排名头像和昵称，其他显示所在百分位
+
+#### 5.4.4 打卡小组
+
+**创建小组**
+| 字段 | 说明 | 必填 |
+|------|------|------|
+| 小组名称 | 原名称，最多 20 字 | 是 |
+| 小组封面 | 自定义图片 | 是 |
+| 小组简介 | 最多 200 字 | 是 |
+| 小组类型 | 公开（任何人可加入）/ 私密（需审核） | 是 |
+| 共同目标 | 可设定一个或多个打卡项作为小组目标 | 否 |
+| 人数上限 | 默认 50 人，可扩容 | 否 |
+
+**小组功能**
+- 成员管理：申请审核、移出、退出
+- 小组打卡看板：展示每个成员今日打卡进度
+- 小组 PK：两个小组可发起为期 7 天的打卡完成率对战
+- 小组动态：小组成员动态聚合为一个独立 tab
+
+#### 5.4.5 好友对战
+- **发起**：选择好友 → 选择一个或多个打卡项 → 设定对战时长（7/14/30 天）
+- **对战规则**：比拼指定项在周期内的打卡完成率
+- **实时展示**：双方进度条对比，每日更新
+- **结果**：周期结束后自动出结果，全平台推送
+
+---
+
+### 5.5 激励体系
+
+#### 5.5.1 成就徽章
+
+| 徽章名称 | 解锁条件 |
+|----------|----------|
+| 初露锋芒 | 完成第 1 次打卡 |
+| 七日坚持 | 任意打卡项连续 7 天 |
+| 半月之约 | 任意打卡项连续 15 天 |
+| 月满则盈 | 任意打卡项连续 30 天 |
+| 百日筑基 | 任意打卡项连续 100 天 |
+| 全面开花 | 同时有 5 个打卡项保持活跃 |
+| 社交达人 | 获得 50 个点赞 |
+| 小组之星 | 在小组内连续打卡满 30 天 |
+| 神补刀 | 使用补卡功能 10 次 |
+| 年度坚持王 | 全年打卡完成率 ≥ 80% |
+
+- 徽章解锁时发送系统通知
+- 徽章有稀有度标识（铜/银/金）
+
+#### 5.5.2 成长积分
+
+**获取途径**
+| 行为 | 积分 |
+|------|------|
+| 每日打卡一次 | +1 |
+| 连续打卡第 7 天 | +5（额外） |
+| 连续打卡第 30 天 | +20（额外） |
+| 完成一项打卡目标 | +10 |
+| 分享动态 | +2（每日上限 3 次） |
+| 评论他人动态 | +1（每日上限 5 次） |
+| 邀请新用户注册 | +15（每月上限 5 人） |
+
+**消耗途径**
+- 补卡：5 积分/次
+- 兑换徽章装饰特效
+- 兑换个性化主题皮肤（规划中）
+
+#### 5.5.3 阶段总结报告
+- **月度成长报告**：每月 1 日自动生成
+  - 本月打卡完成率对比上月
+  - 本月最佳坚持项
+  - 本月获得徽章
+  - 本月积分增减
+  - 一句话激励文案
+- **季度/年度报告**：内容更丰富，含趋势图和社交维度数据
+
+---
+
+### 5.6 辅助工具模块
+
+#### 5.6.1 待办清单与打卡联动
+- 用户可创建简单的每日待办清单
+- 待办项与打卡项绑定：完成待办后自动完成对应打卡
+- 示例：待办"背 30 个单词"→ 绑定"背单词"打卡项，勾选待办即打卡
+
+#### 5.6.2 打卡周期自定义
+- 每日：最基础，每天检查
+- 每周：指定周几打卡（如周一、三、五）
+- 隔日：打卡一天休息一天
+- 自定义：按 N 天为周期（如每 3 天打卡一次）
+
+#### 5.6.3 隐私设置体系
+
+| 隐私层级 | 适用范围 | 说明 |
+|----------|----------|------|
+| 公开 | 打卡项 / 主页 / 动态 | 所有人可见 |
+| 仅好友可见 | 同上 | 仅双向好友可见 |
+| 仅自己可见 | 同上 | 完全私密 |
+| 隐藏动态 | 单条动态 | 发布后从广场移除但数据保留 |
+
+- 隐私设置支持批量修改
+- 创建打卡项时默认隐私为"仅自己可见"
+
+---
+
+### 5.7 消息与通知
+
+| 通知类型 | 触发条件 | 推送方式 |
+|----------|----------|----------|
+| 打卡提醒 | 用户设定的提醒时间 | 通知栏 |
+| 断签预警 | 当日 20:00 未打卡 | 通知栏 |
+| 点赞/评论 | 他人互动 | 通知中心 |
+| 好友请求 | 收到好友申请 | 通知栏 + 通知中心 |
+| 成就解锁 | 获得徽章 | 弹窗 |
+| 对战邀请 | 好友发起对战 | 通知栏 |
+| 排行榜刷新 | 周榜/月榜更新 | 通知中心 |
+
+---
+
+## 6. 非功能需求
+
+### 6.1 性能要求
+- 首页加载：冷启动 ≤ 2 秒，热启动 ≤ 1 秒
+- 打卡操作：点击到反馈 ≤ 500ms
+- 动态广场加载：首屏 ≤ 1.5 秒，滑动加载新内容 ≤ 1 秒
+- 日历视图切换：≤ 800ms
+- 排行榜数据：≤ 2 秒
+
+### 6.2 并发与规模
+- 支撑初期 1 万 DAU，日打卡记录 50 万条
+- 动态广场 Feed 支持 1000 QPS
+
+### 6.3 数据安全
+- 用户密码加密存储（bcrypt 或等同强度）
+- 隐私数据（个人主页、私密打卡项）严格控制服务端查询权限
+- 图片/视频上传需做安全审核（后续接入自动审核服务）
+- 数据备份：每日全量备份，每 6 小时增量备份
+
+### 6.4 兼容性
+- iOS 14+，Android 8+
+- 微信小程序基础库 2.20+
+- **Web 端**：Chrome 90+、Safari 15+、Edge 90+，响应式布局适配 375px-1920px 视口
+- **管理后台**：Chrome 90+、Edge 90+（优先 Chromium 内核），最低分辨率 1280x720
+
+### 6.5 其他
+- 支持离线打卡：断网时本地缓存打卡记录，联网后同步
+- 推送到达率 ≥ 95%（接入厂商通道）
+
+---
+
+## 7. 数据模型概要
+
+### 7.1 核心实体关系
+
+```
+User (用户)
+ ├── CheckInItem (打卡项)        → CheckInRecord (打卡记录)
+ ├── Achievement (成就徽章)       → UserAchievement (用户已获得)
+ ├── PointsLog (积分流水)
+ ├── Friend (好友关系)            → 双向关联
+ ├── Post (动态)                  → Comment / Like
+ ├── Group (打卡小组)             → GroupMember
+ ├── Battle (好友对战)            → BattleParticipant
+ └── Report (成长报告)
+```
+
+### 7.2 主要字段概要
+
+**User**
+- id, phone, nickname, avatar, bio, motto, privacy_level, total_days, max_streak, points, created_at
+
+**CheckInItem**
+- id, user_id, name, icon, category, daily_goal, cycle_type, cycle_config, remind_time, privacy_level, status (active/paused/archived), deadline, target_goal, created_at
+
+**CheckInRecord**
+- id, item_id, user_id, check_date, status (normal/makeup), note_type (text/image/video), note_content, created_at
+
+**Achievement**
+- id, name, description, icon, rarity (bronze/silver/gold), condition_type, condition_value
+
+**Group**
+- id, name, cover, intro, type (public/private), max_members, target_items, created_by, created_at
+
+**Battle**
+- id, creator_id, opponent_id, item_ids, start_date, end_date, status (pending/active/completed), winner_id
+
+**Post**
+- id, user_id, item_id, content_type, content, images, video_url, privacy, likes_count, comments_count, created_at
+
+---
+
+## 8. 优先级矩阵
+
+### 8.1 分级标准
+- **P0**：核心功能，无此功能产品无法交付
+- **P1**：重要功能，支撑产品核心体验
+- **P2**：增强功能，提升体验但非必须
+- **P3**：远期规划，v1.0 之后考虑
+
+### 8.2 功能优先级
+
+| 模块 | 功能 | 优先级 | 说明 |
+|------|------|--------|------|
+| 用户 | 注册登录 | P0 | 基础入口 |
+| 用户 | 个人主页与成长档案 | P1 | 存在感核心 |
+| 打卡 | 创建打卡项 | P0 | 产品基石 |
+| 打卡 | 每日打卡操作 | P0 | 产品基石 |
+| 打卡 | 打卡备注（文字/图文） | P1 | 完整体验 |
+| 打卡 | 打卡备注（视频） | P2 | 后续完善 |
+| 打卡 | 定时推送提醒 | P1 | 留存关键 |
+| 打卡 | 补卡功能 | P1 | 容错机制 |
+| 打卡 | 断签提醒 | P1 | 防流失 |
+| 打卡 | 多周期支持 | P1 | 灵活性 |
+| 可视化 | 日历打卡视图 | P0 | 核心体验 |
+| 可视化 | 统计总览与图表 | P1 | 体现进步 |
+| 可视化 | 数据导出 | P2 | 增强 |
+| 社交 | 好友系统 | P1 | 社交基础 |
+| 社交 | 动态广场 | P1 | 社交核心 |
+| 社交 | 排行榜 | P1 | 竞争驱动 |
+| 社交 | 打卡小组 | P2 | 深度社交 |
+| 社交 | 好友对战 | P2 | 深度社交 |
+| 激励 | 成就徽章 | P1 | 持续动力 |
+| 激励 | 成长积分 | P1 | 持续动力 |
+| 激励 | 月度/年度报告 | P1 | 阶段性闭环 |
+| 辅助 | 待办清单绑定 | P2 | 效率增强 |
+| 辅助 | 隐私设置 | P1 | 安全感 |
+| 辅助 | 离线打卡 | P2 | 体验优化 |
+
+---
+
+## 9. 验收标准
+10. 商业模式与盈利点
+
+### 11.1 用户管理
+- [x] 用户可成功注册并登录，Token 有效期内无需重复登录
+- [x] 个人主页正确展示用户信息和打卡统计数据
+- [x] 隐私设置生效：仅自己可见的内容在广场和非好友主页不展示
+
+### 11.2 打卡功能
+- [x] 用户可完整创建→查看→编辑→暂停→归档→删除一个打卡项
+- [x] 每日打卡完成时积分 +1，连续天数更新
+- [x] 补卡不突破连续天数且记录标注"已补卡"
+- [x] 推送提醒在设定时间准时发送
+- [x] 不同打卡周期（每日/每周/隔日）正确计算待打卡日
+
+### 11.3 数据可视化
+- [x] 日历视图准确标记打卡日与缺失日
+- [x] 月度/年度完成率百分比计算正确
+- [x] 折线图趋势数据与打卡记录一致
+
+### 10.4 社交
+- [x] 好友添加流程完整，双向好友关系正确
+- [x] 动态广场发布→展示→互动（点赞评论）功能正常
+- [x] 排行榜数据按规则正确排序
+- [x] 小组创建→加入→打卡→查看成员进度功能正常
+- [x] 对战发起→进行→结算流程完整
+
+### 10.5 激励体系
+- [x] 所有徽章解锁条件可达成，解锁时正确通知
+- [x] 积分获取和消耗记录准确
+- [x] 月度报告数据与打卡记录一致
+
+---
+
+
+## 10. 商业模式与盈利点
+
+### 11.1 总体策略
+寸进的核心商业逻辑是 **Freemium + 虚拟增值 + 社交激励付费**。基础打卡功能完全免费，以保证用户增长和留存；盈利点集中在虚荣心、效率提升、深度社交三个方向上，不靠广告骚扰破坏产品调性。
+
+### 11.2 会员订阅（寸进 Pro）
+
+| 层级 | 价格参考 | 核心权益 |
+|------|----------|----------|
+| 免费版 | ¥0 | 创建 ≤ 5 个打卡项、基础统计、每日提醒、标准徽章 |
+| Pro 月卡 | ¥12/月 | 无限打卡项、高级图表（趋势对比/多维度交叉分析）、无限补卡、自定义主题皮肤 |
+| Pro 季卡 | ¥30/季 | 月卡全部权益 + 月度报告 PDF 导出、专属徽章边框特效 |
+| Pro 年卡 | ¥88/年 | 季卡全部权益 + 年度深度报告、早鸟体验新功能、会员专属标识 |
+
+**定价参考依据**：对标同类习惯类 App（小日常年卡 ¥68–¥98，潮汐年卡 ¥108），寸进 Pro 年卡 ¥88 定位中等偏低，降低付费门槛。
+
+### 11.3 虚拟商品商城
+
+#### 9.3.1 个性装扮
+| 商品类型 | 定价 | 说明 |
+|----------|------|------|
+| 打卡项主题图标包 | ¥6/包 | 解锁一套精美手绘图标，如"国风""简约""手账风" |
+| 个人主页皮肤 | ¥12/套 | VIP 定制主页背景，含动效 |
+| 徽章装饰框 | ¥3/个 | 为已获得的徽章添加金框、流光特效等 |
+| 动态卡片模板 | ¥6/包 | 打卡分享到广场时使用精美排版模板 |
+
+#### 9.3.2 成长积分兑换（积分也可直接购买）
+| 商品 | 积分价格 | 备注 |
+|------|----------|------|
+| 额外补卡次数（1 次） | 5 积分 | 月免费额度用完后消耗 |
+| 补卡月卡（无限补卡） | 200 积分 | 性价比选择 |
+| 限定徽章 | 500 积分 | 特殊设计，非 Pro 也可通过活跃获得 |
+| 皮肤体验卡（7 天） | 100 积分 | 限时体验 |
+
+### 10.4 小组/战队增值服务
+
+| 功能 | 免费版限制 | Pro/付费解锁 |
+|------|------------|--------------|
+| 创建小组数量 | 最多 1 个 | Pro 无限 |
+| 小组人数上限 | 50 人 | Pro 可扩容至 200 人（¥6/次扩容） |
+| 小组数据分析 | 基础统计 | 小组内成员排名趋势、完成率热力图 |
+| 同时发起对战数量 | 1 场 | Pro 最多同时 5 场 |
+
+### 10.5 深度数据报告
+免费用户可查看月度报告的简版预览。完整版（含相比上月的变化分析、下月建议、PDF/图片一键分享）需 Pro 订阅或单次付费 ¥3。
+
+### 10.6 广告（克制模式）
+寸进在 MVP 阶段不做广告。进入增长期后考虑在以下位置放置原生广告，不破坏体验：
+
+| 广告位 | 形式 | 定价参考（CPM） | 说明 |
+|--------|------|-----------------|------|
+| 动态广场信息流（每 10 条插 1 条） | 图片/视频卡片 | ¥15–¥25 | 仅限教育/图书/运动类品牌，风格与动态卡片一致 |
+| 打卡完成弹窗底部 | 小横幅 | ¥8–¥15 | 打卡成功后展示，非侵入式 |
+| 排行榜赞助商冠名 | 品牌露出 | ¥3,000–¥8,000/月 | "本周榜由 XXX 冠名" |
+
+**可选策略**：提供"去广告永久包"¥18，付费后永不看到广告，兼顾体验敏感用户的诉求。
+
+### 10.7 知识付费 / 内容导流
+
+#### 9.7.1 打卡挑战营
+- 平台联合 KOL 发起付费打卡营（如"21 天阅读挑战"¥9.9）
+- 用户付费报名，完成打卡退还报名费（或瓜分未完成者的报名费）
+- 寸进抽成 20%
+
+#### 9.7.2 精选推荐
+- 根据用户打卡品类，推荐关联书籍、课程、工具
+- 按 CPS（按成交付费）结算，导流至合作方
+
+### 10.8 实体衍生品（品牌周边）
+| 商品 | 定价 | 说明 |
+|------|------|------|
+| 寸进年度打卡手账本 | ¥49 | 实体纸版配合 App 使用，含 365 天打卡内页 |
+| "Every inch counts." 帆布包 / 贴纸 | ¥39 / ¥9.9 | 品牌周边 |
+| 月度打卡海报（可打印 PDF） | ¥6 | 设计精美的月度打卡追踪 PDF |
+
+### 10.9 收入预估模型
+
+假设 DAU 10,000，MAU 约 40,000：
+
+| 收入来源 | 付费转化率 | 客单价（月均） | 月收入估算 |
+|----------|------------|----------------|------------|
+| Pro 订阅 | 5% 付费率 | ¥7.3（年卡均摊） | ¥14,600 |
+| 虚拟商品 | 3% 月活购买 | ¥6 | ¥7,200 |
+| 小组增值 | 0.5% 月活 | ¥8 | ¥1,600 |
+| 广告收入 | — | — | ¥2,000–¥5,000 |
+| 挑战营抽成 | 2% 月活参与 | ¥2（抽成后） | ¥1,600 |
+| 实体周边 | 1% 月活购买（季度） | ¥25（均摊月） | ¥3,333 |
+| **合计** | | | **¥30,333–¥33,333/月** |
+
+> 以上为保守估算。随着用户规模增长，订阅和广告收入有明显边际效应；当 DAU 达到 50,000–100,000 时，月收入预计可达 ¥15–30 万。
+
+### 10.10 商业化原则
+
+| 原则 | 说明 |
+|------|------|
+| 基础打卡永远免费 | 打卡这个最核心的行为不能收费，否则用户流失 |
+| 付费不能让用户变强 | 只能买皮肤、买便利、买深度数据，不能用钱买连续天数或排行榜排名 |
+| 尊重隐私 | 付费功能不涉及查看他人隐私数据 |
+| 先价值后付费 | 用户先充分体验产品价值，再被自然引导到付费点，不做强制付费门 |
+
+---
+## 11. 附录
+
+### 11.1 参考竞品
+- 小日常（习惯打卡类）— UI 参考
+- 番茄 ToDo（待办+专注）— 提醒机制参考
+- Grow（成长社区）— 社区氛围参考
+- Forest / 专注森林 — 社交比拼参考
+
+### 11.2 风险与应对
+
+| 风险 | 影响 | 应对方案 |
+|------|------|----------|
+| 用户社交活跃度低 | 社交模块形同虚设 | 初始种子用户运营，排行榜推送激励 |
+| 用户离线打卡导致数据冲突 | 数据不一致 | 以客户端时间 + 服务端校验，冲突时保留多条 |
+| 打卡项过多用户疲劳 | 流失 | 引导聚焦 3–5 个核心打卡项，减少推送频次 |
+| 隐私数据泄露 | 法律风险 | 最小权限原则 + 隐私数据加密 + 审计日志 |
+
+### 11.3 版本规划建议
+
+| 版本 | 目标 | 核心交付 |
+|------|------|----------|
+| v1.0 MVP | 三端同步上线 | 注册登录、打卡 CRUD、日历视图、推送提醒、基础统计（Web + App + 小程序 + 管理后台） |
+| v1.1 | 社交启动 | 好友系统、动态广场、排行榜 |
+| v1.2 | 深度社交 | 打卡小组、好友对战 |
+| v1.3 | 激励闭环 | 成就徽章、积分体系、月度报告 |
+| v2.0+ | 体验增强 | 待办联动、离线打卡、数据导出、视频备注、主题换肤 |
+
+
+
+
+