# 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`  
- [ ] 《版本升级说明书》（实施/技术）  
- [ ] 本《甲方版本升级说明》（如已作为对甲交付）  
- [ ] 本《升级计划》（双方确认签字/邮件留档）  

---

**文档状态**：草案；**时间点为暂定周二、周三晚间**，正式实施前请更新「待确认栏」并留存确认记录。