init: 数字员工平台初始代码
包含前端（Vue3 + VueFlow 画布）、后端（Go）、文档体系。 - 工作台画布：节点拖放、连线模式、右键菜单、AI 助手 - 后端：连接器 API、专员种子数据 - 导航：左侧导航、工坊、市场、控制台
This commit is contained in:
eaiadmin
+222
@@ -0,0 +1,222 @@
|
||||
# eaisalestrain_app — 部署文档
|
||||
|
||||
> **版本：V1.2 | 部署模式：纯本地离线 · Go 单二进制 · MySQL 8.0 + FAISS · systemd · Clonezilla 整盘克隆**
|
||||
> **最后更新：2026-08-16**
|
||||
|
||||
---
|
||||
|
||||
## 部署拓扑
|
||||
|
||||
```
|
||||
┌──────────────────────┐
|
||||
│ 内网员工浏览器 │
|
||||
│ http://train.bosun │
|
||||
└──────────┬───────────┘
|
||||
│
|
||||
┌─────▼──────┐
|
||||
│ Nginx │
|
||||
│ :80 / :443 │
|
||||
│ │
|
||||
│ · 前端静态 │
|
||||
│ · API 反代 │
|
||||
└──┬──────┬──┘
|
||||
│ │
|
||||
┌──────────────┘ └──────────────┐
|
||||
│ │
|
||||
┌─────▼──────────────┐ ┌──────▼───────┐
|
||||
│ Go 单二进制 │ │ Vue 静态打包 │
|
||||
│ eaisalestrain- │ │ /usr/share/ │
|
||||
│ server :8080 │ │ nginx/html │
|
||||
│ (Gin + GORM) │ └──────────────┘
|
||||
└──┬─────┬─────┬─────┘
|
||||
│ │ │
|
||||
┌───────────┘ │ └──────────────┐
|
||||
│ │ │
|
||||
┌─────▼────────┐ ┌─────▼──────┐ ┌────────▼────────┐
|
||||
│ MySQL 8.0 │ │ data/kb_data │ │ LibreOffice + │
|
||||
│ + FAISS │ │ 文件存储 │ │ pdftotext │
|
||||
│ (向量索引) │ │ │ │ (裸进程) │
|
||||
└──────────────┘ └────────────┘ └─────────────────┘
|
||||
│
|
||||
│ 文档转文本
|
||||
▼
|
||||
┌──────────────┐
|
||||
│ 内网 LLM │
|
||||
│ Ollama / │
|
||||
│ vLLM 网关 │
|
||||
│ :11434 │
|
||||
└──────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 服务清单
|
||||
|
||||
| 服务 | 端口 | 说明 |
|
||||
|------|------|------|
|
||||
| Nginx | 80/443 | HTTP 反代 + 前端静态资源托管 |
|
||||
| eaisalestrain-server | 8080 | Go 单二进制后端（Gin + GORM） |
|
||||
| MySQL | 3306 | MySQL 8.0 关系数据（systemd 托管 mysqld） |
|
||||
| FAISS | 内嵌 | 向量索引，由 Go 后端 cgo 内嵌，索引文件 `data/faiss/` |
|
||||
| LibreOffice + pdftotext | 进程内调用 | 裸进程，非容器，文档转文本 |
|
||||
| LLM 服务 | 11434 | 内网 OpenAI 兼容接口（Ollama / vLLM） |
|
||||
|
||||
**无 Docker、无 Python 运行时。** 后端为 Go 单二进制，MySQL 由 systemd 托管，FAISS 内嵌于后端。
|
||||
|
||||
---
|
||||
|
||||
## 目录布局
|
||||
|
||||
```
|
||||
/opt/eaisalestrain/
|
||||
├── eaisalestrain-server # 单二进制（CGO 关闭，静态链接，约 38MB）
|
||||
├── .env # JWT 密钥、LLM 配置等
|
||||
├── data/
|
||||
│ ├── faiss/ # FAISS 向量索引（embedding 向量）
|
||||
│ └── media/ # 素材 + 提取缓存
|
||||
└── docs/
|
||||
└── knowledge_source/ # 知识源 Markdown（待管理员审批入库）
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 安装步骤
|
||||
|
||||
### 1. 环境准备（系统级依赖）
|
||||
|
||||
```bash
|
||||
# 系统依赖：Nginx（前端+反代）+ MySQL 8.0（关系数据）+ LibreOffice + pdftotext（文档转换裸进程）
|
||||
apt update && apt install -y nginx mysql-server libreoffice poppler-utils
|
||||
```
|
||||
|
||||
> LibreOffice 与 pdftotext 均为**裸进程**，由二进制内 `exec` 调用，不跑容器、不监听端口。
|
||||
> MySQL 初始化库与账号（FAISS 向量索引内嵌于后端，无需独立服务）：
|
||||
>
|
||||
> ```sql
|
||||
> CREATE DATABASE eaisalestrain DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci;
|
||||
> CREATE USER 'eaisalestrain'@'127.0.0.1' IDENTIFIED BY '<随机密码>';
|
||||
> GRANT ALL PRIVILEGES ON eaisalestrain.* TO 'eaisalestrain'@'127.0.0.1';
|
||||
> FLUSH PRIVILEGES;
|
||||
> ```
|
||||
|
||||
### 2. 部署后端（单二进制 + systemd）
|
||||
|
||||
```bash
|
||||
# 2.1 拷贝二进制 + 建服务账号
|
||||
sudo install -m 0755 eaisalestrain-server /opt/eaisalestrain/eaisalestrain-server
|
||||
sudo useradd -r -s /usr/sbin/nologin eaisalestrain
|
||||
sudo mkdir -p /opt/eaisalestrain/data/kb_data /opt/eaisalestrain/docs/knowledge_source
|
||||
sudo chown -R eaisalestrain:eaisalestrain /opt/eaisalestrain
|
||||
|
||||
# 2.2 生成 .env（JWT 密钥随机）
|
||||
sudo -u eaisalestrain cp deploy/eaisalestrain.env /opt/eaisalestrain/.env
|
||||
NEW_SECRET=$(python3 -c "import secrets; print(secrets.token_urlsafe(48))")
|
||||
sudo sed -i "s|^JWT_SECRET=.*|JWT_SECRET=$NEW_SECRET|" /opt/eaisalestrain/.env
|
||||
|
||||
# 2.3 安装 systemd 单元并启动
|
||||
sudo install -m 0644 deploy/eaisalestrain.service /etc/systemd/system/eaisalestrain.service
|
||||
sudo systemctl daemon-reload
|
||||
sudo systemctl enable --now eaisalestrain
|
||||
|
||||
# 2.4 验证
|
||||
curl http://127.0.0.1:8080/api/health # {"status":"ok","service":"eaisalestrain-app",...}
|
||||
```
|
||||
|
||||
`.env` 关键项：
|
||||
|
||||
```bash
|
||||
PORT=8080
|
||||
DB_DSN=eaisalestrain:<随机密码>@tcp(127.0.0.1:3306)/eaisalestrain?charset=utf8mb4&parseTime=True&loc=Local
|
||||
JWT_SECRET=<48 字符随机串，交付前生成>
|
||||
LLM_BASE_URL=http://127.0.0.1:11434/v1
|
||||
LLM_MODEL=qwen2.5:7b
|
||||
EMBED_MODEL=bge-m3
|
||||
FAISS_INDEX_DIR=data/faiss
|
||||
KB_DATA_DIR=data/kb_data
|
||||
KNOWLEDGE_SOURCE_DIR=/opt/eaisalestrain/docs/knowledge_source
|
||||
LIBREOFFICE_BIN=/usr/bin/libreoffice
|
||||
PDFTOTEXT_BIN=/usr/bin/pdftotext
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Nginx 配置
|
||||
|
||||
```nginx
|
||||
server {
|
||||
listen 80;
|
||||
server_name train.bosun;
|
||||
|
||||
root /usr/share/nginx/html;
|
||||
index index.html;
|
||||
|
||||
location / {
|
||||
try_files $uri $uri/ /index.html;
|
||||
}
|
||||
|
||||
# API 反代到 Go 单二进制
|
||||
location /api/ {
|
||||
proxy_pass http://127.0.0.1:8080;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
|
||||
# SSE 支持（AI 流式响应）
|
||||
proxy_buffering off;
|
||||
proxy_cache off;
|
||||
proxy_read_timeout 300s;
|
||||
}
|
||||
|
||||
# 媒体预览（Go 静态托管，直接反代）
|
||||
location /media/ {
|
||||
proxy_pass http://127.0.0.1:8080;
|
||||
proxy_set_header Host $host;
|
||||
}
|
||||
|
||||
client_max_body_size 2048M;
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## LLM 服务配置示例
|
||||
|
||||
### 使用 Ollama
|
||||
|
||||
```bash
|
||||
curl -fsSL https://ollama.com/install.sh | sh
|
||||
ollama pull qwen2.5:7b # LLM（中文能力强）
|
||||
ollama pull bge-m3 # 嵌入模型（向量检索）
|
||||
# 默认监听 127.0.0.1:11434，Go 二进制直接走 OpenAI 兼容 /v1 接口
|
||||
```
|
||||
|
||||
### 使用 vLLM
|
||||
|
||||
```bash
|
||||
pip install vllm
|
||||
python -m vllm.entrypoints.openai.api_server \
|
||||
--model /path/to/model --port 11434 --host 0.0.0.0
|
||||
```
|
||||
|
||||
> LLM 配置优先级：`system_config` 表 → `.env`。缺 `llm_base_url` / `llm_model` 时，AI 接口返回 501；知识检索自动降级为关键词匹配，不影响其他模块。
|
||||
|
||||
---
|
||||
|
||||
## 启动/停止
|
||||
|
||||
```bash
|
||||
sudo systemctl restart eaisalestrain # 重启
|
||||
sudo systemctl stop eaisalestrain # 停止
|
||||
sudo systemctl status eaisalestrain # 状态 / 日志
|
||||
journalctl -u eaisalestrain -f # 实时日志
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 交付：Clonezilla 整盘克隆
|
||||
|
||||
1. 原型机完成「交付前清理」（改密、随机 JWT、清测试数据、删源代码）——详见 `backend-go/deploy/DELIVERY.md`。
|
||||
2. Clonezilla `device-device` 整盘复制到同型号客户机。
|
||||
3. 客户机首启即用：systemd 自动拉起，无任何依赖安装步骤。
|
||||
|
||||
> 交付红线：二进制静态链接、无 `.go`/`go.mod` 源码、`.env` 无占位符、管理员密码非默认值、无测试数据、无 `.git` 与 shell 历史。
|
||||
Reference in New Issue
Block a user