yinjianm
d4168720ac
新增用户高级筛选、批量操作与更多行级动作，支持邮件、 CSV、封禁恢复、订单分配、邀请查看、流量记录与重置流量 增强节点管理页的分页、父子筛选、跨页勾选、批量修改与 单节点置顶，并补齐后端批量更新 host、group_ids、rate 修复订单佣金状态误判问题，新增真实佣金筛选与行级确认， 同时优化仪表盘排行悬浮详情展示 补充 admin-frontend 独立 Dockerfile、Caddy 配置与 GHCR 发布工作流，支持通过独立镜像部署管理前端
2.6 KiB
2.6 KiB
admin-frontend GHCR 自动构建与 compose 接入 — 实施规划
目标与范围
- 让
admin-frontend从“仓内前端目录”升级为“可独立构建、可独立分发、可独立部署”的静态前端镜像。 - 保持当前主应用镜像发布链路不变，同时补一条面向前端的独立 GHCR 发布通道。
- 让
compose分支可直接拉起独立admin服务，对外暴露单独端口。
架构与实现策略
- 构建链路：
- 在
admin-frontend/下新增独立 Dockerfile，采用Node -> Caddy多阶段构建。 - 通过环境变量把容器构建输出切到
dist，避免影响当前仓内public/assets/admin输出。
- 在
- 发布链路：
- 新增单独的 GitHub Actions workflow，仅在
admin-frontend/**或 workflow 自身变更时触发。 - 镜像发布到
ghcr.io/<owner>/xboard-admin-frontend，标签策略与主应用保持一致：分支、sha、new、latest。
- 新增单独的 GitHub Actions workflow，仅在
- 运行链路：
- 通过 Caddy 在容器内提供静态资源，根路径自动重定向到
/assets/admin/。 compose分支新增admin服务，直接拉取 GHCR 镜像并暴露7002:80。
- 通过 Caddy 在容器内提供静态资源，根路径自动重定向到
完成定义
admin-frontend本地可通过 Dockerfile 正常构建镜像。- GitHub Actions 可在 push 后自动构建并推送
admin-frontend镜像到 GHCR。 compose分支的compose.yaml已包含独立admin服务，且镜像名与端口配置正确。npm run build与 workflow/compose 语法检查通过。
风险与验证
- 风险 1：
vite.config.ts目前默认输出到仓根public/assets/admin，容器构建若不切换输出目录会污染镜像构建路径，因此必须引入可覆写输出目录。 - 风险 2：若前端服务直接暴露
/而未处理/assets/admin/，现有资源前缀会失配，因此需要容器内重定向和静态路径兜底。 - 风险 3：当前仓库已有大量未提交业务改动，不能直接切换分支修改
compose.yaml，需在独立 worktree 中处理compose分支文件。 - 验证方式：
npm run builddocker build -f admin-frontend/Dockerfile admin-frontendpython -c "import yaml; ..."检查 workflow 与 compose YAML
决策记录
- [2026-04-24] 采用独立
admin服务，并按用户确认暴露单独端口，不内嵌回 Laravel 主服务容器。 - [2026-04-24] 采用独立 workflow，而不是把前端镜像构建塞进现有后端
docker-publish.yml，以降低耦合和回归面。 - [2026-04-24] 前端运行时采用 Caddy 提供静态资源并做
/ -> /assets/admin/重定向，兼容当前base: '/assets/admin/'。