# open-ai-platform

**Repository Path**: mgb/open-ai-platform

## Basic Information

- **Project Name**: open-ai-platform
- **Description**: 企业智能助手平台
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-07-31
- **Last Updated**: 2026-07-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 企业 AI 助手编排平台

前后端分离的企业 **AI 助手编排平台**：配置 Assistant / Skill / Tool / LLM，经 Agent 主链完成 Decision → Tool → Answer；知识与外部业务能力通过 HTTP Tool / SPI 接入。

## 核心能力

- 多 Assistant 管理与发布
- Skill（PROMPT_PACK）绑定、版本与 Tool 绑定
- LLM 配置（OpenAI Compatible / Mock 等）与调用日志
- Agent 执行链：Decision / ToolRuntime / Prompt / SSE Chat
- Admin 运营：会话、Trace、Ops 看板
- 验证前端（工作台 + Admin + Demo）

## 技术栈

| 层 | 技术 |
|----|------|
| Backend | JDK 21 · Spring Boot 3.3 · MyBatis-Plus · MySQL 8 · Caffeine |
| Frontend | React 19 · Vite · Ant Design · Axios |
| Deploy | Docker Compose · Nginx · 本机构建 JAR/dist |

## 项目结构

```text
ai-platform/
├── backend/           # 唯一 Maven 工程（backend/pom.xml）
├── frontend/          # React 前端
├── docs/              # 文档基线（以代码为 SSOT）
├── scripts/           # start/stop 等
├── docker-compose.yml
├── .env.example
└── README.md
```

## 快速启动

### 后端

```bash
cp .env.example .env          # 填写 DB_* / LLM_ENCRYPT_KEY
set -a && source .env && set +a
cd backend && mvn spring-boot:run
```

服务：http://127.0.0.1:8080

### 前端

```bash
cd frontend && npm install && npm run dev
```

页面：http://127.0.0.1:5173（代理 `/api` → 8080）

### Docker（本机构建 + 挂载）

```bash
./scripts/start.sh
./scripts/stop.sh
```

详见 [docs/deployment-guide.md](docs/deployment-guide.md)。

## 文档

从 [docs/README.md](docs/README.md) 进入完整文档：

- [架构](docs/architecture.md)
- [Agent 平台](docs/agent-platform-design.md)
- [API](docs/api-design.md)
- [数据库](docs/database-design.md)
- [开发指南](docs/development-guide.md)

## 系统边界

| 做 | 不做（当前） |
|----|--------------|
| 助手编排、Skill/Tool/LLM、Chat SSE | 自建 RAG/向量库 |
| HTTP Tool 配置接入 | 完整 SSO / 多租户产品化 |
| Admin DTO/VO + Service Result | 根目录 Maven 多模块 |

**文档原则：** 代码是唯一事实来源；历史 Phase 报告已清理，见 [docs/document-cleanup-report.md](docs/document-cleanup-report.md)。