系统架构

    ┌──────────────────────────────────────┐
    │      终端用户  /  管理员  /  运营    │
    └──────┬──────────────┬────────────┬───┘
           │ H5           │ PC Web     │ PC Web
           ▼              ▼            ▼
  ┌──────────────┐ ┌──────────────┐ ┌─────────────┐
  │    pf-app    │ │  pf-editor   │ │  pf-manage  │
  │  Quasar H5   │ │  Quasar PC   │ │  Naive UI   │
  │  端口 8000   │ │  端口 9000   │ │  端口 9527  │
  └──────┬───────┘ └──────┬───────┘ └──────┬──────┘
         │ HTTP / Token   │ HTTP / Token   │ HTTP / Token
         └────────────────┼────────────────┘
                          ▼
           ┌────────────────────────────┐
           │        pf-service          │
           │   Bun + Elysia (TS)        │
           │   端口 3000                │
           │   ┌──────────────────────┐ │
           │   │ Routes:              │ │
           │   │  /pf-manage/*        │ │
           │   │  /pf-editor/*        │ │
           │   │  /pf-app/*           │ │
           │   │  /shared/*           │ │
           │   ├──────────────────────┤ │
           │   │ Jobs:                │ │
           │   │  orderTemplate-      │ │
           │   │  CompositionJob     │ │
           │   └──────────────────────┘ │
           └──┬──────┬──────┬────────┬──┘
HTTP /detect  │      │      │        │
              ▼      ▼      ▼        ▼
  ┌─────────────────┐ ┌──────────┐ ┌──────────┐ ┌─────────────┐
  │ pf-face-service │ │  MySQL   │ │  Redis   │ │   MinIO     │
  │ FastAPI/SCRFD   │ │ 8.0 +    │ │  6.x     │ │  S3 兼容    │
  │ 端口 3010       │ │ Drizzle  │ │          │ │  对象存储   │
  └─────────────────┘ └──────────┘ └──────────┘ └─────────────┘

src/routes/projects/
├── pf-app/        # 用户端接口（orderTemplate 提交、订单查询...）
├── pf-editor/     # 编辑器接口（模板创建、模板素材、素材库读取...）
├── pf-manage/     # 管理后台接口（auth/users/roles/menus/orders/审核/相册管理...）
└── shared/        # 跨端共用（OSS 上传、字体库、背景库、人脸检测代理）

pf-editor 拖拽出版
  → 序列化为 sceneJson（Leafer 节点树）
  → POST /pf-editor/templates
  → templates 表落库
  → 关联 album_templates / category / tags
  → 上架后用户端 pf-app 可见

pf-manage 上传背景 / 字体
  → POST /shared/oss/upload   ← S3 预签名 / 直传 MinIO
  → POST /shared/background-library
  → POST /shared/font-library
  → 全局 (userId=0) 或个人素材入库
  → 用户端 / 编辑器侧均可拉取

pf-app 选相册/模板
  → 分片上传素材到 MinIO（前端裁剪/旋转后再传）
  → 可选：POST /shared/face/detect 获取人脸框 → 自动避脸裁剪
  → 用户编辑文字、调整位置
  → POST /pf-app/order-template-submissions
    body: { orderNo, items: [{ templateId, userUploads, userTexts, sceneJson }] }
  → 入 order_template_submissions / order_template_submission_items
  → 状态 = pending

orderTemplateCompositionJob (每 N 秒轮询)
  → 取一条 status=pending 的 submission
  → 标记 processing
  → 遍历明细 item:
      合并 sceneJson + userUploads + userTexts
      → 启动/复用 Puppeteer 实例
      → 把场景渲染到 headless Chrome 页面
      → 截图 / 导出 PNG/PDF
      → 上传 MinIO 得到 composedImageUrls
  → 全部成功 → submission.status = completed
  → 任一失败 → item.failReason 记录 / submission.status = failed

pf-manage 列表查看 status=completed 的 submission
  → 预览 composedImageUrls
  → 审核通过：标记可下载 / 推送至打印队列
  → 审核驳回：回写状态 → 通知用户端 → 用户重新提交

src/
├── pages/         # 路由页面（IndexPage、AlbumTemplatesPage、TemplateListPage...）
├── layouts/       # 布局
├── components/    # 业务组件（ImageCropper, ImagePreview, TemplateCard, workshop/*）
├── composables/   # 组合式函数（编辑器 useXxx, fontPreload）
├── stores/        # Pinia（pinia-plugin-persistedstate 持久化）
├── api/           # 与 pf-service 的 HTTP 调用
├── boot/          # Quasar boot 文件（i18n、axios、router 守卫）
├── i18n/          # 国际化
└── utils/         # 通用工具