# coai

**Repository Path**: yanais/coai

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-10
- **Last Updated**: 2025-11-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# COAI - 基于AI的智能协同平台

一款功能完善的企业级协同工具，集成即时通讯、音视频通话、文件管理、AI智能分析、ERP业务管理和数字孪生能力。

## 🎯 核心特性

### 基础通信
- ✅ 即时消息（文本、图片、文件、语音等8种类型）
- ✅ 音视频通话（一对一、群组、会议）
- ✅ 文件上传下载（分片上传、断点续传、秒传）
- ✅ WebSocket实时推送

### AI智能化
- ✅ 智能客服（意图识别、情绪分析、知识库）
- ✅ 会议分析（自动总结、任务提取、关键点识别）
- ✅ 销售助手（话术推荐、成交预测）
- ✅ 内容生成（文案、方案、报告）

### ERP业务
- ✅ 智能仓储（AI选址、路径优化、质量检测）
- ✅ 智能物流（路径规划、装载优化、异常预警）
- ✅ 智能采购（需求预测、供应商评估、合同分析）
- ✅ 智能制造（生产调度、预测维护、质量预测）

### 数字孪生
- ✅ 全链路业务节点跟踪
- ✅ 200+ 实时KPI指标计算
- ✅ What-If业务模拟分析
- ✅ 虚拟化业务决策支持

## 🏗️ 系统架构

### 微服务架构
```
API Gateway (8080)
├── 用户服务 (8085) - 用户、组织、权限
├── AI服务 (8082) - OpenAI集成、智能引擎
├── 消息服务 (8081) - 即时通讯、WebSocket
├── RTC服务 (8083) - 音视频通话、信令
├── 文件服务 (8084) - MinIO对象存储
├── 仓储服务 (8086) - 智能仓储管理
├── 物流服务 (8087) - 智能物流调度
├── 采购服务 (8088) - 智能采购分析
├── 制造服务 (8089) - 智能生产管理
└── 数字孪生 (8090) - 业务监控与模拟
```

### 技术栈

**后端**
- Kotlin 1.9.21
- Spring Boot 3.2.0
- Spring Cloud Gateway
- PostgreSQL (关系数据)
- MongoDB (AI/事件数据)
- Redis (缓存/限流)
- Kafka (事件流)
- InfluxDB (时序指标)
- MinIO (对象存储)
- WebSocket/STOMP
- WebRTC

**前端**
- TypeScript
- Vue 3 + Vite
- Pinia
- Element Plus
- WebSocket/STOMP.js
- WebRTC

**小程序**
- uni-app 3.x
- Vue 3
- TypeScript

## 🚀 快速开始

### 前置要求
- JDK 17+
- Node.js 18+
- Docker & Docker Compose
- Gradle 8+

### 1. 启动基础设施

```bash
# 启动PostgreSQL、Redis、MongoDB、Kafka、MinIO、InfluxDB
docker-compose up -d
```

### 2. 启动后端服务

#### 方式一：使用启动脚本（推荐）
```bash
./start.sh
```

#### 方式二：手动启动
```bash
# 构建
cd backend
./gradlew clean build

# 按顺序启动各服务
java -jar api-gateway/build/libs/api-gateway-1.0.0.jar &
java -jar user-service/build/libs/user-service-1.0.0.jar &
java -jar ai-service/build/libs/ai-service-1.0.0.jar &
# ... 其他服务
```

### 3. 启动前端

#### Web端
```bash
cd frontend
npm install
npm run dev
```
访问: http://localhost:3000

#### 小程序端
```bash
cd miniprogram
npm install
npm run dev:mp-weixin
```
使用微信开发者工具打开 `dist/dev/mp-weixin`

### 停止所有服务

```bash
./stop.sh
```

## 📁 项目结构

```
coai/
├── backend/                    # 后端微服务
│   ├── api-gateway/           # API网关 (8080)
│   ├── user-service/          # 用户服务 (8085)
│   ├── message-service/       # 消息服务 (8081)
│   ├── ai-service/            # AI服务 (8082)
│   ├── rtc-service/           # RTC服务 (8083)
│   ├── file-service/          # 文件服务 (8084)
│   ├── erp-warehouse/         # 仓储服务 (8086)
│   ├── erp-logistics/         # 物流服务 (8087)
│   ├── erp-procurement/       # 采购服务 (8088)
│   ├── erp-manufacturing/     # 制造服务 (8089)
│   ├── digital-twin/          # 数字孪生 (8090)
│   └── common/                # 公共模块
├── frontend/                   # Web前端 (Vue3)
├── miniprogram/               # 微信小程序 (uni-app)
├── docker-compose.yml         # 基础设施编排
├── start.sh                   # 启动脚本
└── stop.sh                    # 停止脚本
```

## 🔧 配置说明

### 数据库连接
- **PostgreSQL**: `localhost:5432/coai` (coai/coai_password)
- **MongoDB**: `localhost:27017` (coai/coai_password)
- **Redis**: `localhost:6379`

### 消息队列
- **Kafka**: `localhost:9092`

### 对象存储
- **MinIO**: `localhost:9000` (Console: 9001)
- 用户名/密码: `coai/coai_password`

### 时序数据库
- **InfluxDB**: `localhost:8086`
- Token: `coai-admin-token`

### AI服务
需要配置OpenAI API Key:
```yaml
# backend/ai-service/src/main/resources/application.yml
openai:
  api-key: "your-api-key-here"
```

## 🎨 核心功能模块

### 1. 即时通讯
- 支持文本、图片、文件、语音等8种消息类型
- WebSocket实时推送
- 消息已读/未读状态
- 群组会话管理

### 2. 音视频通话
- WebRTC点对点通话
- 群组通话/视频会议
- 屏幕共享
- 通话记录

### 3. 文件管理
- 分片上传大文件
- MD5去重秒传
- 断点续传
- 文件预览/下载

### 4. AI智能客服
- 自动意图识别
- 情绪分析
- 知识库检索
- 客户画像

### 5. 智能仓储
- AI库位推荐
- 拣货路径优化（TSP算法）
- 图像质检
- 库存预警

### 6. 数字孪生
- 实时业务监控
- KPI指标看板
- What-If模拟分析
- 业务决策支持

## 📊 数据流架构

```
业务操作 → Kafka事件 → 数字孪生引擎
                    ↓
              InfluxDB (时序数据)
                    ↓
              指标计算 → 可视化大屏
```

所有业务关键节点都会发送Kafka事件，数字孪生引擎实时消费并计算KPI指标。

## 🔐 安全特性

- JWT认证授权
- RBAC权限模型
- API限流保护
- 熔断降级
- 请求日志追踪

## 📈 性能优化

- Redis缓存加速
- 数据库连接池
- 异步消息处理
- 文件秒传去重
- WebSocket长连接

## 🧪 开发调试

### 查看服务日志
```bash
# 查看特定服务日志
tail -f backend/message-service/logs/application.log
```

### 测试API
```bash
# 登录获取Token
curl -X POST http://localhost:8080/api/users/login \
  -H "Content-Type: application/json" \
  -d '{"usernameOrEmail":"admin","password":"admin123"}'

# 使用Token访问受保护API
curl http://localhost:8080/api/conversations \
  -H "Authorization: Bearer <token>"
```

## 📝 开发路线图

- [x] 基础设施搭建
- [x] 即时通讯模块
- [x] 音视频通话
- [x] 文件管理
- [x] AI服务集成
- [x] ERP业务模块
- [x] 数字孪生引擎
- [x] 微信小程序
- [ ] 移动端APP
- [ ] 管理后台
- [ ] 数据报表
- [ ] 工作流引擎

## 🤝 贡献指南

欢迎提交Issue和Pull Request！

## 📄 许可证

MIT License

## 📞 联系方式

- 项目主页: https://github.com/yourname/coai
- 问题反馈: https://github.com/yourname/coai/issues

---

**注意**: 本项目仅供学习交流使用，生产环境部署需要进一步的安全加固和性能优化。