From 2b051034fa4cdbaceb12d8323bf5bbf37d4bf407 Mon Sep 17 00:00:00 2001 From: Ethan Date: Thu, 29 Oct 2026 22:40:38 +0800 Subject: [PATCH] docs: explain UAT page markers and deployment source differences --- README.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 8204170..9b13941 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # 三亚旅游统计管理系统 syly2 -本仓库从 2026-10-29 交接包的**外层 Maven 工程**建立维护基线。原始清单的 5,302 个文件已逐一核验 SHA-256，与当天成功构建和 UAT 部署的源文件一致。 +本仓库从 2026-10-29 交接包的**外层 Maven 工程**建立维护基线。原始清单的 5,302 个文件已逐一核验 SHA-256，与当天构建使用的原始输入清单一致。该核验针对交接源码；编译兼容修正和 UAT 运行副本的部署调整另见下文。 入库版本包含已验证的三处 Java 8/Linux 编译兼容修正：POM 使用平台路径分隔符，两个统计 Controller 删除未使用的 JDK 内部类导入。数据库备份、历史 target、内层重复工程及真实凭据不进入仓库。 @@ -26,6 +26,22 @@ bash scripts/build.sh `ops/uat-build`、`ops/uat-deploy` 保存**此前 UAT 的操作脚本与说明**，含当次路径和原始产物哈希检查。它们是历史复现资料，不是当前仓库 WAR 的直接发布命令。现有 UAT 未被本次入库操作更新。 +## UAT 页面标记与版本关系 + +UAT 登录页上的 `[UAT]` 和“UAT 隔离测试环境 · 数据来自备份 · 外部上报已禁用”由 [prepare-runtime.py](ops/uat-deploy/prepare-runtime.py) 在部署时写入。脚本先解压已验证的 WAR，再修改部署目录下的 `runtime/webapp/webpage/login/login.jsp`：给页面标题添加 `[UAT]` 前缀，并在 `` 后插入 `isolated-uat-banner` 横幅。 + +2026-10-29 核对结果如下： + +| 文件版本 | 登录页状态 | +| --- | --- | +| 原始交接源码 | 标题为“登录”，没有 UAT 标记；文件哈希与原始清单一致 | +| 首次入库提交 `da8224e` 的 [login.jsp](src/main/webapp/webpage/login/login.jsp) | 与原始交接登录页哈希一致，没有 UAT 标记 | +| 当天 UAT 部署运行副本 | 部署脚本修改了 JSP，加入标题前缀和环境提示横幅 | + +**“原始交接目录未改动”不表示 UAT 运行文件未改动。** 当天部署还在运行副本中替换了数据库连接、禁用了外部接口和定时任务、调整了日志及 `web.xml`，并加入 `UatGuardFilter`。这些部署调整可从 `ops/uat-deploy` 追溯；修改后的运行文件未直接作为应用源码入库。 + +首次入库之前没有可用的 Git 提交历史；原始源码通过文件清单核对，部署修改通过脚本和留存验证记录追溯。常规 Maven 构建不会自动添加上述 UAT 页面标记。发布或复现环境时，应同时核对源码版本、WAR 和部署脚本，不能仅凭页面标记判断源码提交是否变化。 + ## 验证范围 见 [验证记录](docs/VERIFICATION.md) 和 `docs/evidence/`。此前 UAT 已通过编译、部署、登录及基础页面检查，但仍存在旧 JavaScript 报错和菜单内嵌页面切换问题；全量报表、业务填报、附件及省级接口尚未验收。