Add V2 local dev compose

This commit is contained in:
2026-07-06 17:45:24 +08:00
parent e9f3db9ab2
commit 96742de07b
10 changed files with 177 additions and 2 deletions

View File

@@ -0,0 +1,48 @@
# 阶段二记录:本地开发编排
日期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 基础镜像速度过慢,等待数分钟后人工中断,未判定为代码构建失败。

View File

@@ -27,3 +27,4 @@
| `2026-07-06-decision-register.md` | 开发决策登记表,集中记录用户明确决策和默认工程决策。 |
| `2026-07-06-phase2-backend-foundation.md` | 阶段二后端基础工程第一批记录。 |
| `2026-07-06-phase2-user-client.md` | 阶段二用户端 Vue 3 H5 第一批记录。 |
| `2026-07-06-phase2-dev-compose.md` | 阶段二本地开发编排记录。 |