版本约定
图模工坊采用语义化版本：
- MAJOR — 协议级变更（sceneJson schema / 合成结果格式 / 数据库不向下兼容）
- MINOR — 新模块 / 新接口 / 向下兼容的能力增强
- PATCH — Bugfix / 性能优化 / 文档
当前版本：0.0.1（仓库 package.json），处于早期可用阶段。
已落地能力（截至 2026/05）
- ✅ 五大应用全栈：pf-app / pf-editor / pf-manage / pf-service / pf-face-service
- ✅ Leafer 渲染引擎 + sceneJson 协议三端共用
- ✅ Drizzle Schema 20+ 张表（用户、模板、相册体系、订单、提交、素材库）
- ✅ MinIO 预签名直传 + 分片上传
- ✅ Puppeteer 后台合成 Job + 提交状态机
- ✅ InsightFace SCRFD 人脸框检测 + faceSafe 节点
- ✅ JWT 鉴权 + soybean-admin 后台基底
- ✅ Bun monorepo + oxlint / oxfmt 工程规范
短期规划（v0.1.0）
聚焦”开箱即用度”和”生产可观察性”：
- ⏳ Docker Compose / Helm 模板 — 一键起依赖、三端、API、Worker
- ⏳ 种子数据完善 — 默认管理员 / 5 个示例相册 / 20 张样板模板
- ⏳ Swagger 接口覆盖 — 所有
/pf-app /pf-editor /pf-manage路由补 schema - ⏳ 基础指标埋点 — pending 队列、合成耗时、失败率
- ⏳ 结构化日志 — pino 替换 console，按请求 / 任务串 traceId
中期规划（v0.2.x – v0.3.x）
围绕”批量场景”和”商业化诉求”：
- ⏳ 合成进程池 — Worker 多进程、
SELECT FOR UPDATE SKIP LOCKED抢占 - ⏳ 任务队列模式 — Redis Streams 取代轮询，延迟更低
- ⏳ PC 客户端（Quasar + Electron） — 批量下载、本地归档、推送打印设备
- ⏳ 模板版本控制 — 历史快照 / Diff / 一键回滚
- ⏳ 跨端草稿同步 — H5 编辑、PC 接续编辑
- ⏳ 背景库 / 字体库管理体验升级 — 标签、上传审核流、用量统计
- ⏳ 多租户隔离 — 同一套 pf-service 服务多个商户
中长期方向（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 为准。
