4d8bc95063
1. 为ScriptRecommend组件新增customerId参数，支持从父组件传入客户ID 2. 添加动态获取最后一条学员消息的逻辑，从后端API拉取会话历史 3. 为ArchiveMessageEvent类添加Jackson忽略未知属性注解 4. 新增部署文档和项目说明文档AGENTS.md、CLAUDE.md
3.9 KiB
3.9 KiB
Agent Instructions for 九艺AI坐席辅助系统
部署规则（核心）
⚠️ 任何代码修改后必须同步服务器部署
无论前端、后台还是后端，任何代码修改完成后，都必须立即同步到服务器并重新部署，绝对不能只做本地修改就结束。
一、前端 Sidebar 部署
模块路径: frontend/sidebar/
服务器部署路径: /www/wwwroot/deploy-package/frontend/sidebar/
容器名称: ai-assistant-sidebar
访问地址: https://ai.9artedu.com/sidebar/
部署流程
# 1. 本地构建
cd frontend/sidebar && npm run build
# 2. 同步到服务器
scp -r -o StrictHostKeyChecking=no -i root.pem frontend/sidebar/dist/* root@8.133.162.25:/www/wwwroot/deploy-package/frontend/sidebar/dist/
# 3. SSH 登录服务器，重新构建镜像并重启容器
ssh -o StrictHostKeyChecking=no -i root.pem root@8.133.162.25 << 'EOF'
cd /www/wwwroot/deploy-package/frontend/sidebar
docker build -t deploy-package-sidebar .
docker stop ai-assistant-sidebar
docker rm ai-assistant-sidebar
cd /www/wwwroot/deploy-package
docker-compose up -d sidebar
EOF
二、后台 Admin 部署
模块路径: frontend/admin/
服务器部署路径: /www/wwwroot/deploy-package/frontend/admin/
容器名称: ai-assistant-admin
访问地址: https://ai.9artedu.com/admin/
部署流程
# 1. 本地构建
cd frontend/admin && npm run build
# 2. 同步到服务器
scp -r -o StrictHostKeyChecking=no -i root.pem frontend/admin/dist/* root@8.133.162.25:/www/wwwroot/deploy-package/frontend/admin/dist/
# 3. SSH 登录服务器，重新构建镜像并重启容器
ssh -o StrictHostKeyChecking=no -i root.pem root@8.133.162.25 << 'EOF'
cd /www/wwwroot/deploy-package/frontend/admin
docker build -t deploy-package-admin .
docker stop ai-assistant-admin
docker rm ai-assistant-admin
cd /www/wwwroot/deploy-package
docker-compose up -d admin
EOF
三、后端微服务部署
模块路径: backend/*-service/
服务器部署路径: /www/wwwroot/deploy-package/backend/*-service/
技术栈: Spring Boot + Docker Compose
微服务列表
| 服务名 | 容器名 | 端口 | 部署路径 |
|---|---|---|---|
| gateway | ai-assistant-gateway | 8080 | backend/gateway/ |
| auth-service | ai-assistant-auth | 8081 | backend/auth-service/ |
| archive-service | ai-assistant-archive | 8082 | backend/archive-service/ |
| conversation-service | ai-assistant-conversation | 8083 | backend/conversation-service/ |
| intent-service | ai-assistant-intent | 8084 | backend/intent-service/ |
| recommend-service | ai-assistant-recommend | 8085 | backend/recommendation-service/ |
| generation-service | ai-assistant-generation | 8086 | backend/generation-service/ |
| kb-admin-service | ai-assistant-kbadmin | 8087 | backend/kb-admin-service/ |
| analytics-service | ai-assistant-analytics | 8088 | backend/analytics-service/ |
部署流程（以某个服务为例）
# 1. 本地构建 JAR 包（通常在对应服务目录下）
cd backend/auth-service && mvn clean package -DskipTests
# 2. 将 JAR 包同步到服务器的 deploy-package 对应目录
scp -o StrictHostKeyChecking=no -i root.pem target/*.jar root@8.133.162.25:/www/wwwroot/deploy-package/backend/auth-service/
# 3. SSH 登录服务器，重启对应容器
ssh -o StrictHostKeyChecking=no -i root.pem root@8.133.162.25 << 'EOF'
cd /www/wwwroot/deploy-package
docker-compose up -d --build auth-service
EOF
服务器信息
- IP:
8.133.162.25 - SSH 私钥:
root.pem（项目根目录） - 部署根目录:
/www/wwwroot/deploy-package/ - Docker Compose 文件:
/www/wwwroot/deploy-package/docker-compose.yml - 前端站点:
https://ai.9artedu.com/sidebar/ - 后台站点:
https://ai.9artedu.com/admin/ - 代理: 宝塔 Nginx → Docker Nginx (8089) → 各容器