Files
perler-lab/docs/ROADMAP.md
T
Sisyphus (主代理) 02762400fb chore: 项目基线提交 - 拼豆图纸生成器 V1.0 核心代码
- 前端: React+Vite 首页/AI专区, 算法库(MARD色板/量化/背景去除), API对接
- 后端: Express+SQLite, 兑换码/订单/支付/chibi生成, 风控+云端同步
- CI/CD: GitHub Actions + Docker + nginx 配置
- 文档: PRD/DESIGN/LAUNCH/ROADMAP/E2E/竞品对照等 15 份
- 工程: 任务看板(taskboard) + 健康巡检(agent-health) + Git流程(gitflow)
2026-08-13 21:40:27 +08:00

258 lines
16 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# PERLER LAB 拼豆图纸生成器 · 产品版本路线图(ROADMAP)
| 项目 | 内容 |
|---|---|
| 文档版本 | v1.0 |
| 编写日期 | 2026-08-13 |
| 编写角色 | PM-Agent |
| 关联文档 | PRD.md(功能与优先级唯一事实来源)、LAUNCH.md(运营/SEO 基线) |
| 当前状态 | V1.0 前后端已完成开发、联调中;Docker/CI 就绪;QA 验收通过 18+ 任务 |
---
## 0. 版本总览
| 版本 | 时间 | 主题 | 核心交付 |
|---|---|---|---|
| **V1.0 上线版** | 当前(2026-08) | 跑通 MVP 商业闭环 | PRD P0 全量上线:生成 + 权益 + 模拟支付 + AI 专区 |
| **V1.1 增长版** | 1 个月内 | 流量与留存 | /palette SEO 页、历史记录、批量生成、导出优化、埋点看板、P1 补全 |
| **V1.2 账号版** | 2~3 个月 | 用户资产与生态 | 账号体系 + 云端同步、素材社区、代理管理系统 |
| **V2.0 平台版** | 半年 | 商业平台化 | 图纸交易市场、PWA 移动端、多语言、真实支付 |
优先级定义沿用 PRD:**P0** = 本版本必须上线;**P1** = 本版本内争取;**P2** = 观察数据后进入后续版本。
---
## 1. V1.0 上线版(当前)
### 1.1 目标
把 PRD 第 9 章定义的 MVP(P0)完整落地上线,验证三件事:图纸质量够不够好、付费意愿存不存在、AI 功能有没有吸引力。上线即可开始积累真实转化数据,为 V1.1 决策提供依据。
### 1.2 范围确认清单(对齐 PRD 9.1)
**已就绪(开发 + QA 已验收,18+ 任务通过)**
| 模块 | 验收项 | 状态 |
|---|---|---|
| 图纸生成 | 图片上传(JPG/PNG/WebP,≤10MB,拖拽 + 点击) | ✅ |
| | 参数设置(格数 48/64/80/96、色数 16/24/32/40、去背景、背景色) | ✅ |
| | 核心算法(4× 采样 → 众数量化 → k-means++ → MARD 色板 LAB 匹配) | ✅ |
| | 图纸预览(豆圆 + 色号 + 每 5 格加粗 + 每 10 格标号 + 缩放) | ✅ |
| | 备料清单(总颗数、色数、分色用量、多备 10%) | ✅ |
| 下载解锁 | 未解锁拦截进入兑换弹窗;解锁后输出 PNG(图纸 + 备料单) | ✅ |
| | 预览免费、仅下载消耗权益;同一图纸凭 downloadGrant 重复下载不扣费 | ✅ |
| 权益体系 | 兑换码兑换 `/api/codes/redeem`、下载扣减 `/api/codes/consume`、AI 扣减 `/api/chibi/generate` | ✅ |
| | 权益存 localStorage(键 `perler-download-code`)、顶部常驻剩余次数 | ✅ |
| 订单支付 | 三档个人套餐下单 `/api/orders`、模拟支付回调、支付成功自动 redeem | ✅ |
| | 支付回调幂等、耗尽返回 402、无效码返回 404 | ✅ |
| AI 拼豆 | 5 大类 × 3 细分、格数/色数参数、生成即扣 1 次权益 | ✅ |
| 页面 | 首页、/chibi 页、兑换弹窗、订单弹窗、订单结果弹窗 | ✅ |
| 工程 | Docker 化部署、CI 就绪、CORS 白名单、`tsc --noEmit` 通过、单测 36/36 | ✅ |
**剩余阻塞项(上线前必须清空)**
| # | 阻塞项 | 说明 | 责任方 |
|---|---|---|---|
| 1 | AI 生成接入真实模型 | E2E 报告显示 `/api/chibi/generate` 当前返回 mock 占位 PNG(长度 262);需接入真实图片生成模型代理,并保留失败不扣费逻辑 | 后端 |
| 2 | 前端联调收尾 | 前端真实场景全链路走查:上传 → 生成 → 预览 → 兑换 → 下载;含移动端基本可用 | 前端 |
| 3 | 上线部署验证 | Docker Compose 全量冷启动、健康检查、自动重启、数据库备份、监控告警生效 | 后端/运维 |
| 4 | 埋点 P0 事件确认 | PRD 8.3 中 P0 事件(上传/生成/预览/下载/兑换/订单/AI 选择与生成)真实上报可用 | 前端 |
| 5 | 用户协议与版权声明 | PRD 风险 #5:用户协议声明上传图片责任归属、图纸仅供个人手作参考 | PM/法务 |
| 6 | 生成接口并发压测 | 桌面端 P50 ≤ 5s、移动端 ≤ 8s;确认压测下接口稳定性与超时兜底 | 后端 |
| 7 | 首屏性能确认 | LCP < 2.5s(算法库代码分割 + 静态资源强缓存) | 前端 |
### 1.3 上线标准 Checklist
**验收**
- [ ] 两条核心链路全通:图片生成链路(上传 → 参数 → 预览免费 → 兑换解锁 → 高清下载)与 AI 链路(选类 → 描述 → 生成扣 1 次 → 预览 → 解锁下载)
- [ ] QA 回归 18+ 任务全绿,无 P0/P1 级缺陷残留
- [ ] 错误路径全通:无效兑换码 404、次数耗尽 402、支付回调幂等、重复下载不重复扣费
- [ ] 单测与类型检查通过(`tsc --noEmit`、单测 36/36)
**性能**
- [ ] 图纸生成耗时 P50 ≤ 5s(桌面端)、≤ 8s(移动端)
- [ ] 首页首屏 LCP < 2.5s
- [ ] 高清下载成功率 ≥ 99%
- [ ] 压测结论记录:并发下单/兑换/生成无 DB 锁死、无 5xx 雪崩
**安全**
- [ ] 全站 HTTPS,CORS 白名单(非 `*`)且带 `Vary: Origin`
- [ ] 兑换码不可枚举:输入校验 + 服务端核销日志 + 高频 redeem 风控阈值
- [ ] 输入注入防护(图片格式/大小校验、API 参数白名单)
- [ ] 密钥与数据库不落仓库,Docker 环境变量注入
### 1.4 成功指标(对齐 PRD 8.2,首月基线)
| 类别 | 指标 | 目标值 |
|---|---|---|
| 北极星 | 周有效解锁次数 | 每周 ≥ 30 次(首月爬坡) |
| 转化 | 访问 → 生成转化率 | ≥ 40% |
| 转化 | 生成 → 兑换解锁转化率 | ≥ 3% |
| 转化 | 兑换 → 再次消费转化率 | ≥ 20% |
| 下载 | 高清下载成功率 | ≥ 99% |
| AI | chibi 生成占权益消耗比 | ≥ 30% |
| 质量 | 图纸平均色差 | ≤ 2.0(ΔE,LAB) |
| 体验 | 兑换全流程成功率(模拟支付 → redeem → 扣减 → 下载) | ≥ 95% |
| 稳定性 | 全链路无致命错误率 | 100% |
### 1.5 依赖项
无外部依赖。V1.0 全部建立在现有前后端 + Docker/CI 之上,仅剩第 1.2 节阻塞项收尾。
---
## 2. V1.1 增长版(1 个月内)
### 2.1 目标
用 SEO 长尾页和留存功能放大 V1.0 验证过的核心链路,把埋点数据变成可看的运营看板。不做账号,所有新功能保持本地优先。
### 2.2 核心功能列表
| # | 功能 | 说明 | 优先级 |
|---|---|---|---|
| 1 | 色号对照页 /palette | 纯内容页:MARD 8 系色板全景、每色 HEX/色名/近似实拍、色号换算说明。吃「拼豆色号表」长尾搜索词(LAUNCH 2.1),挂 JSON-LD `WebPage` schema | P0 |
| 2 | 埋点看板上线 | 埋点事件(PRD 8.3 全部)上报可用;搭建看板:转化漏斗(访问 → 上传 → 生成 → 兑换 → 下载)、渠道来源、套餐分布、AI 分类分布;T+1 数据可用 | P0 |
| 3 | 历史记录(本地版) | 生成/下载记录存 localStorage(含参数、缩略图、downloadGrant),支持重新下载与复用参数。无需登录,与 V1.2 账号同步无缝衔接 | P0 |
| 4 | 批量生成 | 一次上传多图或一个图片文件夹,批量出图并打包下载 ZIP;含批量失败重试与单张进度展示 | P1 |
| 5 | 图纸导出优化 | 导出选项:纸张尺寸(A4/A3 等)、网格开关、色号标注开关、纯备料单、无水印版本;ZIP 批量导出 | P1 |
| 6 | P1 功能补全 | 订单查询(`GET /api/orders?orderNo=` 在订单弹窗内展示支付状态轮询)、AI 风格预览对比图、兑换码高频风控规则落地 | P1 |
| 7 | 兑换引导优化 | 根据看板数据优化兑换弹窗:首单体验包钩子位置、未解锁用户回访提醒 | P2 |
### 2.3 成功指标
| 指标 | 目标值(V1.1 内) |
|---|---|
| /palette 页自然搜索月 UV | ≥ 2000,占全站自然流量 ≥ 20% |
| /palette 页 → 首页跳转率 | ≥ 15%(验证 SEO 长尾导流) |
| 埋点事件上报成功率 | ≥ 99%,看板 T+1 可用率 ≥ 95% |
| 历史记录使用率 | 回访用户中点击历史记录 ≥ 30% |
| 次日回访率 | 较 V1.0 提升 ≥ 5pp(历史记录 + 看板驱动的留存优化) |
| 批量生成成功率 | ≥ 98%,单张平均耗时 ≤ 5s |
| 导出优化后下载成功率 | ≥ 99.5%(导出选项不引入新失败) |
### 2.4 依赖项
- V1.0 上线并积累至少 2 周真实数据(埋点看板据此校准漏斗基线)
- /palette 依赖已内置的 MARD 色板数据源(前端算法已有),需补充色名/HEX/实拍素材
- 批量生成依赖后端新增 ZIP 打包接口或前端纯前端打包(jszip 类方案)
- 埋点看板需确认存储方案(自建轻量统计表 vs 第三方,倾向自建,复用现有 SQLite/Postgres)
---
## 3. V1.2 账号版(2~3 个月)
### 3.1 目标
把本地权益升级为云端资产,把一次性用户沉淀为可识别用户;开启素材社区和代理两条生态线。核心解决 PRD 风险 #3(换设备丢权益客诉)与 P2 代理需求。
### 3.2 核心功能列表
| # | 功能 | 说明 | 优先级 |
|---|---|---|---|
| 1 | 账号体系 | 手机号验证码登录(短信服务);Token 会话;登录后权益自动合并(云端为准) | P0 |
| 2 | 云端同步 | 权益、历史记录、收藏同步到服务端;换设备登录即恢复;跨设备权益使用实时扣减 | P0 |
| 3 | 素材社区 | 用户上传自用图纸公开分享:图纸页 + 作者页 + 分类/搜索 + 收藏;社区页挂 SEO 关键词「拼豆模板」(LAUNCH 2.1 高难度词) | P0 |
| 4 | 代理管理系统 | 代理自助充值(代理三档套餐 ¥139/¥299/¥499)、订单查询、名下兑换码库存与核销记录、批量生成兑换码/口令(PRD P2 补全) | P0 |
| 5 | 内容安全 | 社区上传图片审核(敏感内容过滤 + 人工抽检)、用户举报与下架 | P1 |
| 6 | 移动端体验强化 | 基于 V1.1 埋点数据优化移动端布局、上传压缩、弱网兜底 | P1 |
### 3.3 成功指标
| 指标 | 目标值(V1.2 内) |
|---|---|
| 手机号登录转化率 | 老用户(兑换过权益)≥ 30%,新用户 ≥ 8% |
| 云端同步成功率 | ≥ 99.5%;「换设备丢权益」类客诉降为 0 |
| 跨设备权益恢复满意度 | 同步后权益无损率 100%(以服务端账本为准) |
| 社区内容量 | 月新增分享图纸 ≥ 500 张,活跃分享用户 ≥ 100 人 |
| 社区引流 | 社区带来的自然访问占全站 ≥ 15%(吃「拼豆模板」搜索词) |
| 代理自助转化 | 代理下单自助完成率 ≥ 80%;代理渠道营收占总营收 ≥ 30% |
| 代理管理 | 兑换码库存查询/批量生成的代理使用率 ≥ 70% |
### 3.4 依赖项
- 账号体系依赖短信服务商接入与实名合规;Token 安全设计(刷新 + 风控)
- 云端同步依赖数据库迁移(用户表、同步账本表、历史记录表)与既有 localStorage 数据升级路径
- 素材社区依赖对象存储/CDN、图片缩略图处理、内容审核通道
- 代理管理依赖订单系统扩展(代理套餐下单)与兑换码批量生成能力
- V1.1 的本地历史记录需设计向上兼容的数据迁移
---
## 4. V2.0 平台版(半年)
### 4.1 目标
从「工具」升级为「平台」:图纸可交易、移动端可触及、语言可扩展。接入真实支付,把 V1.0 的模拟支付替换为正式渠道。平台化意味着用户既是消费者也是创作者。
### 4.2 核心功能列表
| # | 功能 | 说明 | 优先级 |
|---|---|---|---|
| 1 | 拼豆图纸交易市场 | 图纸商城:作者定价上架、买家按图纸或按权益购买、作者分润结算;接真实支付(微信/支付宝官方商户) | P0 |
| 2 | 移动端 App(PWA 先行) | 先做 PWA(离线缓存核心算法、可安装、推送预告);验证移动端数据后再评估原生壳 | P0 |
| 3 | 真实支付对接 | 替换模拟支付:微信/支付宝官方商户、退款、对账;保留兑换码链路不变 | P0 |
| 4 | 多语言 | i18n 重构 + 英文站;英文版投放海外(拼豆在欧美是成熟品类,SEO 词与中文市场几乎无竞争) | P1 |
| 5 | 创作者体系 | 作者认证、粉丝关注、作品集、数据看板(曝光/销量/收益) | P1 |
| 6 | 平台治理 | 侵权/盗图投诉处理、交易仲裁、作者保证金与评分 | P1 |
### 4.3 成功指标
| 指标 | 目标值(V2.0 上线 2 个月内) |
|---|---|
| 交易市场 | 月 GMV ≥ ¥10,000;图纸商品数 ≥ 300;交易转化率 ≥ 2% |
| 创作者 | 月活作者 ≥ 30 人;头部作者月收益 ≥ ¥500 |
| PWA | 移动端访问占比 ≥ 40%;PWA 安装率(可安装曝光 → 安装)≥ 5% |
| 真实支付 | 支付成功率 ≥ 95%;退款/对账差错率为 0 |
| 多语言 | 英文站自然访问占全站 ≥ 10%;英文版兑换转化 ≥ 1% |
| 整体 | 周有效解锁次数较 V1.0 增长 ≥ 5 倍(作为北极星收敛验证) |
### 4.4 依赖项
- 交易市场依赖 V1.2 账号体系(卖家身份)与素材社区内容沉淀,以及真实支付渠道完成签约
- PWA 依赖 service worker 离线策略设计、算法库体积优化
- 多语言依赖 i18n 重构完成,英文内容(说明文案、FAQ、SEO)准备
- 平台治理依赖投诉与仲裁流程设计,涉及客服人力
---
## 5. 时间线
```
2026-08 2026-09 2026-10~11 2027-02
┌───────────┐ ┌────────────┐ ┌─────────────────────┐ ┌──────────────┐
│ V1.0 │ │ V1.1 │ │ V1.2 │ │ V2.0 │
│ 上线版 │ │ 增长版 │ │ 账号版 │ │ 平台版 │
│ │ │ │ │ │ │ │
│ 生成+权益 │ │ /palette │ │ 手机号登录+云端同步 │ │ 图纸交易市场 │
│ 模拟支付 │ │ 历史记录 │ │ 素材社区 │ │ PWA+移动端 │
│ AI专区 │ │ 批量生成 │ │ 代理管理系统 │ │ 真实支付 │
│ 埋点P0 │ │ 导出优化 │ │ 内容安全 │ │ 多语言 │
│ │ │ 埋点看板 │ │ 移动端体验强化 │ │ 创作者体系 │
│ │ │ P1补全 │ │ │ │ │
└───────────┘ └────────────┘ └─────────────────────┘ └──────────────┘
▲ ▲ ▲ ▲
│ │ │ │
清空7项阻塞 依赖首月数据校准 依赖账号+存储+审核 依赖账号+社区+支付签约
18+QA任务全绿 漏斗基线 与本地数据迁移 与i18n重构
里程碑出口(Gate):
V1.0 → V1.1:QA 全绿 + 上线后≥2周真实数据(访问→生成≥40% 确认)
V1.1 → V1.2:看板漏斗稳定 + /palette 流量验证 SEO 有效 + 复购≥20% 确认
V1.2 → V2.0:账号渗透≥30% + 社区内容月增≥500 + 代理渠道跑通
```
**版本节奏说明**:四个版本为先后依赖关系,但每版内部功能按优先级弹性裁剪。若 V1.0 数据未达转化基线(访问 → 生成 < 40% 或兑换率 < 3%),优先在 V1.1 投入流量与转化优化而非机械推进功能排期;若 V1.1 埋点看板显示 AI 占比低于 30%,V1.2 需加投 AI 专区运营。指标数据是版本间推进与回退的唯一裁决依据。
---
## 6. 附:与 PRD 优先级映射
| 路线图版本 | 承接的 PRD 优先级 | 说明 |
|---|---|---|
| V1.0 | P0 全量 | 即 PRD 9.1 MVP 范围 |
| V1.1 | P1 全量 + P2 局部(历史记录本地版先行) | 埋点、订单查询、风格预览、风控、本地历史 |
| V1.2 | P2 全量 | 账号体系、云端同步、历史记录云端化、代理管理、素材社区 |
| V2.0 | 新增范围(PRD 未覆盖) | 交易市场、PWA、多语言、真实支付,PRD 需在进入前增补章节 |