---
description: Docker 开发环境规范
globs: docker-compose*.yml,docker/**,**/Dockerfile
alwaysApply: false
---
# Docker 开发环境

详见 `docs/13-docker.md`。

- 根目录**一个** `docker-compose.yml`，不为小模块建立独立 Compose。
- 服务：php-fpm（PHP 8.4）、nginx、mysql（8）、redis（7）、node（前端开发）、py-service（FastAPI，构建上下文 `py-service/`）。
- Queue Worker、Scheduler 为独立服务，复用 PHP 镜像。
- 镜像定义放 `docker/{service}/`；敏感配置经 `.env` 注入，不写入镜像与 Git。
- 数据卷持久化 MySQL / Redis；端口、密码可通过 `.env` 配置。
- 第一阶段不引入 Kubernetes，生产方案在 Phase 17 设计。