术语表¶

适用范围：backend / admin / agent / canvas。现行代码为准（src/backend）。

角色与身份¶

术语	英文/标识	说明
C 端用户	`User` / `users`	画布与生图的终端用户，短信验证码登录
管理员	`AdminUser` / `admin_users`	独立表，仅可登录 Admin 后台；JWT `role=admin`
代理商	`Agent` / `agents`	一对一绑定 `users`；推广获客、分佣、结算
推荐码	`agent_code` / `referral_code`	代理唯一码；落地页 `/r/{code}` 用于绑客

术语	说明
产品大类	`product_categories`，如服装、家纺
产品子类	`product_sub_types`，可树形（`parent_id`）；`applicable_functions` 标注适用功能
面料类型 / 材质	`fabric_types` → `fabric_materials`；子类通过 `sub_type_fabric_materials` 关联
构图/场景/模特模板	虚拟影棚类模板库；经 `sub_type_*_templates` 挂到子类
模板风格	`product_styles`，挂在品类下；主图/详情 C 端选型用（取代小类×材质链路）
主图/详情/爆款模板	电商图模板；主图/详情目标匹配键为品类×风格；爆款复刻仍用 HotStyle
模板图片	`template_images`，`template_type` ∈ `main` / `detail` / `replica` / `hot_style`
适用功能	`virtual_studio` / `main_image` / `detail_image` 等，控制 C 端可见范围

术语	说明
任务类型 `task_type`	如热拍、主图、详情、换景、复刻、模特生成等业务场景键
生成任务	`tasks` + `task_params`；状态 `pending` / `running` / `completed` / `failed` / `cancelled`（见 `backend.core.task_status`；批量 Job 另有 `partial`，回写 task 时 partial→completed）
Prompt 组装	Admin/User 预览与正式生成前，将模板片段、自定义产品/材质槽、参考图等拼成最终提示词（主图/详情）；虚拟影棚等仍可拼面料描述
模型池	`ai_model_groups`：逻辑模型；池内多 `ai_models` 按 priority/weight 调度
共享 API 账号	`ai_model_api_accounts` + bindings；可被多物理模型共用
熔断	池内物理模型连续失败达阈值后短路，恢复窗口后半开探测
RunningHub	画布侧外部工作流执行能力（`/api/canvas/runninghub/*`）
乐观锁 revision	`canvas_projects.revision`；更新需带 `expectedRevision`，冲突 409

完整业务规则见 membership-agent-sales-guide.md；表结构见 data-model/billing.md。

术语	说明
会员方案	`member_plans`：`subscription` / `extra_pack`；含月配额、分辨率、并发
配额	`usage_quotas`：`total` / `used` / `reset_at`
订单	`orders`：`pending` → `paid` / `completed` / `cancelled` / `refunded`
支付流水	`payment_records`：微信/支付宝；含 mock 支付（开发）
消费扣点	`consumption_records`：任务成功扣 credits
统一流水	`transaction_ledger`：`owner_type` 为 `user` / `agent`
客户优惠比例	`agents.customer_discount_rate`（0~50%）；API 路径名含 `commission-rate`，语义为客户折扣
分账规则	`agent_commission_rules`：按代理等级×方案
分账记录	`commission_records`：`pending` / `settled` / `withdrawn` / `clawed_back`
客户绑定	`customer_agent_bindings`：一客户一代理，首次永久
提现	`agent_withdrawals`：预占余额，Admin 审批
结算绑定	代理绑定支付宝/微信扫码账户或商户资料（`/api/settlement/*`）

术语	说明
API 包络	`{ "code": 200, "message": "success", "data": ... }`
Admin JWT	`Authorization: Bearer`，校验 `admin_users`
User JWT	C 端用户 token
Agent 上下文	User JWT + `agents` 表存在且状态正常（`require_agent`）

缩写	含义
Admin	Canvas Admin 管理后台（`admin-system`，:5175）
Agent	代理商门户（`agent-system`，:5173）
Canvas	无限画布前台（`infinitecanvas`，:5176）
Backend	代理商/画布/Admin 共用 API（`src/backend`，:8001）
OSS / storage	独立存储微服务 :8002；AK 仅存于 storage
Worker	`backend-worker`，消费 Redis Stream（短信/生图/SSE 等）