ai-cs/.env.example

# ============================================
# AI-CS 统一配置模板（唯一真源）
# 使用方法：
# 1) 复制为项目根目录 .env
# 2) 按注释填写必填项
# 3) Docker 与本地启动都读取这同一份配置
# ============================================

# =========================
# 运行画像（建议配置）
# =========================
# 可选：docker / local
# - docker：DB_HOST/MILVUS_HOST 通常填写服务名（mysql、milvus-standalone）
# - local：DB_HOST/MILVUS_HOST 通常填写 localhost 或远程地址
APP_PROFILE=docker

# =========================
# 服务监听（必填）
# =========================
SERVER_HOST=0.0.0.0
SERVER_PORT=8080
# 建议：生产 release，开发 debug
GIN_MODE=release

# =========================
# 结构化日志（日志中心 / system_logs 表）
# =========================
# 仅将「不低于该级别」的日志写入数据库，减轻成功类 info 的写入量。
# 可选：debug | info（默认）| warn | error | none（关闭全部落库，日志中心无新记录）
# 若在「日志中心」保存了落库级别，会写入 app_settings 表并覆盖此处，直至在页面点「恢复环境变量」
SYSTEM_LOG_MIN_LEVEL=info

# =========================
# 数据库（必填）
# =========================
DB_HOST=mysql
DB_PORT=3306
DB_USER=ai_cs_user
DB_PASSWORD=please_change_me
DB_NAME=ai_cs

# MySQL 容器 root 密码（Docker 部署必填）
MYSQL_ROOT_PASSWORD=please_change_root_password
# MySQL 对外端口（非必须）
MYSQL_PORT=3306

# =========================
# 管理员与安全（必填）
# =========================
ADMIN_USERNAME=admin
ADMIN_PASSWORD=please_change_admin_password
# 64 位十六进制密钥（必填）
# 生成示例：openssl rand -hex 32
ENCRYPTION_KEY=please_generate_64_hex_chars

# =========================
# Redis（按需配置，多实例推荐）
# 说明：
# - 单实例可留空
# - 多实例可配置 REDIS_URL，或使用 REDIS_ADDR + REDIS_PASSWORD + REDIS_DB
# =========================
REDIS_URL=
REDIS_ADDR=
REDIS_PASSWORD=
REDIS_DB=0
# WebSocket 分布式事件频道（一般无需修改）
REDIS_WS_CHANNEL=ai_cs:ws_events

# =========================
# 会话维护（Demo/生产可选）
# =========================
# 自动关闭超过 N 天未更新的 open 访客会话；设为 0 禁用
AUTO_CLOSE_CONVERSATION_DAYS=7

# =========================
# 离线邮件通知（按需配置）
# 访客离线且已留邮箱时，客服人工消息延迟推送邮件；也可在「设置 → 离线邮件通知」页面配置
# =========================
# 是否启用（true/false/1/0）
OFFLINE_EMAIL_ENABLED=false
# 客服发消息后等待秒数再发邮件（默认 60）；访客在此期间上线则取消
OFFLINE_EMAIL_DELAY_SECONDS=60
# 云厂商 SMTP（如阿里云邮件推送：smtpdm.aliyun.com:465）
SMTP_HOST=
SMTP_PORT=465
SMTP_USER=
SMTP_PASSWORD=
SMTP_FROM_EMAIL=
SMTP_FROM_NAME=

# =========================
# 访客 IP 地理位置（ip2region 离线库，可选）
# =========================
# true 时关闭解析；Docker 镜像内已内置 v4+v6 数据文件
IP2REGION_DISABLED=false
# 自定义 xdb 路径（本地开发：sh scripts/download-ip2region-xdb.sh）
# IP2REGION_V4_XDB=backend/data/ip2region_v4.xdb
# IP2REGION_V6_XDB=backend/data/ip2region_v6.xdb

# =========================
# 端口映射（非必须）
# =========================
# 后端映射到宿主机端口（host:container = BACKEND_PORT:SERVER_PORT）
BACKEND_PORT=18080
# 前端映射到宿主机端口
FRONTEND_PORT=3000

# =========================
# 向量库 Milvus（按需配置）
# 仅在使用知识库/RAG时需要
# =========================
MILVUS_HOST=milvus-standalone
MILVUS_PORT=19530
MILVUS_USERNAME=
MILVUS_PASSWORD=

# true 表示禁用向量库（不连接 Milvus）
MILVUS_DISABLED=false
# 与 MILVUS_DISABLED 含义相同，保留为兼容开关
VECTOR_STORE_DISABLED=false
# true 表示强依赖 Milvus（连接失败则启动失败）
MILVUS_REQUIRED=false

# RAG 向量检索最低相似度（0~1，分段场景默认 0.22；过高会导致「搜不到」）
# RAG_MIN_SCORE=0.22

# =========================
# 联网搜索（按需配置）
# 使用联网搜索功能时至少配置一种
# =========================
# 方式一：Serper MCP 服务地址
SERPER_MCP_URL=
# 方式二：Serper API Key
SERPER_API_KEY=

# =========================
# 前端公开变量（按需配置）
# 说明：NEXT_PUBLIC_* 会暴露到浏览器端
# =========================
# 非必填：站点对外的绝对地址（https://你的域名），用于 SEO（canonical、OG、sitemap）。未填时前端默认使用演示站域名。
NEXT_PUBLIC_SITE_URL=

NEXT_PUBLIC_API_BASE_URL=http://localhost:18080
NEXT_PUBLIC_BACKEND_HOST=localhost
NEXT_PUBLIC_BACKEND_PORT=8080
NEXT_PUBLIC_MATOMO_CONTAINER_URL=

# =========================
# 预构建镜像（docker-compose.prod.yml 必填）
# =========================
BACKEND_IMAGE=537yaha/ai-cs-backend:latest
FRONTEND_IMAGE=537yaha/ai-cs-frontend:latest