Files
taiji-pda-v0/docs/FRONTEND-CODE-REVIEW-CHECKLIST.md
T
xiaohei f044360293 fix: 修复超级管理员控制台概览页面接口问题
1. 修复统计数据字段名与后端API不匹配问题
   - total_channels → totalChannels
   - total_tenants → totalTenants
   - total_revenue → totalRevenue

2. 修复系统指标使用正确的监控接口
   - 从 getAdminDashboardStats 改为 getMonitoringMetrics
   - 使用正确的字段: system.cpu_usage_percent, system.memory_usage_percent, system.disk_usage_percent
   - API请求数使用 services.total_executions_24h

3. 添加监控接口错误处理,避免页面崩溃
2025-12-31 10:31:37 +00:00

5.2 KiB
Raw Blame History

前端代码阶段性测试检查清单

检查时间: 2025-12-31
检查范围: taiji-pad-v0 前端项目


📋 检查摘要

检查项 数量 状态
TODO未实现 1 ⚠️ 需处理
硬编码数据 3处 🔴 需修复
localhost引用 2处 ⚠️ 需确认
调试日志 多处 🟡 建议清理

🔴 1. TODO未实现的逻辑

1.1 删除管理员功能未实现

文件: app/admin/dashboard/page.tsx:1132

// TODO: 调用API删除管理员

影响: 管理员删除功能无法正常工作

修复建议: 调用 TaijiAPIClient.deleteAdmin(adminId) 方法


🔴 2. 硬编码数据

2.1 渠道仪表板 - 模型供应商数据

文件: app/channel/dashboard/page.tsx:702-707

const platformModelProviders = [
  { id: 1, name: "OpenAI", status: "active", requests: 52000, latency: 150, uptime: "99.9%", icon: "🤖" },
  { id: 2, name: "Anthropic", status: "active", requests: 38000, latency: 180, uptime: "99.8%", icon: "🧠" },
  { id: 3, name: "Google AI", status: "active", requests: 25000, latency: 120, uptime: "99.95%", icon: "🔍" },
  { id: 4, name: "Meta Llama", status: "active", requests: 15000, latency: 95, uptime: "99.7%", icon: "🦙" },
]

影响: 页面显示静态数据,不反映真实API数据

修复建议: 使用 modelProvidersData 状态变量(已通过API获取)

2.2 渠道仪表板 - 数据供应商数据

文件: app/channel/dashboard/page.tsx:709-713

const platformDataProviders = [
  { id: 1, name: "RapidAPI", status: "active", apis: 8000, calls: 2200000, capacity: "95%", icon: "⚡" },
  { id: 2, name: "API Hub", status: "active", apis: 5000, calls: 1500000, capacity: "87%", icon: "🔗" },
  { id: 3, name: "OpenData", status: "active", apis: 3000, calls: 800000, capacity: "92%", icon: "📊" },
]

影响: 数据供应商信息为静态假数据

修复建议: 需要后端提供数据供应商API,或移除此功能

2.3 渠道仪表板 - 自定义供应商数据

文件: app/channel/dashboard/page.tsx:715-724

const customProviders = {
  model: [
    { id: 101, name: "Internal AI Model", status: "active", requests: 5000, latency: 80, uptime: "99.5%" },
    { id: 102, name: "Custom LLM Endpoint", status: "active", requests: 3200, latency: 200, uptime: "98.9%" },
  ],
  data: [
    { id: 201, name: "Internal Data API", status: "active", apis: 12, calls: 450000, capacity: "70%" },
    { id: 202, name: "Third-party Data Source", status: "active", apis: 8, calls: 320000, capacity: "65%" },
  ],
}

影响: 自定义供应商为静态假数据


⚠️ 3. localhost引用(需确认是否为fallback)

3.1 租户权限更新

文件: app/admin/dashboard/components/ChannelsTab.tsx:578

`${API_BASE_URLS.mcpServer || "http://localhost:8002"}/api/channel/tenants/${selectedTenantForPermission.id}/permissions`

3.2 租户权限更新(重复)

文件: app/admin/dashboard/page.tsx:1242

`${API_BASE_URLS.mcpServer || "http://localhost:8002"}/api/channel/tenants/${selectedTenantForPermission.id}/permissions`

说明: 这些是fallback值,当环境变量未设置时使用。生产环境应确保 NEXT_PUBLIC_MCP_SERVER_URL 已正确配置。


🟡 4. 调试日志(建议生产环境清理)

以下文件包含调试日志,建议在生产环境前清理:

文件 行号 类型
app/channel/dashboard/page.tsx 425-432 console.log (中文调试信息)
app/admin/dashboard/components/ChannelsTab.tsx 393, 483, 507, 524, 537 console.log

✅ 5. 已正确实现的功能

5.1 API客户端

  • ✅ 登录/登出功能
  • ✅ Token管理和刷新
  • ✅ 租户CRUD操作
  • ✅ 渠道管理
  • ✅ 资源分配
  • ✅ 计费管理
  • ✅ 供应商管理
  • ✅ K8s Agent管理(新增)
  • ✅ 修改租户密码(新增)

5.2 页面功能

  • ✅ 用户仪表板
  • ✅ 管理员仪表板
  • ✅ 渠道仪表板
  • ✅ Agent工厂
  • ✅ 编排中心
  • ✅ 计费页面
  • ✅ 登录页面

🔧 6. 修复建议优先级

高优先级(阻塞测试)

  1. 修复删除管理员TODO
    • 文件: app/admin/dashboard/page.tsx:1132
    • 添加 await TaijiAPIClient.deleteAdmin(adminId) 调用

中优先级(影响数据准确性)

  1. 移除硬编码数据
    • 文件: app/channel/dashboard/page.tsx:702-724
    • 使用API返回的真实数据或显示"暂无数据"

低优先级(代码质量)

  1. 清理调试日志
    • 移除或条件化 console.log 语句

📝 7. 环境变量检查

确保以下环境变量已正确配置:

NEXT_PUBLIC_MCP_SERVER_URL=https://apimtaiji.azure-api.net/api/mcp
NEXT_PUBLIC_DATA_INGESTION_URL=https://apimtaiji.azure-api.net/api/mcp
NEXT_PUBLIC_API_GATEWAY_URL=https://apimtaiji.azure-api.net/api/mcp

✅ 8. 测试前检查清单

  • 确认环境变量已配置
  • 确认后端服务可访问
  • 修复删除管理员TODO
  • 决定是否移除硬编码数据
  • 清理调试日志(可选)

报告生成者: Claude AI
状态: 待测试