文章目录

• • 第一章：生产环境架构设计
  • • 1.1 架构决策框架
    • • 决策1：Platform vs Self-Hosted vs Library
      • 决策2：Vector Store选型
      • 决策3：LLM Provider选型
    • 1.2 推荐的生产架构
    • 1.3 组件依赖关系
  • 第二章：Self-Hosted Server完整部署指南
  • • 2.1 系统要求
    • 2.2 一键部署（推荐方式）
    • 2.3 手动Docker Compose部署
    • 2.4 环境变量配置
    • 2.5 Nginx配置
    • 2.6 部署脚本
  • 第三章：Docker与Kubernetes部署
  • • 3.1 Docker单机部署
    • 3.2 Kubernetes部署
    • 3.3 Kubernetes Secrets管理
    • 3.4 Helm Chart（可选）
  • 第四章：安全最佳实践
  • • 4.1 认证与授权
    • • 4.1.1 Platform API Key管理
      • 4.1.2 Self-Hosted认证配置
    • 4.2 数据加密
    • • 4.2.1 传输加密
      • 4.2.2 静态数据加密
    • 4.3 网络安全
    • 4.4 输入验证与清理
    • 4.5 审计日志
  • 第五章：性能优化与调优
  • • 5.1 Embedding维度优化
    • 5.2 向量索引优化
    • 5.3 缓存策略
    • 5.4 批处理优化
    • 5.5 异步操作
  • 第六章：监控与可观测性
  • • 6.1 关键指标监控
    • 6.2 健康检查端点
    • 6.3 日志管理
  • 第七章：数据管理与备份策略
  • • 7.1 数据备份方案
    • 7.2 数据恢复流程
    • 7.3 数据生命周期管理
  • 第八章：多租户架构设计
  • • 8.1 租户隔离策略
    • 8.2 租户配额管理
  • 第九章：成本优化策略
  • • 9.1 Token消耗优化
    • 9.2 Embedding成本优化
    • 9.3 缓存节省计算
  • 第十章：高可用与容灾设计
  • • 10.1 高可用架构要点
    • 10.2 故障转移机制
    • 10.3 灾难恢复计划
  • 第十一章：API设计与集成模式
  • • 11.1 RESTful API封装
    • 11.2 WebSocket实时推送
    • 11.3 事件驱动架构
  • 第十二章：测试策略与质量保证
  • • 12.1 单元测试
    • 12.2 集成测试
    • 12.3 性能测试
  • 第十三章：迁移与升级指南
  • • 13.1 OSS v2 → v3 迁移
    • 13.2 OSS → Platform 迁移
    • 13.3 Qdrant Hosted → Platform 迁移
  • 第十四章：常见反模式与陷阱
  • • 14.1 反模式目录
    • 14.2 陷阱案例详解
    • • 陷阱1：记忆爆炸
      • 陷阱2：上下文污染
      • 陷阱3：竞态条件
  • 第十五章：企业级实施清单
  • • 15.1 上线前检查清单
    • 15.2 运维手册模板
    • 版本升级
    • 故障排查