refactor: rename main class to AppApplication to match V1 naming

- V1 main class: cn.cloudwalk.elevator.AppApplication - V2 was ElevatorApplication, now aligned to AppApplication - Also update reference in test script
2026-06-09 08:20:31 +08:00 · 2026-05-05 18:17:38 +08:00
parent 9c2edc09c9
commit 6f1cd21a5b
21 changed files with 1232 additions and 2 deletions
@@ -0,0 +1,106 @@
+# cw-elevator-application v2.0.6 升级计划
+
+**项目名称**（可填）：智慧电梯 / 访客派梯系统升级  
+**版本**：v2.0.6  
+**计划性质**：执行级排期草案，**具体日期、起止时刻以与甲方书面/邮件确认为准**。
+
+---
+
+## 1. 升级目标
+
+完成电梯派梯应用 **v2.0.6** 上线，启用**租户访客固定访问楼层**能力所需的应用与数据库对象；按业务需要为指定租户配置策略并完成验收。
+
+---
+
+## 2. 计划时间窗口（夜间 · 暂定周二、周三）
+
+| 窗口 | 意向安排 | 建议内容（可合并或调整） |
+|------|-----------|----------------------------|
+| **第一次：周二晚间** | 夜间低峰段，具体 **HH:MM–HH:MM** 待定 | 环境检查、数据库备份、执行 **DDL**（新建策略表）、（可选）预发布验证、必要时准备回滚包与检查单 |
+| **第二次：周三晚间** | 夜间低峰段，具体 **HH:MM–HH:MM** 待定 | 部署新版本 **JAR**、滚动/重启应用、按需 **INSERT** 租户策略数据、业务联调与验收、监控与值守 |
+
+**说明**：
+
+- 若贵方现场要求**一个晚上完成全部步骤**，可将 DDL 与部署**合并在同一晚间窗口**执行，本表仅体现「周二、周三两晚」的**当前意向拆分**，最终以确认单为准。  
+- 两次窗口建议**间隔至少数小时至一个工作日**，便于第一次变更后观察库表与低风险项；若合并为单次窗口，须在计划单中注明**连续操作顺序与回滚点**。
+
+**待确认栏**（实施时填写）：
+
+- 周二实施日期：`____年____月____日`，时段： `____ : ____` – `____ : ____`  
+- 周三实施日期：`____年____月____日`，时段： `____ : ____` – `____ : ____`  
+- 甲方现场联系人： `____________`  乙方/实施负责人： `____________`
+
+---
+
+## 3. 影响范围与沟通
+
+| 项目 | 说明 |
+|------|------|
+| 影响系统 | 电梯派梯相关应用（`cw-elevator-application`）及同一业务库。 |
+| 用户感知 | 应用重启期间可能出现短时派梯接口失败；策略误配可能导致部分访客路径失败，需按验收清单核对。 |
+| 通知范围 | 建议提前通知：物业/客服、前台与访客登记、安保与梯控相关值班（按项目实际 roster 确定）。 |
+
+---
+
+## 4. 前置条件（升级前）
+
+- [ ] 已与甲方确认 **周二 / 周三** 夜间窗口。  
+- [ ] 取得 **v2.0.6** 发布包（含 `jar`、`ddl/tenant_visitor_floor_policy.sql`、说明书）。  
+- [ ] 目标环境 **JDK 版本**符合实施方要求（与构建说明一致，一般为 JDK 8）。  
+- [ ] 数据库已做**备份**（全库或按运维规范），并可从发布包定位 DDL。  
+- [ ] 明确需启用「固定访客楼层」的租户列表及**允许区域**配置（若不启用，可跳过策略数据录入，行为与升级前一致）。  
+- [ ] 回滚包：保留**当前线上 JAR** 备份与回滚步骤（见下文）。
+
+---
+
+## 5. 实施步骤（建议顺序）
+
+### 5.1 周二晚间（或首个窗口）
+
+1. 备份数据库。  
+2. 执行 `tenant_visitor_floor_policy.sql`（`CREATE TABLE IF NOT EXISTS`，可重复执行需与 DBA 确认）。  
+3. （可选）在测试/预发环境先执行一遍并验证。  
+4. 记录执行人、时间与结果。
+
+### 5.2 周三晚间（或第二个窗口 / 同晚续作）
+
+1. 停止或滚动发布应用（按现网规范）。  
+2. 替换为 `cw-elevator-application-2.0.6.jar` 并启动。  
+3. 按业务需求对需启用的租户执行策略 **INSERT**（`enabled=1`、`allow_zone_ids` 等为合法 JSON 等，字段级以技术说明书为准）。  
+4. 抽样验证：未传显式楼层时的访客派梯、租户策略开/关、与组织楼层无交集时的失败提示等。  
+5. 观察监控与日志，**值守**至约定结束时间。
+
+*若合并为单次窗口：按「备份 → DDL → 部署 JAR → 策略数据 → 验收」顺序连续执行，并预留回滚决策时间。*
+
+---
+
+## 6. 验收要点（摘要）
+
+- 未配置或未启用策略时：与升级前行为一致。  
+- 已启用策略且业务走「未显式指定楼层」路径：访客可去楼层为**组织允许**与**租户允许**的**交集**。  
+- 交集为空时：接口返回预期业务错误（技术码见实施方说明书）。  
+- 第三方已显式传入楼层的路径：不因本策略表改变原逻辑。
+
+---
+
+## 7. 回滚预案
+
+| 场景 | 建议动作 |
+|------|-----------|
+| 应用异常 | 回退至上一版本 JAR；数据库新表若已存在且旧应用不读该表，通常可继续服务；与实施方确认。 |
+| 策略配置错误 | 优先**停用或修正策略行**，避免大规模回滚应用。 |
+| 必须撤表 | 仅在评估无依赖后由 DBA 执行删表；**高风险**，需书面确认。 |
+
+---
+
+## 8. 交付物核对
+
+- [ ] `cw-elevator-application-2.0.6.jar`  
+- [ ] `ddl/tenant_visitor_floor_policy.sql`  
+- [ ] 《版本升级说明书》（实施/技术）  
+- [ ] 本《甲方版本升级说明》（如已作为对甲交付）  
+- [ ] 本《升级计划》（双方确认签字/邮件留档）  
+
+---
+
+**文档状态**：草案；**时间点为暂定周二、周三晚间**，正式实施前请更新「待确认栏」并留存确认记录。