e093995368
主要改进: - Agent 增强: 订单查询、售后支持、客服路由等功能优化 - 新增语言检测和 Token 管理模块 - 改进 Chatwoot webhook 处理和用户标识 - MCP 服务器增强: 订单 MCP 和 Strapi MCP 功能扩展 - 新增商城客户端、知识库、缓存和同步模块 - 添加多语言提示词系统 (YAML) - 完善项目结构: 整理文档、脚本和测试文件 - 新增调试和测试工具脚本 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
109 lines
2.9 KiB
Markdown
109 lines
2.9 KiB
Markdown
# 端口规划方案
|
||
|
||
本文档定义了 B2B AI Shopping Assistant 项目的端口分配规范。
|
||
|
||
## 📋 端口分配总览
|
||
|
||
### 1️⃣ 基础设施层 (3000-3999)
|
||
|
||
用于前端界面、Web 控制台等面向用户的服务。
|
||
|
||
| 端口 | 服务 | 说明 | 状态 |
|
||
|------|------|------|------|
|
||
| 3000 | Chatwoot | 客户支持平台主界面 | ✅ 使用中 |
|
||
| 3001-3009 | - | 预留给 Web 界面服务 | 🔄 预留 |
|
||
| 3010-3099 | - | 预留给基础设施扩展 | 🔄 预留 |
|
||
|
||
### 2️⃣ 应用服务层 (8000-8999)
|
||
|
||
核心 AI 和 MCP 后端服务。
|
||
|
||
| 端口 | 服务 | 说明 | 状态 |
|
||
|------|------|------|------|
|
||
| 8000 | Agent | LangGraph AI Agent 主服务 | ✅ 使用中 |
|
||
| 8001 | Strapi MCP | 知识库和 FAQ 服务 | ✅ 使用中 |
|
||
| 8002 | Order MCP | 订单查询服务 | ✅ 使用中 |
|
||
| 8003 | Aftersale MCP | 售后服务 | ✅ 使用中 |
|
||
| 8004 | Product MCP | 商品服务 | ✅ 使用中 |
|
||
| 8005-8009 | - | 预留给其他 MCP 服务 | 🔄 预留 |
|
||
| 8010-8099 | - | 预留给应用服务扩展 | 🔄 预留 |
|
||
|
||
### 3️⃣ 静态资源服务 (8080-8099)
|
||
|
||
用于静态文件托管、反向代理等。
|
||
|
||
| 端口 | 服务 | 说明 | 状态 |
|
||
|------|------|------|------|
|
||
| 8080 | Nginx | 静态文件服务器 (测试页面等) | ✅ 使用中 |
|
||
| 8081-8099 | - | 预留给其他静态资源服务 | 🔄 预留 |
|
||
|
||
### 4️⃣ 内部通信 (9000+)
|
||
|
||
**注意**：此区间端口仅用于容器内部通信，不对外暴露。
|
||
|
||
| 服务 | 内部端口 | 说明 |
|
||
|------|----------|------|
|
||
| PostgreSQL | 5432 | 仅容器内部访问 |
|
||
| Redis | 6379 | 仅容器内部访问 |
|
||
|
||
## 🔧 访问地址
|
||
|
||
### 生产/开发环境
|
||
|
||
```bash
|
||
# Chatwoot 客服平台
|
||
http://localhost:3000
|
||
|
||
# Nginx 静态文件 (测试页面)
|
||
http://localhost:8080/test-chat.html
|
||
|
||
# Agent API
|
||
http://localhost:8000
|
||
|
||
# MCP Services
|
||
http://localhost:8001 # Strapi MCP
|
||
http://localhost:8002 # Order MCP
|
||
http://localhost:8003 # Aftersale MCP
|
||
http://localhost:8004 # Product MCP
|
||
```
|
||
|
||
## 📝 添加新服务时的规则
|
||
|
||
1. **按功能选择端口区间**
|
||
- 前端界面 → 3000-3999
|
||
- 后端 API → 8000-8999
|
||
- 静态资源/代理 → 8080-8099
|
||
|
||
2. **查看预留端口**
|
||
- 优先使用预留端口范围内的空闲端口
|
||
- 避免跨区间分配
|
||
|
||
3. **更新文档**
|
||
- 添加新服务后更新本文档
|
||
- 标注端口用途和服务说明
|
||
|
||
4. **保持连续性**
|
||
- 相关服务尽量使用连续的端口
|
||
- 便于记忆和管理
|
||
|
||
## 🔍 端口冲突排查
|
||
|
||
如果遇到端口冲突：
|
||
|
||
```bash
|
||
# 检查端口占用
|
||
lsof -i :<端口>
|
||
netstat -tulpn | grep <端口>
|
||
|
||
# Docker 容器查看
|
||
docker ps
|
||
docker-compose ps
|
||
```
|
||
|
||
## 📌 注意事项
|
||
|
||
- ⚠️ **不要使用 3000-3999 范围以外的端口作为前端服务**
|
||
- ⚠️ **MCP 服务必须使用 8000-8999 范围**
|
||
- ⚠️ **所有数据库端口（5432, 6379 等）仅内部访问，不要映射到宿主机**
|
||
- ✅ **添加新服务前先检查端口规划文档**
|