starRiverProperty/docs/build/cw-elevator-application-v2.0.6-升级计划.md

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

---

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