路线图

版本约定

图模工坊采用语义化版本：

• MAJOR — 协议级变更（sceneJson schema / 合成结果格式 / 数据库不向下兼容）
• MINOR — 新模块 / 新接口 / 向下兼容的能力增强
• PATCH — Bugfix / 性能优化 / 文档

当前版本：0.0.1（仓库 package.json），处于早期可用、持续演进阶段。

已落地能力（截至 2026/09）

• ✅ 七应用全栈：pf-app / pf-editor / pf-manage / pf-service / pf-compose-service / pf-face-service(Rust) / pf-download
• ✅ Leafer 渲染引擎 + sceneJson 协议三端共用
• ✅ 数据库迁移到 PostgreSQL 16+（Drizzle 0.45 + postgres.js，26 张表，jsonb / GIN / 部分唯一索引）
• ✅ 多租户隔离：业务表普遍带 tenantId + 复合索引；RBAC（租户/用户/角色/菜单/按钮）
• ✅ 合成渲染解耦为独立微服务：pf-compose-service（Bun + Puppeteer 多 Worker 进程池，自行入库 MinIO）
• ✅ 合成 Job 工程化：FOR UPDATE SKIP LOCKED 多实例抢占、并发 3、指数退避重试、僵尸恢复
• ✅ 合成状态 / 下载状态解耦 + 桌面下载客户端（队列/重试/去重/自动轮询/离线告警）
• ✅ 人脸服务 Rust 重写：Axum + ORT，EXIF 姿态矫正、32 步长对齐、双线性缩放、超参外置
• ✅ 图片管道：imgproxy 动态 WebP + Nginx 边缘磁盘缓存（pf_img_cache / pf_raw_cache，30 天）
• ✅ 前端体验：乐观上传占位 + 并发 3 队列、直传重试/取消、模板面板无限滚动 + 竞态令牌、画布落图占位抗跳帧、瞬态节点统一管理
• ✅ pf-app 完整 Material Design 3 设计系统
• ✅ 商品体系：店铺 / 商品 / 规格（templateRules / albumRules）+ 按规格批量建单
• ✅ MinIO 预签名直传（purpose 白名单）+ 同源 /storage 代理
• ✅ JWT 鉴权 + 订单一次性访问令牌；soybean-admin 后台基底（Naive UI）
• ✅ Bun monorepo + oxlint / oxfmt + Caddy 开发网关 + OpenSpec 规范化流程
• ✅ 全栈自动化部署：WSL Docker + FRP 内网穿透 + 阿里云 Nginx，PowerShell 一键编译/同步/发布

短期规划（v0.1.0）

聚焦”开箱即用度”与”生产可观察性”：

• ⏳ 一键依赖编排 — 把 PostgreSQL / Redis / MinIO 也纳入示例 compose，降低起步门槛
• ⏳ 种子数据完善 — 更丰富的示例相册 / 商品 / 样板模板
• ⏳ Swagger 接口覆盖 — 所有路由补全 schema
• ⏳ 基础指标埋点 — pending 队列、合成耗时、失败率、缓存命中率
• ⏳ imgproxy 签名 — 生产环境启用 key/salt，收紧未签名变换
• ⏳ 结构化日志串联 — 按请求 / 任务串 traceId（winston 已就位）

中期规划（v0.2.x – v0.3.x）

围绕”批量场景”与”商业化诉求”：

• ⏳ 合成任务队列模式 — Redis Streams 取代轮询，延迟更低（SKIP LOCKED 抢占已就位）
• ⏳ 合成服务弹性伸缩 — 按队列长度自动扩 Worker / 副本
• ⏳ 模板版本控制 — 历史快照 / Diff / 一键回滚
• ⏳ 跨端草稿同步 — H5 编辑、PC 接续编辑（云端草稿表）
• ⏳ 背景库 / 字体库体验升级 — 标签、上传审核流、用量统计
• ⏳ 下载客户端增强 — 多平台、增量同步、批量归档策略

中长期方向（v0.4+）

• ⏳ GPU 渲染引擎选项 — 远程 Skia / sharp / 自研渲染替代 Puppeteer，吞吐量翻倍
• ⏳ 多模态素材 — 视频帧抽取、AI 抠图、AI 文案
• ⏳ 打印设备 SDK 适配 — 与主流打印机/相册机对接，跳过中间格式
• ⏳ 海外多语言 / RTL — i18n 已具备框架，需要补语种与字体
• ⏳ SaaS 化运营后台 — 按租户的用量 / 计费 / API 限流

暂不规划

为聚焦核心交付，以下能力当前版本明确不做：

• ❌ AI 自动设计模板（生成式 AI 出版）
• ❌ 用户自定义字体上传
• ❌ 移动端原生 APP（iOS / Android）
• ❌ 复杂数据安全合规（GDPR / 等保等待后续专门版本）
• ❌ 复杂工作流引擎（多级审批 / BPMN）

反馈与贡献

• 业务诉求：请在仓库 Issues 中以”功能需求”标签提出，描述场景 + 期望产出
• Bug：附最小复现路径 + 日志
• PR：先 issue 对齐方案，再实现；遵循 AGENTS.md 代码规范
• 路线图本身是活文档，每个 MINOR 发布前会重排优先级

路线图反映方向而非承诺；具体 ETA 以仓库 milestone 为准。