{
  "schema_version": 1,
  "diagram_type": "architecture",
  "meta": {
    "title": "MiragenFlow 全平台架构",
    "locale": "zh-CN",
    "output": "miragenflow-architecture.html",
    "quality_profile": "showcase",
    "views": [
      {
        "id": "request-and-auth",
        "label": "请求与身份",
        "focus": ["user-client", "admin-client", "contracts", "api", "security"],
        "note": "从两个前端入口沿共享契约进入 API，并经过会话、权限与 CSRF 校验。"
      },
      {
        "id": "task-execution",
        "label": "任务执行",
        "focus": ["api", "store", "queue", "worker", "provider", "objects"],
        "note": "创建任务时预留余额，随后经 Outbox、队列、租约和供应商重试完成生成。"
      },
      {
        "id": "events-and-persistence",
        "label": "事件与持久化",
        "focus": ["store", "events", "objects", "side-workers", "user-client", "admin-client"],
        "note": "领域状态提交后发布可过滤事件，资产、消息和 WebDAV 由后台作业继续处理。"
      }
    ]
  },
  "components": [
    {
      "id": "user-client",
      "type": "frontend",
      "label": "用户端",
      "sublabel": "React · web/",
      "tag": "工作台 / 画布 / 资产",
      "pos": [30, 150],
      "size": [180, 92]
    },
    {
      "id": "admin-client",
      "type": "frontend",
      "label": "管理台",
      "sublabel": "React + Redux · admin/",
      "tag": "权限化运营界面",
      "pos": [30, 390],
      "size": [180, 92]
    },
    {
      "id": "contracts",
      "type": "backend",
      "label": "共享契约",
      "sublabel": "packages/contracts",
      "tag": "任务 / 会话 / 事件类型",
      "pos": [240, 270],
      "size": [180, 92]
    },
    {
      "id": "api",
      "type": "backend",
      "label": "HTTP API",
      "sublabel": "http.ts · /api/v1",
      "tag": "用户与管理路由统一分发",
      "pos": [465, 266],
      "size": [190, 100]
    },
    {
      "id": "security",
      "type": "security",
      "label": "身份与权限",
      "sublabel": "JWT · CSRF · MFA",
      "tag": "角色 Scope 与会话族",
      "pos": [465, 90],
      "size": [190, 92]
    },
    {
      "id": "store",
      "type": "database",
      "label": "领域状态与账本",
      "sublabel": "Store · 持久化",
      "tag": "余额 / 任务 / 审计 / 配置",
      "pos": [700, 266],
      "size": [200, 100]
    },
    {
      "id": "queue",
      "type": "messagebus",
      "label": "任务队列与 Outbox",
      "sublabel": "Memory / Redis · Outbox",
      "tag": "优先级 · 租约 · 死信",
      "pos": [700, 460],
      "size": [200, 92]
    },
    {
      "id": "worker",
      "type": "backend",
      "label": "任务 Worker",
      "sublabel": "租约 · 重试 · 对账",
      "tag": "Attempt 与断路器",
      "pos": [930, 456],
      "size": [180, 100]
    },
    {
      "id": "provider",
      "type": "external",
      "label": "外部供应商",
      "sublabel": "OpenAI 兼容端点",
      "tag": "安全出站 · 超时分类",
      "pos": [1140, 456],
      "size": [180, 100]
    },
    {
      "id": "objects",
      "type": "cloud",
      "label": "暂存对象与资产",
      "sublabel": "staging · objects",
      "tag": "生成结果落地",
      "pos": [1140, 270],
      "size": [180, 92]
    },
    {
      "id": "events",
      "type": "messagebus",
      "label": "任务事件流",
      "sublabel": "WS · 游标回放",
      "tag": "去重与公开投影",
      "pos": [700, 90],
      "size": [200, 92]
    },
    {
      "id": "side-workers",
      "type": "backend",
      "label": "后台作业",
      "sublabel": "消息 · WebDAV · GC",
      "tag": "恢复与定时维护",
      "pos": [930, 660],
      "size": [210, 100]
    }
  ],
  "boundaries": [
    {
      "kind": "region",
      "label": "浏览器端",
      "wraps": ["user-client", "admin-client"],
      "pad": 28
    },
    {
      "kind": "region",
      "label": "MiragenFlow 服务端",
      "wraps": ["api", "security", "store", "queue", "worker", "events", "side-workers"],
      "pad": 34
    },
    {
      "kind": "security-group",
      "label": "受保护写路径",
      "wraps": ["api", "security", "store", "queue"],
      "pad": 18
    },
    {
      "kind": "region",
      "label": "外部边界",
      "wraps": ["provider", "objects"],
      "pad": 28
    }
  ],
  "connections": [
    { "id": "user-contracts", "from": "user-client", "to": "contracts", "label": "页面请求与类型", "variant": "emphasis", "labelAt": [210, 256] },
    { "id": "admin-contracts", "from": "admin-client", "to": "contracts", "label": "管理请求与类型", "variant": "emphasis", "labelAt": [210, 376] },
    { "id": "contracts-api", "from": "contracts", "to": "api", "label": "REST /api/v1", "labelAt": [442, 250] },
    { "id": "api-security", "from": "api", "to": "security", "label": "令牌 / CSRF / Scope", "variant": "security", "fromSide": "top", "toSide": "bottom" },
    { "id": "api-store", "from": "api", "to": "store", "label": "事务与领域命令", "labelAt": [678, 400] },
    { "id": "api-queue", "from": "api", "to": "queue", "label": "任务 + Outbox", "variant": "dashed", "fromSide": "bottom", "toSide": "top" },
    { "id": "queue-worker", "from": "queue", "to": "worker", "label": "租约派发", "variant": "emphasis", "labelAt": [915, 590] },
    { "id": "worker-provider", "from": "worker", "to": "provider", "label": "HTTPS 生成 / 重试" , "variant": "emphasis", "labelAt": [1125, 430]},
    { "id": "worker-objects", "from": "worker", "to": "objects", "label": "b64 / URL → 对象", "variant": "dashed", "fromSide": "top", "toSide": "bottom" },
    { "id": "worker-store", "from": "worker", "to": "store", "label": "结算与账本", "fromSide": "top", "toSide": "bottom" },
    { "id": "worker-events", "from": "worker", "to": "events", "label": "追加任务事件", "fromSide": "top", "toSide": "bottom" },
    { "id": "api-events", "from": "api", "to": "events", "label": "WS / 游标回放", "variant": "dashed" },
    { "id": "side-provider", "from": "side-workers", "to": "provider", "label": "WebDAV / 消息外部调用", "variant": "dashed", "fromSide": "right", "toSide": "bottom" }
  ],
  "cards": [
    {
      "dot": "cyan",
      "title": "入口与契约",
      "items": ["用户端和管理台共享 TypeScript 合约", "统一 HTTP 分发，写请求带 CSRF 与幂等键", "管理台额外经过角色 Scope 门禁"]
    },
    {
      "dot": "emerald",
      "title": "任务主链",
      "items": ["创建任务先校验、计价并预留余额", "Outbox → 队列 → Worker 租约保证可恢复", "渠道重试、断路器与消息/WebDAV 作业"]
    },
    {
      "dot": "violet",
      "title": "结果与一致性",
      "items": ["输出统一落到暂存对象并生成资产", "结算、释放和审计写入同一领域状态", "未知结果对账；WebSocket 游标回放"]
    }
  ]
}