Start AI knowledge base v2 workspace

2026-07-06 16:55:03 +08:00
parent 708e0a424e
commit 4eac7351a9
30 changed files with 7720 additions and 0 deletions
--- a/ai_knowledge_base_v2/extracted/10-AI知识库系统部署运维手册_V10.md
+++ b/ai_knowledge_base_v2/extracted/10-AI知识库系统部署运维手册_V10.md
@@ -0,0 +1,398 @@
+# 10-AI知识库系统部署运维手册_V1.0.docx
+
+10
+
+## AI知识库系统部署运维手册
+
+Deployment & Operations Guide
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+系统部署｜环境配置｜上线运维｜监控备份｜故障恢复
+
+## 文档目录
+
+## 第一章 文档说明
+
+### 1.1 编写目的
+
+本文档用于指导系统部署、环境配置、上线、运维、监控、备份及故障恢复。
+
+适用对象：
+
+运维工程师
+
+后端开发工程师
+
+DevOps 工程师
+
+项目实施人员
+
+## 第二章 系统部署架构
+
+### 2.1 总体架构
+
+## 第三章 服务器规划
+
+### 3.1 建议配置（生产环境）
+
+### 3.2 环境要求
+
+Linux（Ubuntu LTS 或 CentOS Stream）
+
+Docker（如采用容器化）
+
+MySQL 8.x
+
+Redis 7.x
+
+Nginx 最新稳定版
+
+Git
+
+## 第四章 环境变量配置
+
+建议使用 .env 或配置中心统一管理。
+
+## 第五章 数据库初始化
+
+部署步骤：
+
+1. 创建数据库。
+
+2. 执行建表 SQL。
+
+3. 初始化基础数据。
+
+4. 创建超级管理员。
+
+5. 验证连接。
+
+初始化内容包括：
+
+管理员角色
+
+超级管理员账号
+
+默认 Prompt
+
+默认系统配置
+
+默认模型配置
+
+## 第六章 Redis 使用说明
+
+Redis 用于：
+
+登录验证码缓存
+
+Token 黑名单（如采用）
+
+高频配置缓存（可选）
+
+建议：
+
+开启持久化
+
+设置合理内存上限
+
+定期监控命中率
+
+## 第七章 Nginx 配置建议
+
+建议开启：
+
+HTTPS
+
+HTTP/2（如适用）
+
+Gzip 压缩
+
+SSE 长连接支持
+
+静态资源缓存
+
+反向代理：
+
+## 第八章 AI 服务配置
+
+启动前检查：
+
+AI API Key 正确
+
+飞书配置正确
+
+Prompt 已初始化
+
+默认模型已启用
+
+启动后验证：
+
+AI 可正常调用
+
+飞书可正常检索
+
+SSE 流式输出正常
+
+## 第九章 上线流程
+
+建议流程：
+
+上线验证重点：
+
+登录
+
+AI 聊天
+
+飞书检索
+
+后台管理
+
+权限控制
+
+## 第十章 日志管理
+
+建议分类：
+
+建议：
+
+日志按天滚动
+
+保留周期可配置
+
+重要日志集中采集（如 ELK、Loki 等）
+
+## 第十一章 数据备份
+
+### 11.1 数据库
+
+建议：
+
+每日增量备份
+
+每周完整备份
+
+异地备份（如有条件）
+
+### 11.2 配置文件
+
+备份：
+
+环境变量
+
+Nginx 配置
+
+系统配置
+
+## 第十二章 系统监控
+
+建议监控：
+
+告警建议：
+
+服务不可用
+
+AI 超时率异常
+
+数据库连接异常
+
+Redis 不可用
+
+HTTPS 证书即将过期
+
+## 第十三章 故障处理
+
+### 13.1 飞书不可用
+
+处理：
+
+1. 检查飞书接口状态
+
+2. 检查 App 凭证
+
+3. 查看 AI 请求日志
+
+4. 重试验证
+
+### 13.2 AI 模型不可用
+
+处理：
+
+1. 检查 API Key
+
+2. 检查模型配置
+
+3. 查看请求日志
+
+4. 必要时切换备用模型（如后续版本支持）
+
+### 13.3 数据库异常
+
+处理：
+
+1. 检查数据库状态
+
+2. 查看慢 SQL
+
+3. 检查磁盘空间
+
+4. 恢复备份（必要时）
+
+## 第十四章 回滚方案
+
+发生重大故障时：
+
+1. 停止新版本服务
+
+2. 恢复上一版本程序
+
+3. 恢复数据库（如涉及数据结构变更）
+
+4. 验证核心功能
+
+5. 恢复对外服务
+
+## 第十五章 运维检查清单
+
+### 15.1 每日检查
+
+☑ 服务运行状态
+
+☑ AI 请求成功率
+
+☑ 飞书接口状态
+
+☑ 数据库运行状态
+
+☑ Redis 状态
+
+☑ 日志是否正常
+
+### 15.2 每周检查
+
+☑ 数据备份验证
+
+☑ 磁盘空间检查
+
+☑ SSL 证书检查
+
+☑ 系统安全更新评估
+
+## 《部署运维手册》V1.0 完成
+
+本手册覆盖了：
+
+系统部署架构
+
+环境配置
+
+数据库初始化
+
+Redis 与 Nginx 配置建议
+
+AI 服务部署
+
+上线流程
+
+日志管理
+
+数据备份
+
+系统监控
+
+故障处理
+
+回滚方案
+
+运维巡检清单
+
+## Table 1
+| 项目名称 | AI 企业知识库问答系统 |
+| --- | --- |
+| 文档版本 | V1.0 |
+| 适用版本 | V1.0 |
+
+## Table 2
+| 01 | 第一章 文档说明 |
+| --- | --- |
+| 02 | 第二章 系统部署架构 |
+| 03 | 第三章 服务器规划 |
+| 04 | 第四章 环境变量配置 |
+| 05 | 第五章 数据库初始化 |
+| 06 | 第六章 Redis 使用说明 |
+| 07 | 第七章 Nginx 配置建议 |
+| 08 | 第八章 AI 服务配置 |
+| 09 | 第九章 上线流程 |
+| 10 | 第十章 日志管理 |
+| 11 | 第十一章 数据备份 |
+| 12 | 第十二章 系统监控 |
+| 13 | 第十三章 故障处理 |
+| 14 | 第十四章 回滚方案 |
+| 15 | 第十五章 运维检查清单 |
+
+## Table 3
+| Internet                       │                 HTTPS / 443                       │                  Nginx 反向代理                       │         ┌─────────────┴─────────────┐         │                           │    用户端（H5/Web）           管理后台（Admin）         │                           │         └─────────────┬─────────────┘                       │                  Backend API                       │         ┌─────────────┼─────────────┐         │             │             │      AI Service     Redis        MySQL         │         ▼  飞书知识库 API + AI 模型 API |
+| --- |
+
+## Table 4
+| 服务 | CPU | 内存 | 磁盘 |
+| --- | --- | --- | --- |
+| Nginx | 2 核 | 2 GB | 20 GB |
+| Backend | 4 核 | 8 GB | 50 GB |
+| AI Service | 4 核 | 8 GB | 50 GB |
+| MySQL | 8 核 | 16 GB | 200 GB SSD |
+| Redis | 2 核 | 4 GB | 20 GB |
+
+## Table 5
+| 配置项 | 说明 |
+| --- | --- |
+| DB_HOST | 数据库地址 |
+| DB_PORT | 数据库端口 |
+| DB_NAME | 数据库名称 |
+| DB_USER | 数据库账号 |
+| DB_PASSWORD | 数据库密码 |
+| REDIS_HOST | Redis 地址 |
+| REDIS_PORT | Redis 端口 |
+| JWT_SECRET | JWT 密钥 |
+| FEISHU_APP_ID | 飞书应用 ID |
+| FEISHU_APP_SECRET | 飞书密钥 |
+| AI_API_URL | AI 接口地址 |
+| AI_API_KEY | AI 接口密钥 |
+
+## Table 6
+| 安全建议：所有密钥均通过环境变量或密钥管理系统保存，不写入源码仓库。 |
+| --- |
+
+## Table 7
+| 访问路径 | 代理目标 |
+| --- | --- |
+| /api/* | Backend |
+| /admin/* | 管理后台 |
+| / | 用户端 |
+
+## Table 8
+| 代码发布     │ 数据库升级     │ 配置环境变量     │ 启动 Redis     │ 启动 MySQL     │ 启动 Backend     │ 启动 AI Service     │ 启动 Nginx     │ 功能验证     │ 正式开放访问 |
+| --- |
+
+## Table 9
+| 日志类型 | 内容 |
+| --- | --- |
+| 应用日志 | 系统运行日志 |
+| AI 日志 | AI 请求与响应 |
+| 操作日志 | 后台管理员操作 |
+| 登录日志 | 登录记录 |
+| 错误日志 | 异常与堆栈信息 |
+
+## Table 10
+| 指标 | 建议 |
+| --- | --- |
+| CPU 使用率 | <80% |
+| 内存使用率 | <80% |
+| MySQL 连接数 | 持续监控 |
+| Redis 内存 | 持续监控 |
+| AI 请求耗时 | 持续监控 |
+| 飞书接口异常率 | 持续监控 |
+
+## Table 11
+| 发布要求：所有发布建议保留可回滚版本。 |
+| --- |