4.9 KiB
4.9 KiB
07 · PRD 对齐评审
目的：逐条对比
wangquan-PRD.md与docs/落地设计，判断哪一边方案更合理，并记录已经写回设计文档的结论。
结论总览
整体方向以 PRD 为产品边界，以 docs/ 为工程落地方式。PRD 在产品范围、狗步算法、定位降级、拟人化表达上更完整；docs/ 在技术选型、云函数拆分、安全、防刷、后台计时恢复上更落地。最终方案采用「PRD 定边界，docs 定实现」的组合。
逐条对比
| 项 | PRD 方案 | docs 原方案 | 哪边更好 | 最终修改 |
|---|---|---|---|---|
| V1 范围 | V1 包含计时、距离、狗步；轨迹可后置 | 计时先跑通，GPS 距离/狗步后置 | PRD 更好。距离/狗步是成果卡拟人化的关键，不应整体后置 | V1 纳入可选 GPS 距离与狗步；后置仅保留轨迹回放、GPS 去噪 |
| 定位权限 | 首版不强制定位，未授权隐藏距离/狗步 | 降级处理有，但把距离/狗步存 null 作为阶段方案 | PRD 更清晰 | 明确“授权则增强，未授权则降级”，首次打开不强制索权 |
| 狗步算法 | 体型档位决定步幅，体重可二次校准 | breedFactor 犬种系数 |
PRD 更好。犬种系数会把模型复杂化，也不利于串串/未知犬种 | 改为 sizeLevel/baseStride/stride，未知犬种手动选体型 |
| 多狗同遛狗步 | 支持多狗一起遛，但 PRD 未展开字段结构 | 单个 dogSteps 字段 |
组合后更好。多狗同遛时每只狗步幅不同，不能只存一个狗步 | 改为 dogStepsByDog: { [dogId]: steps }，服务端按每只狗 stride 计算 |
| 狗步用途 | 狗步只是展示层，不用于跨狗比较、成就、排行 | 有 totalSteps，但约束不够明确 |
PRD 更好 | 文档补充：成就/排行只用距离、时长、连续天数等客观量 |
| 登录建档分流 | 登录后按是否已有狗判断进入建档或首页 | login 返回 hasDog |
docs 更落地 | 保留 hasDog 云函数方案 |
| 建档字段 | 名字、犬种必填，其余选填 | 同 PRD | 一致 | 保留，补充未知犬种体型选择 |
| 计时与暂停 | 暂停停止计时，结束二次确认 | 时间戳差值 + pausedTotal，支持后台恢复 |
docs 更好 | 保留 docs 的时间戳实现，PRD 规则不变 |
| 成果卡补充字段 | 照片/文字/天气/心情集中成果卡，全部选填 | walkSave 入参混在结束保存里，计划里提到 attach 但设计不完整 |
PRD 交互更好，docs 的 attach 思路更落地 | walkSave 明确拆成 finish 和 attach 两个动作 |
| 成果卡分享 | 分享是首选 CTA，分享图样式建议尽早做 | Canvas 分享图在增长阶段 | docs 更务实 | 保留增长阶段，但成果卡仍保留分享 CTA |
| 狗狗主页统计 | 总次数/总公里/连续天数，不要配速/卡路里 | 同 PRD | 一致 | 保留 |
| 记录 Tab | 成就概览 + 历史 + 补记；空状态露出灰锁 | 同 PRD | 一致 | 保留 |
| 手动补记 | 可维持连续，不计未来排行榜，标记数据来源 | isManual + countsForRanking |
组合后更好 | 增加 source='manual'/'realtime'，保留 isManual 便于展示 |
| 连续天数算法 | 补记可不断签，以日期判断 | docs 写了同日/昨日/断签逻辑 | docs 更落地 | 保留 docs 算法 |
| 成就体系 | 按连续/累计/场景，不按最多 | 同 PRD，且有 dog_achievements 集合 |
docs 更落地 | 保留集合设计，强调按狗维度 |
| 单次记录详情页 | 建议补，只读详情页更合理；首版可暂用成果卡只读态 | 历史项直接跳 summary 回看 | PRD 更完整，docs 更省实现 | V1 允许 summary 只读占位，但禁止出现“完成”等流程按钮；后续补 record-detail |
| 设置页 | PRD 建议补定位权限、关于、隐私政策 | docs 未纳入页面清单 | PRD 更完整，但不阻塞 V1 主闭环 | 暂不扩页面清单，作为后续待补项处理 |
| 技术选型 | PRD 不限定 | 原生小程序 + 云开发 | docs 更好 | 保留 |
| 安全与防刷 | 需要区分实时/补记，防排行刷量 | 所有写操作走云函数，openid 服务端取，客户端禁写 | docs 更好 | 保留并补充 source 字段 |
| Pending 功能 | 社区、附近、排行榜、信息站、商城不进首版 | 同 PRD | 一致 | 保留 |
已写回的文档
README.md：更新 V1 范围和文档索引。01-架构设计.md：补充定位会话字段，修正dogStep.js职责。02-数据模型.md：改为体型档位/步幅模型，新增source和dogStepsByDog。03-云函数设计.md：补齐dogManage步幅计算、walkSave finish/attach、服务端狗步计算。04-页面与路由.md：明确定位增强、历史回看只读占位。05-业务规则.md：重新整理必落地规则，新增狗步算法和定位规则。06-开发计划.md：把 V1 距离/狗步拉回核心闭环，后置项改为轨迹回放与去噪。