Canvas（infinitecanvas）功能文档¶
代码：
src/infinitecanvas/。端口 5176 /canvas.localhost。
1. 定位¶
图现 C 端：品牌首页、无限画布项目、垂直生图工作台（热拍/主图/详情/换景/复刻/模特等）、资产库、账户计费、代理推荐落地绑定。
2. 路由¶
| 路径 | 页面 | 鉴权 | 用途 |
|---|---|---|---|
/ |
HomePage | 公开 | 首页与功能入口 |
/r/:referralCode |
ReferralLandingPage | 公开 | 推广落地：记点击，引导登录绑定 |
/canvas |
CanvasPage | 登录 | 无限画布编辑器 |
/hot-shoot |
HotShootPage | 登录 | 热拍工作台 |
/main-image |
MainImagePage | 登录 | 主图 |
/detail-image |
DetailImagePage | 登录 | 详情图 |
/scene-replace |
SceneReplacePage | 登录 | 换景 |
/hot-replicate |
HotReplicatePage | 登录 | 爆款复刻 |
/model-gen |
ModelGenPage | 登录 | 模特生成 |
/product-view |
ProductViewPage | 登录 | 产品视图 |
/single-model |
SingleModelPage | 登录 | 单人换模特 |
/double-model |
DoubleModelPage | 登录 | 双人换模特 |
/hot-template |
HotTemplatePage | 登录 | 热门模板 |
/assets-library |
AssetsLibraryPage | 登录 | 资产库（按 task-types 分模块） |
/account |
AccountPage | 登录 | 账户：配额/订单/消费/流水/购买套餐 |
* |
→ / |
— |
3. 核心能力¶
3.1 认证¶
短信验证码登录（/api/auth/*）；未登录访问受保护路由触发登录引导（LoginPromptProvider / ProtectedRoute）。
3.2 画布项目¶
- 多项目 + 单层文件夹；文档 JSON 持久化
- 乐观锁
revision；缩略图 object_key - 节点：图片/文本/连线；生成、上传、RunningHub
- 资产预签名、resolve-urls、proxy-image
3.3 垂直工作台¶
- 主图
/main-image、详情/detail-image：品类 → 风格 → 选模板套 →（可选）一键/复刻模式；自定义提示词产品/材质必填；调用batch-generate（task_type=main_image|detail_image） - 其他工作台（热拍/换景/复刻/模特等）：仍按各自选型（子类/面料/HotStyle 等），预览 Prompt，
generate或batch-generate - 目录数据来自
/user/catalog/*（主图/详情用styles+image-templates）
3.4 资产库¶
跨项目复用上传素材；模块列表来自 GET /user/task-types。
3.5 账户与计费¶
浏览方案、下单、查看配额/消费/账本（/billing/*）。支付回调后刷新配额。
3.6 推广绑定¶
落地页拉取 GET /landing/{code}；登录后 POST .../bind 永久绑定代理；后续下单可享受代理优惠。
4. 业务规则摘要¶
- 生图前校验配额/并发（以后端错误为准）
- 主图/详情模板依赖 Admin 配置的 品类×风格（及模板套）；虚拟影棚等仍可用子类×面料
- 复刻模式须上传参考图；一键与复刻共用同一套选型
- 画布保存冲突提示用户刷新/合并（409）
- 删除画布项目不删除资产库条目
5. 参考¶
architecture/infinitecanvas.md、canvas-image-tools.md、ai-image-generation-system-design.md