# 太极 AI Agent 赋能平台 (Taiji AI PDA)

<div align="center">

![Next.js](https://img.shields.io/badge/Next.js-16.0-black?logo=next.js)
![React](https://img.shields.io/badge/React-19.2-61DAFB?logo=react)
![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?logo=typescript)
![Tailwind CSS](https://img.shields.io/badge/Tailwind-4.x-38B2AC?logo=tailwindcss)

**企业级 AI Agent 管理与分发平台前端**

</div>

---

## 📋 项目简介

太极 AI Agent 赋能平台是一个多租户、多角色的企业级 AI Agent 管理系统。平台支持超级管理员、渠道商、租户用户三级架构，提供完整的 Agent 生命周期管理、模型网关配置、资源分配与监控等功能。

## 🏗 系统架构

```
┌─────────────────────────────────────────────────────────────┐
│                     超级管理员 (Admin)                        │
│  · 渠道管理 · 资源分配 · 平台监控 · 系统配置                    │
├─────────────────────────────────────────────────────────────┤
│                     渠道商 (Channel)                          │
│  · 租户管理 · 资源分配 · Agent 部署 · 使用统计                  │
├─────────────────────────────────────────────────────────────┤
│                     租户用户 (Tenant)                         │
│  · Agent 工厂 · 模型网关 · 数据工具 · 编排中心                   │
└─────────────────────────────────────────────────────────────┘
```

## ✨ 核心功能

### 🔐 多级权限管理
- **超级管理员**: 平台全局管理，渠道资源分配
- **渠道管理员**: 租户管理，资源二次分配
- **租户用户**: Agent 使用与自定义部署

### 🤖 Agent 工厂
- 平台 Agent 一键部署
- 自定义 Agent 创建与配置
- K8s 资源配置 (CPU/内存)
- MCP 协议集成

### 🌐 模型网关
- 多模型供应商支持 (OpenAI, Anthropic, DeepSeek 等)
- 统一 API 网关
- 负载均衡与故障转移
- 实时监控与日志

### 🔧 数据工具
- API 工具管理
- 自定义 Agent 部署
- 工具市场集成

### 📊 资源监控
- 实时资源使用统计
- Agent 运行状态监控
- 调用量与性能分析

### 🌍 国际化支持
- 中文/英文双语界面
- 一键切换语言

## 🛠 技术栈

| 类别 | 技术 |
|------|------|
| **框架** | Next.js 16, React 19 |
| **语言** | TypeScript 5 |
| **样式** | Tailwind CSS 4, Radix UI |
| **状态管理** | React Context |
| **表单处理** | React Hook Form, Zod |
| **图表** | Recharts |
| **工具库** | date-fns, Lucide Icons |

## 🚀 快速开始

### 环境要求

- Node.js >= 20.9.0
- npm 或 pnpm

### 安装依赖

```bash
# 使用 npm
npm install

# 或使用 pnpm
pnpm install
```

### 环境配置

创建 `.env.local` 文件：

```env
# API 服务地址
NEXT_PUBLIC_DATA_INGESTION_URL=http://localhost:8002
NEXT_PUBLIC_MCP_SERVER_URL=http://localhost:8002
NEXT_PUBLIC_API_GATEWAY_URL=http://localhost:8002
```

### 启动开发服务器

```bash
npm run dev
```

访问 [http://localhost:3000](http://localhost:3000)

### 构建生产版本

```bash
npm run build
npm run start
```

## 📁 项目结构

```
taiji-pda-v0/
├── app/                    # Next.js App Router
│   ├── admin/              # 超级管理员模块
│   │   ├── dashboard/      # 管理控制台
│   │   └── login/          # 管理员登录
│   ├── channel/            # 渠道商模块
│   │   ├── dashboard/      # 渠道控制台
│   │   └── login/          # 渠道商登录
│   ├── agent-factory/      # Agent 工厂
│   ├── model-gateway/      # 模型网关
│   ├── data-tools/         # 数据工具
│   ├── orchestration/      # 编排中心
│   ├── billing/            # 计费管理
│   └── login/              # 租户登录
├── components/             # 可复用组件
│   ├── ui/                 # UI 基础组件
│   └── ...                 # 业务组件
├── contexts/               # React Context
├── hooks/                  # 自定义 Hooks
├── lib/                    # 工具库
│   ├── api-client.ts       # API 客户端
│   └── auth.ts             # 认证工具
├── styles/                 # 全局样式
└── docs/                   # 项目文档
```

## 🔗 API 端点

平台对接三个主要后端服务：

| 服务 | 用途 | 默认地址 |
|------|------|----------|
| MCP Server | Agent 管理、用户认证 | `localhost:8002` |
| Data Ingestion | 数据接入服务 | `localhost:8002` |
| API Gateway | 模型网关服务 | `localhost:8002` |

## 📝 开发规范

- 使用 TypeScript 严格模式
- 遵循 ESLint 代码规范
- 组件采用函数式写法
- 使用 Tailwind CSS 原子类

## 📄 许可证

私有项目 - 保留所有权利

---

<div align="center">
  <sub>Built with ❤️ by Taiji Team</sub>
</div>