docs: explain UAT page markers and deployment source differences

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]` 前缀，并在 `<body>` 后插入 `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 报错和菜单内嵌页面切换问题；全量报表、业务填报、附件及省级接口尚未验收。