ulthon_admin/source/stack/README.md

Stack 模式目录规范（B-route 工作流）

本目录维护多种部署/运行模式的独立栈定义。B-route 工作流下，每个模式是 source/stack/ 下一个独立子目录，不再覆盖仓库根目录：使用某个模式时 cd 进对应目录运行 docker compose up -d 即可。

工作流

1. 默认基线（default）：仓库根目录直接 php think run，根目录无 Docker 文件。
2. 选择某个 Docker 模式：cd source/stack/<mode> 后 docker compose up -d，bind mount 指向仓库根目录。
3. 模式目录内执行命令：在该目录用 docker compose exec <service> php think ...，或在仓库根目录用 docker compose -f source/stack/<mode>/docker-compose.yaml exec <service> php think ...。

目录结构

• source/stack/stack.json：全局清单，记录 default_mode 与 modes 元数据，供人与工具查阅可用模式。
• source/stack/default/：默认行为基线目录（php think run，纯 PHP 内置服务器，不依赖 Docker）。
• source/stack/<mode>/：具体模式目录，内含该模式独立的 docker-compose.yaml 及配套文件（如 Dockerfile、nginx 配置、env 示例等）。

default 目录规则（强约束）

• source/stack/default/ 必须与代码库默认行为一致。
• 默认行为为 php think run（ThinkPHP 内置服务器），不依赖 Docker。
• 当默认行为文件变更时（如 .gitea/workflows/build-and-deploy.yml），必须同步更新 default 目录对应文件。
• 该规则通过目录维护规范与代码评审保障，不作为运行时阻断条件。

可用模式

模式	启动方式	说明
default	仓库根目录 php think run	默认基线，无 Docker 文件，宿主机直接跑
docker-serve	cd source/stack/docker-serve && docker compose up -d	Docker 部署模式（基于基础镜像，nginx + php-fpm）
docker-dev	cd source/stack/docker-dev && docker compose up -d	Docker 开发模式（nginx + php-fpm + MySQL + Redis + phpMyAdmin + Xdebug）
docker-dev-sync	cd source/stack/docker-dev-sync && docker compose up -d	Docker 开发模式 - Windows I/O 优化（rsync 同步，避免 bind mount 慢速问题）
full	cd source/stack/full && docker compose up -d	完整服务栈（规划中），从 PHP 镜像从头构建
author	cd source/stack/author	框架作者维护工具（基础镜像构建、发布脚本等）

历史 base-build 模式已并入 author。

基础镜像说明

• author/docker/Dockerfile.base 为基础镜像构建文件，属于作者维护范围。
• 推荐标签策略：latest + 时间戳（如 20260424120000）。