Admin 功能文档¶
代码：
src/admin-system/。路由：src/app/routes.tsx。端口 5175 /admin.localhost。
1. 产品定位¶
Canvas Admin：运营配置产品树、模板库、AI 模型池、用户与计费、代理商与分佣、Prompt 测试与任务监控。
2. 路由与页面¶
| 路径 | 页面 | 能力 |
|---|---|---|
/login |
AdminLogin | 管理员短信登录 |
/admin/dashboard |
AdminDashboard | 概览统计 |
/admin/categories |
CategoryManagePage | 产品大类 |
/admin/fabrics |
FabricManagePage | 面料类型/材质 |
/admin/products |
ProductManagePage | 产品子类树 |
/admin/product-virtual-studio |
VirtualStudioProductPage | 虚拟影棚产品配置 |
/admin/product-main-image |
MainImageProductPage | 主图产品配置（子类适用功能等） |
/admin/product-detail-image |
DetailImageProductPage | 详情图产品配置 |
/admin/product-styles |
ProductStyleManagePage | 模板风格（挂品类）CRUD |
/admin/comp-templates |
CompTemplatePage | 构图模板 |
/admin/scene-templates |
SceneTemplatePage | 场景模板 |
/admin/model-templates |
ModelTemplatePage | 模特模板+姿势 |
/admin/virtual-studio-templates |
VirtualStudioTemplatePage | 虚拟影棚库模板/测试 |
/admin/main-style-templates / detail-style-templates |
StyleImageTemplatePage | 主图/详情风格模板：品类×风格、多套、Word、封面 |
/admin/main-image-templates 等 |
主图/详情/爆款模板页 | 历史入口/爆款等；主图详情生图以风格模板页为准 |
/admin/ai-models |
AiModelsPage | 物理模型与 Key |
/admin/model-pools |
ModelPoolsPage | 模型池成员 |
/admin/api-accounts |
ApiAccountsPage | 共享 API 账号绑定 |
/admin/model-attributes |
ModelAttributesPage | 模特生成属性 |
/admin/users |
V3UsersPage | 用户/订阅/配额/管理员授予 |
/admin/tasks |
TasksPage | 任务监控取消重试 |
/admin/prompt-config |
PromptConfigPage | Prompt 配置 |
/admin/prompt-test |
PromptTestPage | Prompt 预览与测试生图 |
/admin/system-config |
SystemConfigPage | 系统参数/Banner/卡片 |
/admin/billing/plans |
PlansPage | 会员方案 |
/admin/billing/orders |
OrdersPage | 订单与退款 |
/admin/billing/consumption |
ConsumptionPage | 消费明细 |
/admin/billing/revenue |
RevenueDashboard | 收入看板 |
/admin/billing/commission-rules |
CommissionRulesPage | 分账规则 |
/admin/billing/withdrawals |
WithdrawalsPage | 提现审批 |
/admin/billing/commissions |
AgentCommissions | 分账记录/结算 |
/admin/agents |
AgentsPage | 代理商管理 |
/admin/transactions |
TransactionsPage | 统一流水 |
旧路径（design-templates、llm-models 等）重定向到上表。
3. Feature 模块¶
| Feature | 职责 |
|---|---|
| login | 登录 |
| dashboard | 统计卡片 |
| product-management | 大类/子类/面料/按功能配置产品 |
| templates / image-templates | 各类模板与 Word 批量 |
| ai-models | 模型、池、账号 |
| users | 用户运营 |
| tasks / prompt-config | 任务与 Prompt |
| system-config | 运营配置 |
| billing / agents / transactions | 计费与代理 |
架构约束：features/* 互不 import；HTTP 仅经 shared/api。
4. 业务规则（前端侧）¶
- 未登录访问
/admin/*→ 跳转/login - 写操作依赖 Admin JWT；401 清 token 并跳登录
- 主图/详情风格模板匹配依赖 品类×风格（
product_category_ids/style_ids），保存后 C 端catalog/styles与image-templates可见；面料链路仍服务虚拟影棚等 - 提现审批需二次确认；退款写备注
- Word 批量测试可能走 SSE/stream（
wordBatchTestStream）
5. 状态与表（间接）¶
页面操作最终写入 backend 表，见 data-model.md。Admin 不直接连库。