backend/.env.example

# 运行环境
# dev：本地开发环境（debug 日志、关闭限流、允许所有 CORS）
# prod：生产环境（info 日志、启用限流、严格 CORS 白名单）
# 本地开发保持 dev，生产部署会被 docker-compose.yml 覆盖为 prod
APP_ENV=dev

# AI 服务 API Key
CAMTALK_AI_STT_API_KEY=sk-your-stt-key
CAMTALK_AI_LLM_API_KEY=sk-your-llm-key
CAMTALK_AI_TTS_API_KEY=sk-your-tts-key

# JWT 认证
CAMTALK_AUTH_JWT_SECRET=your-jwt-secret-here

# 三级存储配置
# L2: Redis（热数据分布式会话层）
CAMTALK_STORAGE_REDIS_ENABLED=true
# 开发时填写远程服务器地址，部署时 docker-compose 会覆盖为容器内网地址
CAMTALK_REDIS_ADDR=your-remote-server:6379
CAMTALK_REDIS_PASSWORD=your-redis-password

# L3: PostgreSQL（冷数据持久化层）
CAMTALK_STORAGE_PERSISTENCE_ENABLED=true
CAMTALK_STORAGE_PERSISTENCE_DRIVER=postgres
POSTGRES_USER=camtalk
POSTGRES_PASSWORD=your-postgres-password
# 开发时填写远程服务器地址，部署时 docker-compose 会覆盖为容器内网地址
CAMTALK_STORAGE_DSN=postgres://camtalk:your-postgres-password@your-remote-server:5432/camtalk?sslmode=disable

# 可选覆盖（默认值见 config.yaml）
# CAMTALK_SERVER_PORT=8080
# CAMTALK_LOG_LEVEL=info
-												refactor: 统一配置文件系统

- 补全 backend/config.yaml 所有非敏感配置项并添加中文注释
- 重写 config.go：Load(workDir) 显式传参，BindEnv 绑定敏感字段，删除 AutomaticEnv
- setDefaults 默认值与 config.yaml 保持一致（mimo/dashscope）
- backend/.env.example 重写为纯敏感信息模板
- .env 固定在 /opt/camtalk/.env，docker-compose 通过绝对路径加载
- deploy.sh 统一使用 --env-file，移除硬编码 IP
- deploy.yml 删除 CI 写入 .env 的步骤
- Dockerfile 移除 COPY config.yaml
- 修复 deploy.yml 中 POSTGRES_PASSWORD 的 &{{ 拼写错误

											
										
										
											2026-06-19 18:41:35 +08:00
+								# 运行环境
-												docs: 完善配置环境切换机制

- docker-compose.yml 添加 APP_ENV=prod 强制生产环境
- 更新 .env.example 的 APP_ENV 注释说明（开发/生产差异）
- CLAUDE.md 补充"配置环境切换"章节，说明本地开发和生产部署的配置切换方式
- 明确配置优先级：环境变量 > config.{env}.yaml > config.yaml > 默认值

配置差异：
- 开发环境：debug 日志、关闭限流、允许所有 CORS
- 生产环境：info/json 日志、启用限流、严格 CORS 白名单

验证通过：
- 本地开发：默认加载 config.dev.yaml（env=dev, debug 日志）
- 生产配置：APP_ENV=prod 加载 config.prod.yaml（env=prod, info 日志）

											
										
										
											2026-06-21 01:14:29 +08:00
+								# dev：本地开发环境（debug 日志、关闭限流、允许所有 CORS）
 								# prod：生产环境（info 日志、启用限流、严格 CORS 白名单）
 								# 本地开发保持 dev，生产部署会被 docker-compose.yml 覆盖为 prod
-												refactor: 统一配置文件系统

- 补全 backend/config.yaml 所有非敏感配置项并添加中文注释
- 重写 config.go：Load(workDir) 显式传参，BindEnv 绑定敏感字段，删除 AutomaticEnv
- setDefaults 默认值与 config.yaml 保持一致（mimo/dashscope）
- backend/.env.example 重写为纯敏感信息模板
- .env 固定在 /opt/camtalk/.env，docker-compose 通过绝对路径加载
- deploy.sh 统一使用 --env-file，移除硬编码 IP
- deploy.yml 删除 CI 写入 .env 的步骤
- Dockerfile 移除 COPY config.yaml
- 修复 deploy.yml 中 POSTGRES_PASSWORD 的 &{{ 拼写错误

											
										
										
											2026-06-19 18:41:35 +08:00
+								APP_ENV=dev
 								# AI 服务 API Key
 								CAMTALK_AI_STT_API_KEY=sk-your-stt-key
 								CAMTALK_AI_LLM_API_KEY=sk-your-llm-key
 								CAMTALK_AI_TTS_API_KEY=sk-your-tts-key
 								# JWT 认证
 								CAMTALK_AUTH_JWT_SECRET=your-jwt-secret-here
-												feat: 添加 Redis Docker 容器编排及三级存储架构

- docker-compose.yml 新增 Redis 服务及 camtalk-net 桥接网络
- 实现 TieredManager 三级存储（L1 内存 → L2 Redis → L3 PostgreSQL）
- config.go 新增 Redis/Persistence 配置类型及环境变量绑定
- 修复 CAMTALK_REDIS_ADDR 环境变量未被 Viper 绑定的问题
- .env.example 更新为三级存储配置并标注开发/部署地址差异

											
										
										
											2026-06-19 22:53:06 +08:00
+								# 三级存储配置
 								# L2: Redis（热数据分布式会话层）
 								CAMTALK_STORAGE_REDIS_ENABLED=true
 								# 开发时填写远程服务器地址，部署时 docker-compose 会覆盖为容器内网地址
 								CAMTALK_REDIS_ADDR=your-remote-server:6379
 								CAMTALK_REDIS_PASSWORD=your-redis-password
 								# L3: PostgreSQL（冷数据持久化层）
 								CAMTALK_STORAGE_PERSISTENCE_ENABLED=true
 								CAMTALK_STORAGE_PERSISTENCE_DRIVER=postgres
-												refactor: 统一配置文件系统

- 补全 backend/config.yaml 所有非敏感配置项并添加中文注释
- 重写 config.go：Load(workDir) 显式传参，BindEnv 绑定敏感字段，删除 AutomaticEnv
- setDefaults 默认值与 config.yaml 保持一致（mimo/dashscope）
- backend/.env.example 重写为纯敏感信息模板
- .env 固定在 /opt/camtalk/.env，docker-compose 通过绝对路径加载
- deploy.sh 统一使用 --env-file，移除硬编码 IP
- deploy.yml 删除 CI 写入 .env 的步骤
- Dockerfile 移除 COPY config.yaml
- 修复 deploy.yml 中 POSTGRES_PASSWORD 的 &{{ 拼写错误

											
										
										
											2026-06-19 18:41:35 +08:00
+								POSTGRES_USER=camtalk
 								POSTGRES_PASSWORD=your-postgres-password
-												feat: 添加 Redis Docker 容器编排及三级存储架构

- docker-compose.yml 新增 Redis 服务及 camtalk-net 桥接网络
- 实现 TieredManager 三级存储（L1 内存 → L2 Redis → L3 PostgreSQL）
- config.go 新增 Redis/Persistence 配置类型及环境变量绑定
- 修复 CAMTALK_REDIS_ADDR 环境变量未被 Viper 绑定的问题
- .env.example 更新为三级存储配置并标注开发/部署地址差异

											
										
										
											2026-06-19 22:53:06 +08:00
+								# 开发时填写远程服务器地址，部署时 docker-compose 会覆盖为容器内网地址
 								CAMTALK_STORAGE_DSN=postgres://camtalk:your-postgres-password@your-remote-server:5432/camtalk?sslmode=disable
-												refactor: 统一配置文件系统

- 补全 backend/config.yaml 所有非敏感配置项并添加中文注释
- 重写 config.go：Load(workDir) 显式传参，BindEnv 绑定敏感字段，删除 AutomaticEnv
- setDefaults 默认值与 config.yaml 保持一致（mimo/dashscope）
- backend/.env.example 重写为纯敏感信息模板
- .env 固定在 /opt/camtalk/.env，docker-compose 通过绝对路径加载
- deploy.sh 统一使用 --env-file，移除硬编码 IP
- deploy.yml 删除 CI 写入 .env 的步骤
- Dockerfile 移除 COPY config.yaml
- 修复 deploy.yml 中 POSTGRES_PASSWORD 的 &{{ 拼写错误

											
										
										
											2026-06-19 18:41:35 +08:00
 								# 可选覆盖（默认值见 config.yaml）
 								# CAMTALK_SERVER_PORT=8080
 								# CAMTALK_LOG_LEVEL=info