# agent_manage_system

**Repository Path**: ai_project_kejin/agent_manage_system

## Basic Information

- **Project Name**: agent_manage_system
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-13
- **Last Updated**: 2026-03-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🏢 企业级 AI Agent 管理系统

> **版本**: v1.0  
> **状态**: ✅ 核心功能已完成，可投入测试  
> **完成度**: 98%  
> **最后更新**: 2026-03-14

[![Review Score](https://img.shields.io/badge/评分-88/100-brightgreen)](REVIEW_REPORT.md)
[![Completion](https://img.shields.io/badge/完成度-98%25-blue)](docs/开发文档汇总.md)
[![APIs](https://img.shields.io/badge/API-137+-orange)](http://localhost:3000/api-docs)

---

## 📋 项目概述

为 500 人企业打造的一站式 AI Agent 管理平台，实现：
- ✅ 500 台终端 Agent 统一管理
- ✅ 飞书文档集中管控
- ✅ CRM 系统集成（框架就绪）
- ✅ 四级安全审批 + 双人复核
- ✅ AI 对话能力（智谱 GLM 对接）
- ✅ 工作流自动化（6 种节点执行器）
- ✅ 中央调度中心（Agent 编排 + 任务路由）
- ✅ 数据报表分析（Token 统计 + 使用分析）

---

## 🚀 快速开始

### 1. 启动数据库

```bash
cd backend
sudo docker compose up -d postgres redis
```

### 2. 启动后端

```bash
cd backend
npm run dev
# API: http://localhost:3000
# Swagger: http://localhost:3000/api-docs
```

### 3. 启动前端

```bash
cd frontend
npm run dev
# 访问：http://localhost:3001
```

### 4. 登录测试

- **邮箱**: admin@test.com
- **密码**: Admin123456

---

## 📦 核心功能

### 后端模块（17 个）

| 模块 | API 数量 | 功能说明 |
|------|----------|----------|
| Auth 认证 | 5 | JWT 登录/注册/Token 刷新 |
| Agent 管理 | 13 | CRUD + 对话接口 + 对话历史 |
| User 用户 | 7 | CRUD + 角色权限 + 职级管理 |
| AI 对话 | 9 | 智谱 GLM 对接 + Token 统计 |
| Workflow 工作流 | 10 | CRUD + 执行引擎（6 种节点） |
| Feishu 飞书 | 11 | 双向同步 + Webhook + 定时任务 |
| MCP 服务器 | 11 | 11 个工具（数据库/知识库/CRM） |
| Storage 存储 | 11 | MinIO 文件上传/下载/预览 |
| Orchestrator 调度 | 15+ | Agent 编排 + 任务路由 |
| Analytics 报表 | 7 | Token 统计 + 使用分析 |

**总计**: 137+ API 端点

### 前端页面（12 个）

- Dashboard 仪表盘
- Agent 管理（列表 + 详情 + 对话）
- 用户管理
- 技能管理
- 文档管理
- 知识库
- CRM 管理
- 工作流管理
- 安全中心
- 登录页

---

## 📊 项目统计

| 指标 | 数量 |
|------|------|
| **Git 提交** | 20 个 |
| **代码行数** | 28,346 行 |
| **后端模块** | 17 个 |
| **前端页面** | 12 个 |
| **API 端点** | 137+ 个 |
| **数据库实体** | 20+ 个 |
| **开发时间** | ~4 小时 |

---

## 📚 文档索引

### 核心文档
- [技术架构设计.md](技术架构设计.md) - 完整技术架构
- [开发进度报告.md](开发进度报告.md) - 开发进度详情
- [REVIEW_REPORT.md](REVIEW_REPORT.md) - 项目审查报告（88/100 分）

### 快速开始
- [QUICKSTART.md](QUICKSTART.md) - 5 分钟快速启动
- [登录说明.md](登录说明.md) - 登录配置和测试账号

### 测试指南
- [docs/测试指南.md](docs/测试指南.md) - 完整测试流程

### 文档汇总
- [docs/开发文档汇总.md](docs/开发文档汇总.md) - 所有文档索引

---

## 🛠️ 技术栈

### 后端
- **框架**: NestJS 10 + TypeScript
- **数据库**: PostgreSQL 16 + TypeORM
- **缓存**: Redis 7 + ioredis
- **认证**: JWT + Passport
- **文档**: Swagger/OpenAPI

### 前端
- **框架**: React 18 + TypeScript
- **UI**: Ant Design 5
- **路由**: React Router 6
- **状态**: Zustand
- **构建**: Vite 5

### AI & 集成
- **大模型**: 智谱 GLM（已对接）
- **MCP**: Model Context Protocol（11 工具）
- **飞书**: 文档 API + 消息 + Webhook
- **存储**: MinIO（S3 兼容）

---

## 🔐 安全特性

### 数据分级
| 级别 | 标识 | 访问要求 |
|------|------|----------|
| L1 | 公开 | 全员可访问 |
| L2 | 内部 | 需要登录 |
| L3 | 敏感 | 需要审批 |
| L4 | 涉密 | 四级审批 + 双人复核 |

### 职级权限
| 职级 | 数据访问 | 技能访问 |
|------|----------|----------|
| L1 初级员工 | L1 | 基础技能 |
| L2 中级员工 | L1-L2 | 部门技能 |
| L3 高级员工 | L1-L3 | 高级技能 |
| L4 部门经理 | L1-L3 | 管理技能 |
| L5 高管 | L1-L4 | 全部技能 |

---

## 📈 开发进度

```
整体完成度：█████████████████████░ 98%

第一阶段（AI 核心）：  ████████████████████ 100% ✅
第二阶段（企业集成）：████████████████░░░░  90% ✅
第三阶段（基础设施）：████████████████████ 100% ✅
```

### 已完成功能
- ✅ AI 对话服务（智谱 GLM 对接）
- ✅ Agent 对话接口（流式响应）
- ✅ 工作流执行引擎（6 种节点）
- ✅ 飞书文档双向同步
- ✅ CRM 框架（适配器模式）
- ✅ MCP 服务器（11 个工具）
- ✅ 安全审批流程（四级 + 双人复核）
- ✅ 对象存储 MinIO
- ✅ 中央调度中心
- ✅ 数据报表分析

### 可选后续
- ⏸️ 工作流可视化编辑器
- ⏸️ 统一接入网关
- ⏸️ 本地大模型部署
- ⏸️ 知识库向量化（Milvus）

---

## 🧪 测试

### API 测试
```bash
# 注册账号
curl -X POST http://localhost:3000/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email":"admin@test.com","password":"Admin123456","username":"admin"}'

# 登录获取 Token
curl -X POST http://localhost:3000/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"admin@test.com","password":"Admin123456"}'
```

### 前端测试
1. 访问 http://localhost:3001
2. 使用测试账号登录
3. 测试各功能模块

详细测试流程见：[docs/测试指南.md](docs/测试指南.md)

---

## 📞 支持

- **API 文档**: http://localhost:3000/api-docs
- **代码仓库**: https://gitee.com/ai_project_kejin/agent_manage_system
- **技术文档**: [docs/开发文档汇总.md](docs/开发文档汇总.md)

---

## 📄 许可证

Copyright © 2026 企业级 AI Agent 管理系统

---

> **最后更新**: 2026-03-14  
> **维护者**: AI Assistant  
> **审查评分**: 88/100 ⭐⭐⭐⭐