.env.example

# ============================================
# CodaGraph-lite 环境变量配置
# ============================================

# ============================================
# 服务器配置
# ============================================
# 前端服务端口
FRONTEND_PORT=3000

# 后端服务端口
BACKEND_PORT=7900

# Node.js 内存限制 (2u2g 服务器关键配置)
NODE_OPTIONS=--max-old-space-size=200

# ============================================
# 数据库配置 (SQLite)
# ============================================
# SQLite 数据库文件路径
DATABASE_PATH=./data/codagraph-lite.db

# SQLite 缓存大小 (2u2g 服务器优化: 2MB)
SQLITE_CACHE_SIZE=-2000

# ============================================
# 任务队列配置
# ============================================
# 工作进程数量 (2u2g 服务器关键: 必须为 1)
WORKER_COUNT=1

# 禁用并发任务 (2u2g 服务器关键: 必须为 false)
ENABLE_CONCURRENT_JOBS=false

# 任务队列轮询间隔 (秒)
JOB_QUEUE_POLL_INTERVAL=2

# ============================================
# 单管理员认证配置
# ============================================
# 管理员用户名
ADMIN_USERNAME=admin

# 管理员密码 (生产环境请使用强密码)
ADMIN_PASSWORD=changeme

# Session 过期时间 (秒)
SESSION_TIMEOUT=86400

# 免登录模式 (仅适用于纯本地部署、不对外暴露的场景)
# 警告：启用后任何能访问本服务的用户都无需登录，存在安全风险！
# 默认关闭，纯本地部署可设置为 true
NO_LOGIN_MODE=false

# ============================================
# OAuth 集成配置
# ============================================

# GitHub OAuth 配置
GITHUB_CLIENT_ID=your_github_client_id
GITHUB_CLIENT_SECRET=your_github_client_secret
GITHUB_CALLBACK_URL=http://localhost:7900/api/oauth/github/callback

# GitHub App 配置（用于以 App 身份同步仓库和发布 review）
GITHUB_APP_ID=your_github_app_id
GITHUB_APP_CLIENT_ID=your_github_app_client_id
GITHUB_APP_CLIENT_SECRET=your_github_app_client_secret
GITHUB_APP_SLUG=your_github_app_slug
GITHUB_APP_REDIRECT_URI=http://localhost:3000/app/github/callback
GITHUB_APP_PRIVATE_KEY_PATH=./secrets/github-app-private-key.pem

# Gitee OAuth 配置
GITEE_CLIENT_ID=your_gitee_client_id
GITEE_CLIENT_SECRET=your_gitee_client_secret
GITEE_CALLBACK_URL=http://localhost:3000/app/gitee/callback

# GitLab OAuth 配置
GITLAB_CLIENT_ID=your_gitlab_client_id
GITLAB_CLIENT_SECRET=your_gitlab_client_secret
GITLAB_CALLBACK_URL=http://localhost:3000/app/gitlab/callback

# ============================================
# Context Agent / Review Runtime 配置
# ============================================

# Context Agent 配置
CONTEXT_AGENT_PORT=50052
CONTEXT_AGENT_HOST=localhost
# Context Agent 超时 (毫秒)
AGENT_TIMEOUT_CONTEXT=300000

# In-process review runtime 超时 (毫秒)
AGENT_TIMEOUT_REVIEW=600000

# Python 内存限制 (2u2g 服务器关键配置)
PYTHON_MEMORY_LIMIT=300m

# ============================================
# Code Context Engine runtime 配置
# ============================================

# review engine 默认会尝试加载 sibling 目录的 ../CodeContextEngine
CODE_CONTEXT_ENGINE_ROOT=../CodeContextEngine

# Code Context Engine runtime 内存预算
CODE_CONTEXT_ENGINE_MAX_MEMORY=512m

# 仓库工作空间路径
WORKSPACE_ROOT=/tmp/repos

# ============================================
# 资源监控配置 (2u2g 服务器优化)
# ============================================

# 启用 Swap 警告
ENABLE_SWAP_WARNING=true

# 内存警告阈值 (百分比)
MEMORY_WARNING_THRESHOLD=80

# 内存严重阈值 (百分比)
MEMORY_CRITICAL_THRESHOLD=95

# ============================================
# 日志配置
# ============================================

# 日志级别 (debug, info, warn, error)
LOG_LEVEL=info

# 日志文件路径
LOG_PATH=./logs

# 启用请求日志
ENABLE_REQUEST_LOGGING=true

# ============================================
# 安全配置
# ============================================

# Session 密钥 (生产环境请更改)
SESSION_SECRET=changeme_to_secure_random_string

# 启用 HTTPS (生产环境建议启用)
ENABLE_HTTPS=false

# HTTPS 证书路径 (启用 HTTPS 时需要)
HTTPS_CERT_PATH=
HTTPS_KEY_PATH=

# ============================================
# Webhook 配置
# ============================================

# Webhook 密钥 (用于签名验证)
WEBHOOK_SECRET=changeme_to_random_webhook_secret

# ============================================
# CORS 配置
# ============================================

# 允许的源 (逗号分隔，支持多个可信域名或 * )
CORS_ORIGINS=http://localhost:3000,http://127.0.0.1:3000

# 允许的方法
CORS_METHODS=GET,POST,PUT,PATCH,DELETE,OPTIONS

# ============================================
# LLM 服务配置
# ============================================

# LLM 提供商（用于初始化默认 LLM 配置；更多配置可在设置页新增和切换）
LLM_PROVIDER=openai

# LLM API 密钥（用于初始化默认 LLM 配置）
LLM_API_KEY=your_llm_api_key

# LLM 模型名称（用于初始化默认 LLM 配置）
LLM_MODEL=gpt-4

# LLM API 端点（如果使用自定义端点，用于初始化默认 LLM 配置）
LLM_API_BASE_URL=

# LLM 最大重试次数（用于初始化默认 LLM 配置）
LLM_MAX_RETRIES=3

# ============================================
# Review 模式配置
# ============================================

# 全局默认 review 模式:
# - normal: 普通 Review
# - improve: 所有手动/重试 Review 默认记录结构化 trace
REVIEW_DEFAULT_MODE=normal

# ============================================
# 其他配置
# ============================================

# 时区
TIMEZONE=Asia/Shanghai

# 区域设置
LOCALE=zh-CN

# 数据库备份路径
BACKUP_PATH=./backups

# 启用自动备份
ENABLE_AUTO_BACKUP=true

# 备份间隔 (小时)
BACKUP_INTERVAL_HOURS=24