Files
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

16 KiB
Raw Permalink Blame History

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 需在进入前增补章节