- 前端: 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)
16 KiB
16 KiB
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 需在进入前增补章节 |