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
103 lines
3.6 KiB
YAML
103 lines
3.6 KiB
YAML
# =============================================================================
|
|
# 企微IT智能服务台 — 本地开发环境 Docker Compose
|
|
# =============================================================================
|
|
# 目标:本地电脑(Windows + Docker Desktop)
|
|
# 用途:开发 + 测试,不依赖企微 OAuth,代码 volume mount 自动 reload
|
|
# 用法:
|
|
# 1. cp .env.example .env.dev (编辑填值,或直接用 .env.dev 模板)
|
|
# 2. docker compose -f docker-compose.dev.yml up -d
|
|
# 3. 前端 4 端各跑 pnpm dev(Vite proxy /api → backend:8000)
|
|
# 启动后:
|
|
# - Backend: http://localhost:8000 (Swagger: /docs)
|
|
# - Postgres: localhost:5432
|
|
# - Redis: localhost:6379
|
|
# =============================================================================
|
|
|
|
services:
|
|
# --------------------------------------------------------------------------
|
|
# PostgreSQL 16 — 开发数据库
|
|
# --------------------------------------------------------------------------
|
|
postgres:
|
|
image: postgres:16-alpine
|
|
container_name: dev_wecom_postgres
|
|
restart: unless-stopped
|
|
environment:
|
|
POSTGRES_USER: ${POSTGRES_USER:-wecom}
|
|
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-wecom_dev}
|
|
POSTGRES_DB: ${POSTGRES_DB:-wecom_it_desk_dev}
|
|
ports:
|
|
- "5432:5432" # 暴露到宿主机,方便用 Navicat/psql 连
|
|
volumes:
|
|
- postgres_dev_data:/var/lib/postgresql/data
|
|
healthcheck:
|
|
test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-wecom}"]
|
|
interval: 5s
|
|
timeout: 5s
|
|
retries: 5
|
|
networks:
|
|
- dev-net
|
|
|
|
# --------------------------------------------------------------------------
|
|
# Redis 7 — 开发缓存
|
|
# --------------------------------------------------------------------------
|
|
redis:
|
|
image: redis:7-alpine
|
|
container_name: dev_wecom_redis
|
|
restart: unless-stopped
|
|
command: redis-server --appendonly yes --save 900 1 --save 300 10
|
|
ports:
|
|
- "6379:6379"
|
|
volumes:
|
|
- redis_dev_data:/data
|
|
healthcheck:
|
|
test: ["CMD", "redis-cli", "ping"]
|
|
interval: 5s
|
|
timeout: 5s
|
|
retries: 5
|
|
networks:
|
|
- dev-net
|
|
|
|
# --------------------------------------------------------------------------
|
|
# Backend — 开发模式(代码 volume mount + uvicorn --reload)
|
|
# --------------------------------------------------------------------------
|
|
backend:
|
|
build:
|
|
context: ./backend
|
|
dockerfile: Dockerfile.dev # dev 版(无需 apt 装 gcc,快)
|
|
image: wecom-it-desk-backend:dev
|
|
container_name: dev_wecom_backend
|
|
restart: unless-stopped
|
|
env_file:
|
|
- .env.dev
|
|
environment:
|
|
# 容器内用 service name(host 是 localhost,容器内是 postgres/redis)
|
|
- DATABASE_URL=postgresql://${POSTGRES_USER:-wecom}:${POSTGRES_PASSWORD:-wecom_dev}@postgres:5432/${POSTGRES_DB:-wecom_it_desk_dev}
|
|
- REDIS_URL=redis://redis:6379/0
|
|
- DEV_MODE=true # 开启 Mock 企微 OAuth
|
|
- CORS_ORIGINS=http://localhost:5173,http://localhost:5174,http://localhost:5175,http://localhost:5176
|
|
ports:
|
|
- "8000:8000" # 暴露到宿主机
|
|
volumes:
|
|
# 关键:volume mount 源码,改代码自动 reload
|
|
- ./backend/app:/app/app
|
|
- ./backend/alembic:/app/alembic
|
|
- ./backend/scripts:/app/scripts
|
|
command: >
|
|
sh -c "alembic upgrade head &&
|
|
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload"
|
|
depends_on:
|
|
postgres:
|
|
condition: service_healthy
|
|
redis:
|
|
condition: service_healthy
|
|
networks:
|
|
- dev-net
|
|
|
|
volumes:
|
|
postgres_dev_data:
|
|
redis_dev_data:
|
|
|
|
networks:
|
|
dev-net:
|
|
driver: bridge
|