Simon
caf9b7ed85
解决改代码 30-60min 才能看到结果的痛点。本地拉起完整 stack, 改代码 → 1-2min 看到结果,无需服务器。 ## 交付物 ### Docker stack (docker-compose.dev.yml) - postgres:16-alpine 端口 5432 - redis:7-alpine 端口 6379 - backend 端口 8000,代码 volume mount + uvicorn --reload ### Dev 镜像 (backend/Dockerfile.dev) - 单阶段(无需 gcc / libpq-dev) - apt 源换阿里云(公司内网) - 装 pytest pytest-asyncio httpx watchfiles - CMD: uvicorn --reload ### 配置 (.env.dev, 强制 add 因 .env.* 在 .gitignore) 内容是 dev 占位符,无任何真实密钥: - DEV_MODE=true (启用 Mock OAuth) - WECOM_* 全部 dev_xxx 占位 - 集成系统 API 全 dev_ 占位(调用会失败但不影响主流程) ### Mock OAuth (backend/app/api/dev_auth.py) - GET /api/dev/login?userid=xxx&name=xxx&role=xxx 走完全真实的 TokenService.create_token(不绕过业务逻辑) - GET /api/dev/users 列出 6 个预设 dev 用户 - GET /api/dev/health dev 模式状态自检 - 6 预设用户覆盖所有角色(user/agent/supervisor/security/admin/多角色) - 每个端点 _dev_mode_enabled() 二次校验,生产环境访问 403 ### 集成改动 - backend/app/main.py: 加 _is_dev_mode() + DEV_MODE=true 时条件挂载 dev_auth 路由 + 启动时大声警告 - backend/app/config.py: Settings 加 dev_mode / dev_default_userid / dev_default_name / dev_default_dept 字段 ### PowerShell 脚本 - scripts/dev-start.ps1: 5 步验证(检查 Docker / .env / compose / 健康 / dev health),首次 2-5min build,后续秒起 - scripts/dev-stop.ps1: 停止,支持 -v 清数据卷 - scripts/dev-test.ps1: 一键跑 pytest(可选 -Frontend 跑 vitest) ## 阶段 - ✅ Phase 0 基础(本 commit) - ⏳ Phase 1 pytest(任务 #90) - 500 bug 回归测试已就绪 - ⏳ Phase 2 vitest - ⏳ Phase 3 playwright E2E ## 安全保证 - DEV_MODE 三个地方都校验(环境变量/settings/端点内) - 生产环境 /api/dev/* 端点根本不存在(未挂载) - .env.dev 是 dev 占位符,无敏感,可入 git
62 lines
2.7 KiB
Bash
62 lines
2.7 KiB
Bash
# =============================================================================
|
|
# 企微IT智能服务台 — 本地开发环境变量
|
|
# =============================================================================
|
|
# 这是给 docker-compose.dev.yml 用的,不是生产 .env
|
|
# 用法:docker compose -f docker-compose.dev.yml up -d (会自动加载)
|
|
# 安全:此文件可以提交到 git(都是假值,无敏感信息)
|
|
# =============================================================================
|
|
|
|
# --------------------------------------------------------------------------
|
|
# 关键开关:开发模式
|
|
# --------------------------------------------------------------------------
|
|
# DEV_MODE=true 会启用以下 mock:
|
|
# 1. 跳过企微 OAuth(用 /api/dev/login?userid=xxx 直接登)
|
|
# 2. 默认 userid 设为 dev-user-001
|
|
# 3. 跳过 JS-SDK 签名校验
|
|
# 4. 详细日志输出
|
|
DEV_MODE=true
|
|
|
|
# --------------------------------------------------------------------------
|
|
# 数据库(Docker 内部用 service name)
|
|
# --------------------------------------------------------------------------
|
|
POSTGRES_USER=wecom
|
|
POSTGRES_PASSWORD=wecom_dev
|
|
POSTGRES_DB=wecom_it_desk_dev
|
|
DATABASE_URL=postgresql://wecom:wecom_dev@localhost:5432/wecom_it_desk_dev
|
|
REDIS_URL=redis://localhost:6379/0
|
|
|
|
# --------------------------------------------------------------------------
|
|
# 企微(本地用假值,不真调)
|
|
# --------------------------------------------------------------------------
|
|
WECOM_CORP_ID=dev_corp_id_xxxxx
|
|
WECOM_AGENT_ID=1000001
|
|
WECOM_SECRET=dev_secret_placeholder
|
|
WECOM_TOKEN=dev_token_placeholder
|
|
WECOM_ENCODING_AES_KEY=dev_aes_key_43_chars_placeholder_xxxxxxxxx
|
|
|
|
# --------------------------------------------------------------------------
|
|
# 集成(本地用假值,API 调用会失败但不影响主流程)
|
|
# --------------------------------------------------------------------------
|
|
HUORONG_BASE_URL=http://localhost:9999
|
|
HUORONG_ACCESS_KEY_ID=dev_key
|
|
HUORONG_ACCESS_KEY_SECRET=dev_secret
|
|
LIANRUAN_BASE_URL=http://localhost:9998
|
|
LIANRUAN_API_ACCOUNT=dev
|
|
LIANRUAN_API_PASSWORD=dev
|
|
RAGFLOW_BASE_URL=http://localhost:9997
|
|
RAGFLOW_API_KEY=dev
|
|
|
|
# --------------------------------------------------------------------------
|
|
# 应用配置
|
|
# --------------------------------------------------------------------------
|
|
APP_ENV=development
|
|
LOG_LEVEL=DEBUG
|
|
CORS_ORIGINS=http://localhost:5173,http://localhost:5174,http://localhost:5175,http://localhost:5176
|
|
|
|
# --------------------------------------------------------------------------
|
|
# Mock 用户(DEV_MODE=true 时)
|
|
# --------------------------------------------------------------------------
|
|
DEV_DEFAULT_USERID=dev-user-001
|
|
DEV_DEFAULT_NAME=开发测试用户
|
|
DEV_DEFAULT_DEPT=信息技术部
|