mirror of
https://github.com/hpd840321/starRiverProperty.git
synced 2026-06-09 08:20:31 +08:00
反编译工作区
d52babe2c9
When tenant policy exists and enabled, allow_zone_ids REPLACES the candidate floor list entirely. Phase 3 simplified. Bump v2.0.20
107 lines
5.3 KiB
Markdown
107 lines
5.3 KiB
Markdown
# 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`
|
||
- [ ] 《版本升级说明书》（实施/技术）
|
||
- [ ] 本《甲方版本升级说明》（如已作为对甲交付）
|
||
- [ ] 本《升级计划》（双方确认签字/邮件留档）
|
||
|
||
---
|
||
|
||
**文档状态**：草案；**时间点为暂定周二、周三晚间**，正式实施前请更新「待确认栏」并留存确认记录。
|