0.0.0

wangquan-PRD.md

@@ -0,0 +1,260 @@
+# 汪圈 · 遛狗小程序 产品需求文档（PRD）V1
+
+> 配套交付物：可点击交互原型 `wangquan-prototype.html`
+> 本文档定义首版范围、页面、字段、交互规则与算法。原型看交互，PRD 核字段与逻辑边界，两者配套使用。
+
+---
+
+## 0. 产品定位与首版范围
+
+**一句话定位**：记录每一次遛狗，把单机行为变成有反馈、可积累的陪伴成果。
+
+**核心闭环**：登录 → 建档狗狗 → 遛狗（实时记录）→ 生成成果卡 → 沉淀进狗狗主页。
+
+**首版只做遛狗单机闭环**。所有社区、商业、本地信息功能均为 pending，不进首版。理由：单机闭环不依赖用户密度和内容供给，是冷启动期唯一能保证有内容、有回访的部分。
+
+### 首版做（In Scope）
+
+| 模块 | 说明 |
+|---|---|
+| 微信登录 + 狗狗建档 | 首次进入链路 |
+| 遛狗记录 | 计时、距离、狗步，含暂停、便便打卡 |
+| 成果卡 | 遛完总结，拟人化反馈，分享 |
+| 狗狗主页 | 累计数据、成就墙、近期记录 |
+| 记录 Tab | 成就墙概览 + 遛狗历史 + 手动补记 |
+| 完整成就页 | 已解锁/未解锁，进度展示 |
+
+### 首版不做（Pending，见第 7 节 Roadmap）
+
+附近实时在线地图、夸一夸/拍一拍轻社交、坚持排行榜、汪友好友系统、广场/养宠知识信息站、宠物友好地点与市集、商城与今日上新。
+
+---
+
+## 1. 页面清单
+
+底部导航三 Tab：**记录 · 遛狗（中央凸起按钮）· 我的**。
+中央按钮是「开始遛狗」动作入口，非页面 Tab。
+
+| 编号 | 页面 | 类型 | 入口 |
+|---|---|---|---|
+| 0a | 欢迎 / 微信授权登录 | 全屏 | 首次打开 |
+| 0b | 建档 / 编辑狗狗 | 表单 | 登录后（新用户）/ 主页编辑 |
+| 0c | 多狗选择 | 弹层 | 多狗用户点遛狗 |
+| 1 | 我的（首页/入口） | Tab 页 | 启动默认 / 底部「我的」 |
+| 2 | 遛狗中 · 进行态 | 全屏 | 中央按钮 |
+| 2b | 遛狗中 · 暂停态 | 全屏 | 进行态点暂停 |
+| 3 | 成果卡 | 全屏 | 结束遛狗 |
+| 4 | 狗狗主页 | 二级页 | 首页狗狗卡片 |
+| 5 | 遛狗历史 + 补记 | 二级页 | 我的→遛狗历史 |
+| 6 | 记录 Tab | Tab 页 | 底部「记录」 |
+| 6b | 记录 Tab 空状态 | 状态 | 无记录的新用户 |
+| 7 | 完整成就页 | 二级页 | 记录Tab成就墙 / 我的→成就 |
+
+---
+
+## 2. 字段表（遛狗记录）
+
+核心原则：**自动的尽量自动，需要输入的全部后置到遛完且全部选填**。哪怕用户什么都不填，遛一次狗也能产出完整成果卡。
+
+| 字段 | 采集方式 | 必填 | 用途 | 备注 |
+|---|---|---|---|---|
+| 时长 | 自动计时 | 是 | 核心数据、成果卡主轴 | 暂停时停止计时 |
+| 距离 | GPS 累计 | 否 | 次级数据 | 未授权定位时隐藏 |
+| 狗步 | 距离换算 | 否 | 拟人化展示 | 见第 4 节算法 |
+| 连续天数 | 系统计算 | 是 | 坚持叙事、成就 | 补记可维持不断签 |
+| 轨迹 | GPS 点序列 | 否 | 地图轨迹 | 首版可后置 |
+| 哪只狗 | 选择/默认 | 是 | 多狗归属 | 单狗自动带入 |
+| 照片 | 手动 | 否 | 未来 feed 内容 | 成果卡补充 |
+| 文字 | 手动 | 否 | 记录心情 | 成果卡补充 |
+| 天气 | 自动/手动 | 否 | 雨天战士等成就 | 可自动获取 |
+| 便便打卡 | 手动开关 | 否 | 健康场景 | 遛狗中即时记录 |
+| 心情标签 | 手动 | 否 | 情感记录 | 成果卡补充 |
+| 数据来源 | 系统标记 | 是 | 区分实时/补记 | 见第 5 节补记规则 |
+
+### 狗狗建档字段（0b）
+
+| 字段 | 必填 | 用途 |
+|---|---|---|
+| 名字 | 是 | 拟人化文案（「豆豆走了…」），未建档时文案降级为通用版 |
+| 犬种 | 是 | 映射体型档位，决定狗步步幅 |
+| 性别 | 否 | 资料展示 |
+| 年龄 | 否 | 资料展示 |
+| 体重 | 否 | 狗步二次校准（见第 4 节） |
+| 头像 | 否 | 资料展示 |
+
+---
+
+## 3. 交互规则
+
+### 3.1 登录与首次进入（0a → 0b → 1）
+
+- 首次打开进登录页（0a），微信一键授权登录。
+- 登录后判断：**用户是否建档过狗狗** —— 这是状态判断，非固定跳转。
+  - 未建档 → 进建档页（0b），完成后进首页。
+  - 已建档（老用户）→ 跳过建档，直接进首页。
+- 0a 必须包含用户协议、隐私政策（合规要素）。
+
+### 3.2 开始遛狗（中央按钮）
+
+- 单只狗 → 跳过选择，直接进遛狗中（2）。
+- 多只狗 → 弹多狗选择层（0c），可多选一起遛，确认后进遛狗中。
+- 边界：未建档任何狗 → 拦截并引导先建档，不可直接遛狗。
+
+### 3.3 遛狗中（2 / 2b）
+
+- 进行态：计时器每秒自增；距离/狗步实时累计（依赖定位）。
+- 便便打卡为行内开关，遛狗中即时记录。
+- 暂停（→ 2b）：停止计时，时长与数据置灰，地图区提示「计时已停止」。常见停顿（等狗、捡便便）用暂停避免污染数据。
+- 暂停态主按钮为「继续」（蓝色，提示恢复），并列「结束」。
+- 结束：必须二次确认弹窗（防误触毁掉记录），确认后生成成果卡（3）。
+
+### 3.4 定位降级
+
+- 未授权定位时：距离、狗步两项隐藏，仅保留时长。闭环依然成立。
+- 首版不强制请求定位权限，避免首次使用被权限弹窗劝退；定位作为可选增强。
+
+### 3.5 成果卡（3）
+
+- 视角是「豆豆走了 X 狗步」，非「你遛了」——拟人化是与运动 App 的根本区别。
+- 所有补充字段（照片/文字/天气/心情）集中此页且全部选填，跳过可保存。
+- 分享按钮为首选项（拉新入口）。
+- 「完成」后记录沉淀进狗狗主页近期记录。
+
+### 3.6 狗狗主页（4）
+
+- 累计数据：总次数 / 总公里 / 连续天数。**不展示配速、卡路里**——记录陪伴厚度而非运动表现。
+- 成就墙显示进度（如 3/12），露出未解锁灰锁制造收集欲。
+- 近期记录点击 → 单次记录详情页（见第 6 节待补项，首版可暂跳成果卡只读态）。
+- 右上编辑 → 建档/编辑表单（0b），预填已有值，标题改「编辑资料」。
+
+### 3.7 记录 Tab（6 / 6b）
+
+- 内部两块：成就墙概览（横向）+ 遛狗历史列表，顶部「+补记」入口。
+- 成就墙概览点击 → 完整成就页（7）。
+- 空状态（6b）：新用户无记录时显示。俏皮文案引导去遛狗 + 「带豆豆出门」按钮。成就墙不藏，显示全灰「0/X 待解锁」制造期待。文案中的狗名动态替换；未建档时降级为通用文案。
+- 遛完第一次 → 自动从空状态切为正常态。
+
+### 3.8 成就系统
+
+- 成就基于「连续 / 累计 / 场景」，**不基于「最多」**——避免刷量与过度遛狗，强化坚持叙事。
+- 示例：首遛、一周不断（连续7天）、满月坚持（连续30天）、百里同行（累计100km）、雨天战士、早起鸟。
+- 「记录」Tab 与「我的→成就」两个入口指向**同一完整成就页**，文案统一叫「成就」，避免用户误以为是两个东西。
+
+---
+
+## 4. 狗步计算算法
+
+### 4.1 核心公式
+
+```
+狗步 = round( 距离(米) / 步幅 S )
+```
+
+步幅 S 由**体型档位**决定（非具体品种），是品种间差异的来源。
+
+### 4.2 体型档位表
+
+| 体型档位 | 代表品种 | 步幅 S（米/步） | 走 1km ≈ 狗步 |
+|---|---|---|---|
+| 超小型 | 吉娃娃、博美 | 0.20 | 5,000 |
+| 小型/短腿 | 柯基、腊肠、比熊 | 0.25 | 4,000 |
+| 中型 | 柴犬、边牧、斗牛 | 0.35 | 2,860 |
+| 大型 | 金毛、拉布拉多 | 0.45 | 2,220 |
+| 超大型 | 德牧、阿拉斯加 | 0.55 | 1,820 |
+
+### 4.3 品种 → 档位映射
+
+- 建档选具体品种 → 系统自动归入对应体型档位（映射表内置）。
+- 中华田园犬 / 串串 / 找不到的品种 → 让用户**手动选体型档位**。
+- 不做「每品种一个系数」——犬种过多、混血无法归类，会卡住用户。
+
+### 4.4 体重二次校准（可选）
+
+填了体重时，在档位基础步幅上做微调：
+
+```
+S = 基础步幅 × ( 1 + (体重 - 档位标准体重) × 0.005 )
+修正幅度封顶 ±15%
+```
+
+未填体重 → 用档位基础步幅，不影响闭环。
+
+### 4.5 关键约束：狗步只是展示层
+
+- 狗步被品种系数放大/缩小过，**跨狗比较无意义**（柯基天生狗步多 ≠ 遛得多）。
+- 底层入库、用于成就与未来排行榜计算的，一律是**距离和时长**等客观量。
+- 狗步仅在成果卡、狗狗主页做拟人化展示。
+- 一句话：**客观量入库，狗步只露脸。**
+
+---
+
+## 5. 手动补记规则
+
+- 入口：记录 Tab / 遛狗历史页 右上「+」。
+- 用途：用户忘记开 App 就出门遛，遛完事后补填时长/距离。
+- 字段：哪只狗、时间、时长（必填），距离（选填）。
+- 标识：补记记录带「补记」标识，数据层标记 `数据来源 = 补记`。
+- **计分规则（关键）**：
+  - 补记**可维持连续打卡不断签**（保护坚持叙事，避免用户因忘开 App 而委屈）。
+  - 补记**不计入未来排行榜竞争**（防刷量）。
+  - 故数据层必须区分「实时记录」与「补记记录」两种来源。
+
+---
+
+## 6. 待补项（建议补，不阻塞首版上线）
+
+这些不一定都要画屏，但开发实现时会碰到，需在本文档明确：
+
+1. **单次记录详情页**：回看旧记录应为只读详情页（数据 + 当时填的天气/心情/照片 + 删除/编辑），不应复用带「分享/完成」按钮的成果卡。原型中暂用成果卡占位。
+2. **设置页**：至少含定位权限管理（数据降级开关）、关于、隐私政策。
+3. **边界态文案**：
+   - 定位未授权时遛狗中页的降级样式（距离/狗步隐藏）。
+   - 未建档狗就想遛狗的拦截引导。
+   - 补记成功后的反馈 toast。
+   - 删除记录的二次确认。
+4. **分享卡片样式**（建议尽早做，拉新关键）：点「生成图片分享」后那张图的视觉。
+
+---
+
+## 7. Roadmap（Pending 功能与时序）
+
+首版后按以下时序逐步迭代，每一步都以「单机闭环已跑通、有局部用户密度」为前提：
+
+| 阶段 | 功能 | 说明 |
+|---|---|---|
+| 首版 | 遛狗单机闭环 | 本文档定义范围 |
+| 阶段二 | 成果卡被夸（轻社交第一张牌） | 见 7.1 |
+| 阶段三 | 坚持排行榜 | 奖励连续/达标，非「最多」；竞争圈切小（附近/同犬种） |
+| 阶段四 | 实时在线地图 | 见 7.1，验证后再上，重隐私工程 |
+| 更后 | 汪友、本地信息站、商城 | 视社区牵引力决定 |
+
+### 7.1 附近轻社交：先做异步「被夸」，慎做实时地图
+
+**情感钩子**：遛狗时/遛完能「被夸一夸、拍一拍」，成果卡显示「这次遛狗被 N 人夸了夸」，给单机行为注入社交正反馈。
+
+**两种形态对比**：
+
+| | 实时在线地图 | 成果卡被夸（异步，建议先做） |
+|---|---|---|
+| 体验 | 即时、好玩 | 温和 |
+| 位置隐私 | 暴露实时位置（红线） | 不暴露（遛完才发，位置模糊到行政区） |
+| 密度依赖 | 强依赖同时在线 | 异步，不靠同时在线 |
+| 冷启动 | 0 在线时是空壳 | 旧记录也能被夸，供给更稳 |
+
+**建议**：先做异步「成果卡被夸」——成果卡进入同城/同区可见的轻量动态流，他人对已完成记录点「夸夸」。验证用户确实爱「被夸」后，再评估是否上「实时在线地图」这一重形态。
+
+**实时地图若要做，隐私是硬约束（按隐私工程对待，非地图功能）**：
+- 默认模糊化：只显示「附近约 N 只在线」或网格化区域，**绝不显示精确点位和轨迹**。
+- 必须显式授权，提供一键隐身。
+- 绝不展示狗主人身份信息。
+- 「拍一拍」需频率限制 + 举报机制，防骚扰与刷量。
+
+---
+
+## 8. 设计风格
+
+视觉方向：「晨霜 V3」暖色磨砂玻璃。暖米底色、磨砂玻璃导航栏、琥珀暖橙作主色（呼应狗步的温度感），刻意避开冷色运动 App 观感。具体设计令牌见原型 `wangquan-prototype.html` 的 CSS 变量定义。
+
+---
+
+*文档版本 V1 · 配套原型 wangquan-prototype.html*