# enterprise-agent-platform

**Repository Path**: kangxiaohui2021/enterprise-agent-platform

## Basic Information

- **Project Name**: enterprise-agent-platform
- **Description**: No description available
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-29
- **Last Updated**: 2026-07-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# enterprise-agent-platform

`enterprise-agent-platform` 是一个面向单企业内部场景的智能体平台工程骨架，产品中文名为 `中小企业智能体平台`。

项目当前包含两类产品端与两类后端服务：

- `H5 Client`
  - 面向终端用户的问答与工具消费端
- `Web Admin Console`
  - 面向管理员、运营、安全审计人员的治理后台
- `Go Platform Service`
  - 负责登录、RBAC、知识库元数据、工具网关、审计与后台管理 API
- `Python AI Service`
  - 负责 LangGraph 编排、RAG、记忆、安全、模型调用与 AI 可观测性

## Project Positioning

这是一个 `single-company` 智能体平台，不是多租户 SaaS，不是公共聊天产品，也不是单一的 RAG Demo。

它覆盖的核心能力包括：

- Agent runtime orchestration
- knowledge governance
- document parsing and indexing
- hybrid retrieval and rerank
- tool governance
- safety and risk control
- memory
- observability and audit
- admin RBAC

## Architecture

当前主链路约束如下：

- `H5 login -> Go`
- `H5 chat -> Python AI service directly`
- `Admin web -> Go`
- `Go -> Python` 仅用于后台侧 AI 能力，如解析、索引、检索调试、重建任务
- `Python -> Go tool gateway` 用于高风险或受控业务工具执行

## Tech Stack

- `Frontend`
  - H5: cross-platform H5 app scaffold
  - Admin: web admin scaffold
- `Backend`
  - Go 1.22
  - Gin
  - Gorm
  - Python 3.12
  - FastAPI
  - Pydantic
  - LangGraph
- `Infrastructure`
  - PostgreSQL
  - pgvector
  - Redis
  - MinIO

## Repository Structure

```text
apps/
  admin-web/
  client-h5/
services/
  go-platform/
  python-ai/
docs/
configs/
deploy/
testdata/
```

详细说明见：

- [docs/README.md](./docs/README.md)
- [docs/system-overview.md](./docs/system-overview.md)
- [docs/project-structure.md](./docs/project-structure.md)

## Design And Product Docs

- 产品总览：[PRODUCT.md](./PRODUCT.md)
- 后台产品：[PRODUCT-ADMIN.md](./PRODUCT-ADMIN.md)
- H5 产品：[PRODUCT-H5.md](./PRODUCT-H5.md)
- 设计总览：[DESIGN.md](./DESIGN.md)
- 后台设计：[DESIGN-ADMIN.md](./DESIGN-ADMIN.md)
- H5 设计：[DESIGN-H5.md](./DESIGN-H5.md)
- 后台 Stitch Prompt：[STITCH-ADMIN.md](./STITCH-ADMIN.md)
- H5 Stitch Prompt：[STITCH-H5.md](./STITCH-H5.md)

## Current Status

当前仓库处于 `architecture + docs + scaffold` 阶段，已包含：

- 系统架构与职责边界文档
- 数据库初稿 SQL
- Go / Python 服务目录骨架
- H5 / Admin 前端目录骨架
- 产品与设计文档
- Stitch UI prompt 文档

尚未完成：

- 业务接口实现
- LangGraph 运行图实现
- 前端页面开发
- CI/CD
- 自动化测试

## Quick Start

当前以文档和骨架为主，建议按下面顺序阅读和开发：

1. 阅读 [docs/system-overview.md](./docs/system-overview.md)
2. 阅读 [docs/golang-architecture.md](./docs/golang-architecture.md)
3. 阅读 [docs/python-ai-architecture.md](./docs/python-ai-architecture.md)
4. 阅读 [docs/database_schema.sql](./docs/database_schema.sql)
5. 从 `Go JWT auth -> Python JWT verify -> /ai/chat minimal path` 开始做第一条纵切链路

## Contributing

提交 issue 前请先说明：

- 你的目标场景
- 预期行为
- 当前问题
- 复现步骤
- 环境信息

仓库默认使用 issue 模板。

## License

本项目采用 [Apache License 2.0](./LICENSE)。