facc04aa65
本提交为 .git 对象库损坏后的重建提交,内容等价于原先三个本地提交 (5e2fd4c2 / 57a53c98 / 5d7e1873)的累积结果,未做任何额外改动。 一、docs 结构整改(整改 #14) 根因:重构时新结构为 untracked 文件,执行 git stash(未带 -u)未纳入, 随后 git reset 拉回 HEAD 旧 tracked 树,导致旧树复活、新旧两棵目录 树并存于 docs/,共 791 文件、双分类体系冲突。 修复动作: - b2 同名异主题文件改名迁移保全 9 个 - C 类 39 个孤立文件按主题正确归类 - A/B1 类 222 个重复文件删除(新结构已有内容副本) - 9 个旧独有空目录删除 - 270 处内部引用按 verified 映射改写 - 整改记录 #14 登记于 04-运维文档/部署运维 结果:docs 791 → 569 文件,顶层仅规范 8 类 + 治理文件,单树恢复。 残留:约 20 处指向从未存在文件的陈旧死链,归入独立文档卫生任务。 二、compose 双目录对齐(消除踩坑 A) - docker-compose.yml:nginx 前端挂载全部由根目录 frontend-*/dist 改为 src/frontend-*/dist(h5 / agent / admin / terminal) - docker-compose.dev.yml:dev 服务 build context 与卷同步改 src/ - 效果:本地 docker compose up 不再把根目录 stale dist 挂回, 与线上一致,分叉隐患消除(已 docker compose config 校验通过) 防复发铁律: - 重构须提交;仓库修复须 git stash -u 或先 commit - 新结构须 git add 并提交,避免再次 untracked 复活 - H5 改动只动 src/frontend-h5/,禁改根目录遗留 frontend-*/
233 lines
7.5 KiB
YAML
233 lines
7.5 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. 访问 http://localhost:80/itdesk/ 等
|
|
# 启动后:
|
|
# - Nginx: http://localhost:80 (统一入口)
|
|
# - Postgres: localhost:5432
|
|
# - Redis: localhost:6379
|
|
# - Backend: localhost:8000 (可选)
|
|
# =============================================================================
|
|
|
|
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"
|
|
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
|
|
|
|
# --------------------------------------------------------------------------
|
|
# Neo4j 5 — 知识图谱存储
|
|
# --------------------------------------------------------------------------
|
|
neo4j:
|
|
image: neo4j:5-community
|
|
container_name: dev_wecom_neo4j
|
|
restart: unless-stopped
|
|
environment:
|
|
NEO4J_AUTH: neo4j/${NEO4J_PASSWORD:-password}
|
|
NEO4J_PLUGINS: '["apoc"]'
|
|
ports:
|
|
- "7474:7474"
|
|
- "7687:7687"
|
|
volumes:
|
|
- neo4j_dev_data:/data
|
|
- neo4j_dev_logs:/logs
|
|
healthcheck:
|
|
test: ["CMD-SHELL", "cypher-shell -u neo4j -p ${NEO4J_PASSWORD:-password} 'RETURN 1'"]
|
|
interval: 10s
|
|
timeout: 5s
|
|
retries: 10
|
|
networks:
|
|
- dev-net
|
|
|
|
# --------------------------------------------------------------------------
|
|
# Backend — 开发模式(代码 volume mount + uvicorn --reload)
|
|
# --------------------------------------------------------------------------
|
|
backend:
|
|
build:
|
|
context: ./backend
|
|
dockerfile: Dockerfile.dev
|
|
image: wecom-it-desk-backend:dev
|
|
container_name: dev_wecom_backend
|
|
restart: unless-stopped
|
|
env_file:
|
|
- .env.dev
|
|
environment:
|
|
- DATABASE_URL=postgresql://wecom:wecom_dev@postgres:5432/wecom_it_desk_dev
|
|
- REDIS_URL=redis://redis:6379/0
|
|
- DEV_MODE=true
|
|
- WECOM_SSO_CALLBACK_BASE=http://localhost:80
|
|
- CORS_ORIGINS=http://localhost:80
|
|
# Dify AI 服务(生产环境)
|
|
- DIFY_API_URL=http://yw-dify.dc.servyou-it.com/dify2openai/v1/chat/completions
|
|
- DIFY_API_KEY=app-7jkRkAzvX4QM9v9SM3P8mMEO
|
|
- DIFY_TIMEOUT=30
|
|
- PYTHONPATH=/app
|
|
# Neo4j 知识图谱
|
|
- NEO4J_URI=bolt://neo4j:7687
|
|
- NEO4J_USER=neo4j
|
|
- NEO4J_PASSWORD=${NEO4J_PASSWORD:-password}
|
|
- NEO4J_DATABASE=neo4j
|
|
ports:
|
|
- "8000:8000"
|
|
volumes:
|
|
- ./backend/app:/app/app
|
|
- ./backend/alembic:/app/alembic
|
|
- ./backend/scripts:/app/scripts
|
|
command: >
|
|
sh -c "uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload"
|
|
depends_on:
|
|
postgres:
|
|
condition: service_healthy
|
|
redis:
|
|
condition: service_healthy
|
|
neo4j:
|
|
condition: service_healthy
|
|
networks:
|
|
- dev-net
|
|
|
|
# --------------------------------------------------------------------------
|
|
# Frontend-Agent — 坐席前端开发模式
|
|
# --------------------------------------------------------------------------
|
|
frontend-agent:
|
|
build:
|
|
context: ./src/frontend-agent
|
|
dockerfile: Dockerfile.dev
|
|
image: wecom-it-desk-agent:dev
|
|
container_name: dev_wecom_frontend_agent
|
|
restart: unless-stopped
|
|
environment:
|
|
- VITE_API_BASE=http://localhost:80/api
|
|
- VITE_WS_BASE=ws://localhost:80/ws
|
|
ports:
|
|
- "5173:5173"
|
|
volumes:
|
|
- ./src/frontend-agent/src:/app/src
|
|
depends_on:
|
|
- backend
|
|
networks:
|
|
- dev-net
|
|
|
|
# --------------------------------------------------------------------------
|
|
# Frontend-H5 — H5前端开发模式
|
|
# --------------------------------------------------------------------------
|
|
frontend-h5:
|
|
build:
|
|
context: ./src/frontend-h5
|
|
dockerfile: Dockerfile.dev
|
|
image: wecom-it-desk-h5:dev
|
|
container_name: dev_wecom_frontend_h5
|
|
restart: unless-stopped
|
|
environment:
|
|
- VITE_API_BASE=http://localhost:80/api
|
|
- VITE_WS_BASE=ws://localhost:80/ws
|
|
# dev 容器内 Vite 代理目标:指向 compose 服务名 backend(容器内 localhost 不是后端)
|
|
- VITE_PROXY_TARGET=http://backend:8000
|
|
ports:
|
|
- "5174:5174"
|
|
volumes:
|
|
- ./src/frontend-h5/src:/app/src
|
|
# dev 热更新:同时挂载 public/,否则容器镜像内烘焙的 public/ 不含后续新增资源
|
|
# (如 duckula.webp),导致 Vite 解析 <img src="/duckula.webp"> 失败、整个应用无法挂载
|
|
- ./src/frontend-h5/public:/app/public
|
|
# 挂载 vite.config.ts 使代理目标等配置可热生效(无需重建镜像)
|
|
- ./src/frontend-h5/vite.config.ts:/app/vite.config.ts
|
|
# 挂载 index.html 使 CSP(含 dev WS 端口)修改可热生效
|
|
- ./src/frontend-h5/index.html:/app/index.html
|
|
depends_on:
|
|
- backend
|
|
networks:
|
|
- dev-net
|
|
|
|
# --------------------------------------------------------------------------
|
|
# Frontend-Admin — 管理前端开发模式
|
|
# --------------------------------------------------------------------------
|
|
frontend-admin:
|
|
build:
|
|
context: ./src/frontend-admin
|
|
dockerfile: Dockerfile.dev
|
|
image: wecom-it-desk-admin:dev
|
|
container_name: dev_wecom_frontend_admin
|
|
restart: unless-stopped
|
|
environment:
|
|
- VITE_API_BASE=http://localhost:80/api
|
|
ports:
|
|
- "5175:5175"
|
|
volumes:
|
|
- ./src/frontend-admin/src:/app/src
|
|
depends_on:
|
|
- backend
|
|
networks:
|
|
- dev-net
|
|
|
|
# --------------------------------------------------------------------------
|
|
# Nginx — 反向代理(统一入口)
|
|
# --------------------------------------------------------------------------
|
|
nginx:
|
|
image: nginx:1.27-alpine
|
|
container_name: dev_wecom_nginx
|
|
restart: unless-stopped
|
|
ports:
|
|
- "80:80"
|
|
volumes:
|
|
- ./nginx/nginx.dev.conf:/etc/nginx/nginx.conf:ro
|
|
depends_on:
|
|
- backend
|
|
- frontend-agent
|
|
- frontend-h5
|
|
- frontend-admin
|
|
networks:
|
|
- dev-net
|
|
|
|
volumes:
|
|
postgres_dev_data:
|
|
redis_dev_data:
|
|
neo4j_dev_data:
|
|
neo4j_dev_logs:
|
|
|
|
networks:
|
|
dev-net:
|
|
driver: bridge
|