taiji-pda-v0/docs/ADMIN-DASHBOARD-BUSINESS-REQUIREMENTS.md

管理平台（Super Admin Console）业务功能规范

本文档描述管理平台的业务功能要求，用于后端设计核对和功能完善。

1. 业务概述

管理平台是面向超级管理员的多租户SaaS平台管理控制台，主要业务目标：

• 管理分销渠道的准入、配额与资源分配
• 监控平台整体运营健康状况
• 提供精细化的计费管理与财务分析
• 维护平台的核心资源（AI模型、Agent、计算资源）
• 处理渠道与租户的业务审批流程

2. 核心业务实体

2.1 渠道（Channel）

• 定义：分销商/合作伙伴，拥有独立的租户组合管理权限
• 核心属性：渠道名称、联系信息、佣金比例、授信额度、状态
• 业务关系：一个渠道可管理多个租户

2.2 租户（Tenant）

• 定义：最终用户，通过渠道获得平台服务
• 核心属性：租户名称、归属渠道、权限范围、使用配额、计费信息
• 业务关系：归属于特定渠道，使用渠道分配的资源

2.3 Agent

• 定义：AI智能体实例，提供具体的AI服务能力
• 核心属性：类型、计算资源配置（CPU/内存）、健康状态、性能指标
• 业务关系：可被分配给渠道，再由渠道分配给租户使用

2.4 模型供应商（Provider）

• 定义：上游AI模型服务提供商
• 核心属性：供应商名称、API配置、支持模型、调用限制（RPM/TPM）
• 业务关系：可授权给特定渠道使用

3. 业务功能模块

3.1 平台概览与监控

3.1.1 运营概览

业务需求：提供平台整体运营状况的实时概览

• 统计数据：渠道总数、租户总数、总收入
• 系统资源：CPU/内存/磁盘使用率、活跃Agent数量
• 租户动态：最新注册/活跃租户列表，支持搜索和快速操作

后端要求：

• 提供实时/准实时的汇总统计接口
• 支持系统资源监控数据采集
• 租户列表支持分页、搜索、状态筛选

3.1.2 资源分配概览

业务需求：展示平台计算资源的分配使用情况

• 展示总体CPU/内存分配情况
• Agent资源分配统计
• 资源利用率分析

后端要求：

• 实时计算资源分配统计
• 支持按Agent类型、渠道等维度聚合

3.2 渠道管理

3.2.1 渠道生命周期管理

业务需求：管理渠道从准入到运营的完整生命周期

• 渠道注册：创建渠道账户，设置基本信息和佣金政策
• 渠道状态管理：激活、暂停、禁用等状态转换
• 渠道信息维护：联系信息、佣金比例等基础数据管理

后端要求：

• 渠道基础信息CRUD
• 渠道状态流转控制
• 渠道唯一性约束（名称、邮箱等）

3.2.2 渠道资源分配

业务需求：为渠道分配可用的平台资源

• 模型供应商授权：控制渠道可使用哪些AI模型
• Agent配额分配：设定渠道可分配给租户的Agent数量和类型
• 计算资源配置：设定自定义Agent的默认CPU/内存配置
• 授信管理：设置渠道的信用额度上限

后端要求：

• 资源分配关系管理（多对多关系）
• 配额检查和使用量统计
• 支持资源池管理和动态调整

3.2.3 渠道租户管理

业务需求：支持渠道对其下属租户的管理

• 租户创建：渠道为最终用户创建租户账户
• 权限分配：为租户设置功能权限（仪表板、Agent管理、模型配置等）
• 租户状态管理：激活、禁用、删除等操作
• 密码管理：支持租户密码重置

后端要求：

• 租户归属关系维护
• 细粒度权限控制系统
• 租户状态流转日志
• 密码安全管理

3.3 审批流程管理

3.3.1 供应商接入审批

业务需求：管理渠道申请使用新供应商的审批流程

• 申请提交：渠道提交供应商使用申请
• 申请审核：超管审批渠道的供应商接入请求
• 授权管理：批准后建立渠道-供应商授权关系

后端要求：

• 审批工作流引擎
• 申请状态跟踪
• 审批历史记录
• 授权关系自动建立

3.3.2 Agent资源审批

业务需求：管理渠道申请额外Agent资源的审批流程

• 资源申请：渠道申请特定类型和数量的Agent
• 需求评估：超管评估申请的合理性
• 资源分配：批准后自动分配Agent资源

后端要求：

• 申请模板和流程定义
• 资源可用性检查
• 自动资源分配机制

3.4 资源管理

3.4.1 Agent计算资源管理

业务需求：管理Agent实例的计算资源配置

• Agent资源配置：为每个Agent设置CPU、内存、实例数
• 资源利用监控：实时监控Agent资源使用情况
• 弹性伸缩：根据负载动态调整Agent实例数

后端要求：

• Agent实例管理
• 资源配置持久化
• 实时监控数据采集
• 自动伸缩策略支持

3.4.2 供应商管理

业务需求：管理上游AI模型供应商的接入和配置

• 供应商注册：添加新的模型供应商
• 连接配置：设置API端点、密钥、调用限制等
• 健康检查：监控供应商服务可用性和延迟
• 供应商下线：安全移除不再使用的供应商

后端要求：

• 供应商配置管理
• API连接池管理
• 健康检查调度
• 依赖关系检查（删除前）

3.5 监控告警

3.5.1 Agent健康监控

业务需求：实时监控所有Agent实例的健康状态

• 健康状态评估：基于CPU、内存、响应时间等指标评估Agent健康度
• 性能监控：监控响应时间、请求量、错误率等关键指标
• 异常告警：当Agent出现异常时及时告警

后端要求：

• Agent指标采集系统
• 健康度评估算法
• 实时告警机制
• 监控数据存储和查询

3.6 计费管理

3.6.1 多维度计费统计

业务需求：提供多个维度的计费数据统计和分析

• 渠道维度：按渠道统计调用量、消费金额、EU使用量
• 租户维度：按租户统计使用量和费用，支持跨渠道分析
• 调用明细：详细的API调用记录，包含时长、费用、时间戳等

后端要求：

• 实时计费数据统计
• 多维度数据聚合
• 计费规则引擎（EU到费用的转换）
• 大数据量查询优化

3.6.2 财务分析与导出

业务需求：支持财务数据的分析和导出

• 时间范围查询：支持自定义时间段的计费查询
• 数据筛选：按客户名称、调用次数等条件筛选
• 多格式导出：支持Excel、CSV、PDF等格式的数据导出

后端要求：

• 灵活的查询接口设计
• 异步导出任务处理
• 文件生成和下载服务
• 数据权限控制

3.7 权限与用户管理

3.7.1 管理员账户管理

业务需求：管理平台的各类管理员账户

• 系统管理员：管理计费管理员、运营管理员等
• 渠道管理员：查看各渠道的管理员信息
• 角色权限：为不同角色配置可访问的功能模块

后端要求：

• 分层级的用户管理体系
• 基于角色的访问控制（RBAC）
• 管理员操作审计日志
• 密码安全策略

3.7.2 角色权限配置

业务需求：灵活配置不同角色的系统权限

• 权限模板：预定义的角色权限模板
• 自定义权限：支持为特定角色定制权限范围
• 权限继承：支持权限的层级继承关系

后端要求：

• 细粒度权限控制系统
• 权限配置的持久化存储
• 实时权限生效机制
• 权限变更历史记录

4. 数据要求

4.1 实时性要求

• 高实时性（秒级）：系统监控数据、Agent健康状态
• 准实时（分钟级）：运营统计数据、资源使用情况
• 批处理（小时/日级）：计费统计、财务报表

4.2 数据一致性要求

• 强一致性：计费数据、资源分配、权限管理
• 最终一致性：监控数据、统计数据
• 幂等性：所有状态变更操作需支持幂等

4.3 数据存储要求

• 冷热分离：近期数据热存储，历史数据归档
• 备份恢复：关键业务数据需要定期备份
• 审计追踪：重要操作需要完整的审计日志

5. 安全要求

5.1 身份认证

• 支持多种认证方式（用户名密码、Token等）
• 会话管理和超时控制
• 多设备登录控制

5.2 操作授权

• 基于角色的细粒度权限控制
• 资源级别的访问控制
• 操作审计和日志记录

5.3 数据安全

• 敏感数据加密存储
• API调用加密传输
• 数据脱敏和隐私保护

6. 性能要求

6.1 响应时间

• 页面加载时间 < 2秒
• 查询接口响应 < 500ms
• 统计数据接口 < 1秒

6.2 并发处理

• 支持100+管理员并发访问
• 支持1000+渠道数据管理
• 支持10000+租户数据查询

6.3 数据处理能力

• 支持TB级别的计费数据查询
• 支持千万级别的调用记录检索
• 支持实时流式数据处理