Files
myrzx_bot/deploy/web/VALIDATION.md
T

6.6 KiB
Raw Blame History

Deploy owner 交接与冻结记录

分支 develop/v2.0.0,基线 main v1.2.0 (7fe4c0f),Web 源码版本 2.0.0.dev1。本 owner 完成部署与更新范围,未 commit、push、合并、发布镜像或触发线上部署;未读取或修改桌面私有账户,未调用真实游戏 API 或真实 GitHub Releases。

文件

  • 根目录:Dockerfile、compose.yaml、.dockerignore、Start_Ranch_Web.cmd、start-web.sh;.gitignore 仅追加 Web 虚拟环境、设计缓存与部署运行产物排除;根 README.md 仅增加 Web 开发/部署入口。
  • ranch_web/updates.py:标准库发布检查、严格稳定 2.x 比较、只读宿主机心跳授权、原子 pending 请求与脱敏公共状态;包含 CI 的固定仓库/源码版本发布校验函数。
  • ranch_web/tests/test_updates.py 与 test_web_updater.py:本 owner 独立测试文件。
  • ranch_web/README.md:Windows/Linux Python 开发启动、数据隔离、环境设置与更新限制。
  • .github/workflows/web-image.yml:PR/手动只测试与构建,官方严格 v2.x.y tag 且源码版本完全一致时才推固定 GHCR 镜像。仓库名称比较忽略大小写,覆盖 AttilaNet/myrzx_bot。
  • deploy/web/:更新器、Compose 包装脚本、systemd service/timer、环境及 TOML 示例、部署文档与 精确更新协议。

已执行验证(部署专项)

Windows Python 3.13.15:

python -B -m unittest ranch_web.tests.test_updates ranch_web.tests.test_web_updater -q

41 项通过,无跳过。 GitHub 和 Docker 为 mock,数据全部在独立 TemporaryDirectory。覆盖:

  • 仅稳定 v2.x.y,过滤 1.x、3.x、草稿、预发布、前导零、命令/换行注入;数字版本排序;2.0.0.dev1 → v2.0.0 可升级,同版正式版本/降级拒绝。
  • 未配置、过期、禁用、错误实例、未来时间的能力证明;Web 数据目录不能自行开启执行器;pending 去重;公共错误不泄露原始异常或私有数据。
  • 宿主机独立从 fake 官方 Releases 复验,不信 Web 标签;operator opt-in;过期/额外命令字段/跨实例请求拒绝;自动安装默认关闭。
  • 旧服务运行时 pull、停服后才快照;拉取失败不停止;备份失败恢复旧镜像;健康失败恢复 SQLite、密钥和准确旧镜像,保留失败版本数据;回滚失败保存事务,恢复可重试。
  • 实际 WebManager 在全网络 connect 禁止条件下,以内置离线 demo 开启策略,然后关闭、快照、重启及还原:保留勾选偏好与相同加密密钥,但 running=false,不会自动恢复执行。
  • 正式镜像 label 仍是 dev 或健康失败时不能宣告更新成功;官方仓库名称大小写、fork 拒绝、源码版本/tag 不一致拒绝。
  • --dry-run 对 Windows 与随附 Linux 路径示例均有效,不联网、不执行 Docker、不创建文件。

另外已执行:

  • Start_Ranch_Web.cmd --version 返回 2.0.0.dev1。
  • 实际 Windows python -m ranch_web --demo --no-browser HTTP 启动烟测:临时数据、动态本地端口;导入钩子禁止 PySide6/桌面 GUI,禁止外部 DNS/connect;健康、离线账号与更新禁用状态正常,触发 SIGINT 后正常 lifespan 退出,exit 0。该测试不含页面浏览器验收。
  • start-web.sh 与 deploy/web/compose.sh 通过 Git Bash bash -n;两个 YAML 解析通过;静态核对单服务、UID/GID 10001、/data、独立只读心跳挂载、无 Docker socket、120 秒停止宽限;git diff --check 通过。
  • 官方 Docker/GitHub 文档已核对并在 部署说明 链接。必要的 ranch_assistant/data/progression_battles.zip 在 .dockerignore 中显式保留。

Main/API/前端集成注意与未执行范围

  1. 所有文档、容器与当前 API config 统一 RANCH_WEB_DATA_DIR、RANCH_WEB_HOST、RANCH_WEB_PORT;Docker WEB_CONCURRENCY=1,CLI 不打开浏览器。
  2. API 已使用更新 DTO 专用序列化保留合法 request / request_id,游戏凭据脱敏保持有效;HTTP 与 meta 的 pending/applying 信息已对接。前端从 latest_version 原样传完整 v2.x.y。
  3. request_update() 在无执行器时返回 unavailable,成功提交仅是 pending;不能把 HTTP 202 文案写成“已更新”。心跳目录只读,协议 1,timer 每五分钟;accept_web_requests=false 与 auto_apply=false 均为默认值。
  4. 本机无 Docker 可执行程序;没有验证 Linux/Docker 构建、Compose 真实解析/拉取、UID bind mount 实机权限、systemd 或真实健康回滚,也未执行 CI。静态配置与 mock 测试不能替代上述实机验收。CI 已编写隔离网络的容器健康/权限/停止检查,等待父代理审核后在授权发布流程执行。
  5. GHCR 首次包为私有的处理已记录:公共发布需设包 Public;私有部署由操作者 docker login,Web 无 registry 凭据或 Docker socket。更新器 systemd 允许只读访问 root 的 registry 登录配置。

最终集成与复核

Main 确认最终非浏览器后端 185项:184通过、1跳过(Windows符号链接权限),0失败/错误,用时26.878秒;执行前后69份源文件哈希一致,无外发尝试。浏览器 13项通过,JS/CSP错误为0,另以新 Edge 进程验证15页与主线/孵蛋子页。上述部署专项41项、定向复核与全量测试有重叠,不相加。

本 owner 对此前五项问题复核完成:编码后与 requests 发送前的停止检查有效;修改配置不误关运行开关;120个筛选后视图缓存32项、已完成任务索引归零;主线/孵蛋标签 key 完整;12个并发错误登录得到10个401和2个429。六项定向回归与原始复现均通过,未扩大审查或重跑整套测试。

完整后端及浏览器命令见 Web 验证说明。未进行真实游戏 API、Linux Docker、systemd 或生产更新器实机验收,未发布镜像或触发部署。生产代码保持冻结,仅更新最终文档,交 Main 提交。

2026-11-11:Vue 专用控制台改版

界面改为牧羊人之心专用的账号总览、账号管理、分组侧栏、面包屑和账号工作区,取消多游戏入口。业务Engine与持久化格式不变。Node22在独立Docker构建阶段生成Vue静态资源,最终运行容器仍是Python。

离线验收:后端201项(200通过、1项Windows跳过),浏览器30项全部通过,前端控制器/表格24项通过,Vue类型检查及生产构建通过。原23项浏览器功能覆盖保留,新增7项管理后台回归;详细命令见Web README。当前仍是2.0.0.dev1,不创建稳定tag或合并main。