# 阶段二记录：本地开发编排

日期：2026-07-06

## 本次目标

补齐 V2 本地开发编排，让 MySQL、后端和用户端 H5 可以一起启动，降低后续开发和测试的环境成本。

## 已完成

- 新增 `ai_knowledge_base_v2/docker-compose.dev.yml`。
- 新增 MySQL 8.4 服务：
  - 容器名：`ai_kb_v2_mysql`
  - 数据库：`ai_knowledge_base_v2`
  - 用户：`ai_kb`
  - 本机端口：`3307`
- 新增后端 Dockerfile：
  - 启动前执行 `alembic upgrade head`
  - 后端端口：`8100`
- 新增用户端 Dockerfile：
  - Vue H5 dev server 端口：`5173`
- 更新 V2 根目录、后端、用户端 README。

## 默认访问地址

- 用户端 H5：`http://127.0.0.1:5173/`
- 后端健康检查：`http://127.0.0.1:8100/api/health`
- MySQL：`127.0.0.1:3307`

## 使用方式

```bash
cd ai_knowledge_base_v2
docker compose -f docker-compose.dev.yml up --build
```

## 当前边界

- 当前编排面向本地开发，不是生产部署方案。
- MySQL root 密码和业务密码都是本地开发默认值，生产环境必须更换。
- 后端仍使用 mock 短信验证码 `123456`。
- 真实飞书和真实大模型尚未接入。

## 验证记录

- `docker compose -f docker-compose.dev.yml config --quiet` 已通过。
- `git diff --check` 已通过。
- 尝试执行 `docker compose -f docker-compose.dev.yml build backend user-client`，Dockerfile 和构建上下文已正常进入构建流程；由于当前环境拉取 Docker Hub 基础镜像速度过慢，等待数分钟后人工中断，未判定为代码构建失败。
