mirror of
https://github.com/hpd840321/starRiverProperty.git
synced 2026-06-09 08:20:31 +08:00
feat: normalize policy data (REPLACE_ALLOWLIST), add org-side DDL to release bundle, add release plan
- Update release script: include org-side active DDL/seed + deprecation README - Normalize seed SQL: policy_type=REPLACE_ALLOWLIST, uniform remark format - Add version release plan and naming conventions spec - Disable elevator-side tenant_visitor_floor_policy (V2 no longer queries it)
This commit is contained in:
@@ -30,12 +30,12 @@ INSERT INTO tenant_visitor_floor_policy (
|
||||
'gf_vstr_policy_guangfa_fund_001x',
|
||||
'488b8ad049bb43408a6fbcc50bcb89ac',
|
||||
'2524639890ba4f2cba9ba1a4eeaa4015',
|
||||
'INTERSECT_ALLOWLIST',
|
||||
'REPLACE_ALLOWLIST',
|
||||
'["605560545117995008"]',
|
||||
NULL,
|
||||
1,
|
||||
1,
|
||||
'广发基金:访客楼层策略(组织库);默认 28F。',
|
||||
'广发基金 | org=[28-38F] | 访客默认28F',
|
||||
UNIX_TIMESTAMP(NOW()) * 1000,
|
||||
UNIX_TIMESTAMP(NOW()) * 1000
|
||||
) ON DUPLICATE KEY UPDATE
|
||||
@@ -62,10 +62,10 @@ INSERT INTO tenant_visitor_floor_policy (
|
||||
'pm_6f_vstr_policy_001',
|
||||
'2524639890ba4f2cba9ba1a4eeaa4015',
|
||||
'64fdc8eaf5824df5a1329819af29b79f',
|
||||
'INTERSECT_ALLOWLIST',
|
||||
'REPLACE_ALLOWLIST',
|
||||
'["605560545117995008","605560541473144832"]',
|
||||
NULL, 1, 1,
|
||||
'星河湾物业管理有限公司:访客策略(组织库);28F+6F(顺序:先 28 后 6,便于前端)。',
|
||||
'物业管理 | 访客默认28F+6F',
|
||||
UNIX_TIMESTAMP(NOW()) * 1000,
|
||||
UNIX_TIMESTAMP(NOW()) * 1000
|
||||
) ON DUPLICATE KEY UPDATE
|
||||
@@ -83,10 +83,10 @@ INSERT INTO tenant_visitor_floor_policy (
|
||||
'pm_6f_vstr_policy_002',
|
||||
'2524639890ba4f2cba9ba1a4eeaa4015',
|
||||
'8fc3f910bd834198a539832017fe920e',
|
||||
'INTERSECT_ALLOWLIST',
|
||||
'REPLACE_ALLOWLIST',
|
||||
'["605560545117995008","605560541473144832"]',
|
||||
NULL, 1, 1,
|
||||
'星河湾物业管理公司:访客策略(组织库);28F+6F(顺序:先 28 后 6,便于前端)。',
|
||||
'物业管理 | 访客默认28F+6F',
|
||||
UNIX_TIMESTAMP(NOW()) * 1000,
|
||||
UNIX_TIMESTAMP(NOW()) * 1000
|
||||
) ON DUPLICATE KEY UPDATE
|
||||
@@ -104,10 +104,10 @@ INSERT INTO tenant_visitor_floor_policy (
|
||||
'pm_6f_vstr_policy_003',
|
||||
'2524639890ba4f2cba9ba1a4eeaa4015',
|
||||
'cc760fdf9c384a0cbf4951ccf2c6452e',
|
||||
'INTERSECT_ALLOWLIST',
|
||||
'REPLACE_ALLOWLIST',
|
||||
'["605560545117995008","605560541473144832"]',
|
||||
NULL, 1, 1,
|
||||
'星河湾物管公司:访客策略(组织库);28F+6F(顺序:先 28 后 6,便于前端)。',
|
||||
'物业管理 | 访客默认28F+6F',
|
||||
UNIX_TIMESTAMP(NOW()) * 1000,
|
||||
UNIX_TIMESTAMP(NOW()) * 1000
|
||||
) ON DUPLICATE KEY UPDATE
|
||||
@@ -125,10 +125,10 @@ INSERT INTO tenant_visitor_floor_policy (
|
||||
'pm_6f_vstr_policy_004',
|
||||
'2524639890ba4f2cba9ba1a4eeaa4015',
|
||||
'f216235e54ca42bfa0379e69b3754aff',
|
||||
'INTERSECT_ALLOWLIST',
|
||||
'REPLACE_ALLOWLIST',
|
||||
'["605560545117995008","605560541473144832"]',
|
||||
NULL, 1, 1,
|
||||
'星中心物业管理公司:访客策略(组织库);28F+6F(顺序:先 28 后 6,便于前端)。',
|
||||
'物业管理 | 访客默认28F+6F',
|
||||
UNIX_TIMESTAMP(NOW()) * 1000,
|
||||
UNIX_TIMESTAMP(NOW()) * 1000
|
||||
) ON DUPLICATE KEY UPDATE
|
||||
@@ -146,10 +146,10 @@ INSERT INTO tenant_visitor_floor_policy (
|
||||
'pm_6f_vstr_policy_005',
|
||||
'2524639890ba4f2cba9ba1a4eeaa4015',
|
||||
'95818575a2284db6833289474d33671f',
|
||||
'INTERSECT_ALLOWLIST',
|
||||
'REPLACE_ALLOWLIST',
|
||||
'["605560545117995008","605560541473144832"]',
|
||||
NULL, 1, 1,
|
||||
'星中心物业服务中心:访客策略(组织库);28F+6F(顺序:先 28 后 6,便于前端)。',
|
||||
'物业管理 | 访客默认28F+6F',
|
||||
UNIX_TIMESTAMP(NOW()) * 1000,
|
||||
UNIX_TIMESTAMP(NOW()) * 1000
|
||||
) ON DUPLICATE KEY UPDATE
|
||||
@@ -167,10 +167,10 @@ INSERT INTO tenant_visitor_floor_policy (
|
||||
'pm_6f_vstr_policy_006',
|
||||
'2524639890ba4f2cba9ba1a4eeaa4015',
|
||||
'348328d755624b3491cd307a3109f36a',
|
||||
'INTERSECT_ALLOWLIST',
|
||||
'REPLACE_ALLOWLIST',
|
||||
'["605560545117995008","605560541473144832"]',
|
||||
NULL, 1, 1,
|
||||
'星中心物管公司:访客策略(组织库);28F+6F(顺序:先 28 后 6,便于前端)。',
|
||||
'物业管理 | 访客默认28F+6F',
|
||||
UNIX_TIMESTAMP(NOW()) * 1000,
|
||||
UNIX_TIMESTAMP(NOW()) * 1000
|
||||
) ON DUPLICATE KEY UPDATE
|
||||
@@ -188,10 +188,10 @@ INSERT INTO tenant_visitor_floor_policy (
|
||||
'pm_6f_vstr_policy_007',
|
||||
'2524639890ba4f2cba9ba1a4eeaa4015',
|
||||
'dde6cc9a4f6b4f5490d03e26fb016200',
|
||||
'INTERSECT_ALLOWLIST',
|
||||
'REPLACE_ALLOWLIST',
|
||||
'["605560545117995008","605560541473144832"]',
|
||||
NULL, 1, 1,
|
||||
'物业管理总部:访客策略(组织库);28F+6F(顺序:先 28 后 6,便于前端)。',
|
||||
'物业管理 | 访客默认28F+6F',
|
||||
UNIX_TIMESTAMP(NOW()) * 1000,
|
||||
UNIX_TIMESTAMP(NOW()) * 1000
|
||||
) ON DUPLICATE KEY UPDATE
|
||||
|
||||
@@ -0,0 +1,362 @@
|
||||
# 星河湾星中星 — 版本发布计划与部署包规范
|
||||
|
||||
**日期**: 2026-05-09
|
||||
**版本**: v1.0
|
||||
**适用范围**: cw-elevator-application 及平台所有组件
|
||||
|
||||
---
|
||||
|
||||
## 目录
|
||||
|
||||
1. [版本命名规范](#1-版本命名规范)
|
||||
2. [发布包目录结构与命名](#2-发布包目录结构与命名)
|
||||
3. [JAR 制品命名规范](#3-jar-制品命名规范)
|
||||
4. [配置文件规范](#4-配置文件规范)
|
||||
5. [数据库 SQL 脚本规范](#5-数据库-sql-脚本规范)
|
||||
6. [发布文档规范](#6-发布文档规范)
|
||||
7. [构建流程](#7-构建流程)
|
||||
8. [部署包交付清单](#8-部署包交付清单)
|
||||
9. [版本发布检查清单](#9-版本发布检查清单)
|
||||
|
||||
---
|
||||
|
||||
## 1. 版本命名规范
|
||||
|
||||
### 1.1 语义化版本
|
||||
|
||||
```
|
||||
MAJOR.MINOR.PATCH
|
||||
|
||||
MAJOR: 不兼容的 API 修改
|
||||
MINOR: 向下兼容的功能新增
|
||||
PATCH: 向下兼容的问题修复
|
||||
```
|
||||
|
||||
### 1.2 平台组件版本清单
|
||||
|
||||
| 组件 | 当前稳定版 | Maven artifactId | 所属服务 |
|
||||
|------|-----------|------------------|---------|
|
||||
| cw-elevator-application | 2.0.17 | cw-elevator-application | 电梯应用 |
|
||||
| ninca-common-component-organization | 2.9.4 | cwos-component-organization | 组织组件 |
|
||||
| intelligent-cwoscomponent | — | intelligent-cwoscomponent | Feign 接口定义 |
|
||||
| ninca-crk-std | — | ninca-crk-gpu-std | CRK 人脸识别 |
|
||||
| ninca-qk-alarm | — | ninca-qk-alarm | 报警服务 |
|
||||
| cloudwalk-common-* | 3.7.2 | cloudwalk-* | 公共库 |
|
||||
|
||||
### 1.3 版本号与日期标签
|
||||
|
||||
发布包命名包含版本号 + 构建日期:
|
||||
|
||||
```
|
||||
格式: <组件名>-V<MAJOR>.<MINOR>.<PATCH>.<YYYYMMDD>
|
||||
|
||||
示例:
|
||||
cw-elevator-application-V2.0.17.20260505
|
||||
ninca-common-component-organization-2.9.4-xinghewan-20260506
|
||||
```
|
||||
|
||||
**规则**:
|
||||
- 日期使用 `YYYYMMDD` 格式,取构建当天
|
||||
- 版本号与 Maven POM 中的 `<version>` 一致
|
||||
- 历史遗留标签 `-xinghewan` 保留用于 component-org 的星中星定制版本
|
||||
|
||||
---
|
||||
|
||||
## 2. 发布包目录结构与命名
|
||||
|
||||
### 2.1 发布包根目录命名
|
||||
|
||||
```
|
||||
<模块名>-V<版本号>.<日期>
|
||||
|
||||
# cw-elevator-application
|
||||
cw-elevator-application-V2.0.17.20260505/
|
||||
|
||||
# ninca-common-component-organization
|
||||
ninca-common-component-organization-2.9.4-xinghewan-20260506/
|
||||
```
|
||||
|
||||
### 2.2 电梯应用发布包内部结构
|
||||
|
||||
```
|
||||
cw-elevator-application-V2.0.17.20260505/
|
||||
├── cw-elevator-application-V1.0.0.20211103.jar # ★ JAR (固定名, 对齐V1)
|
||||
├── bootstrap.properties # 启动配置
|
||||
├── application.properties # 应用配置
|
||||
├── application-access-control.properties # 门禁配置
|
||||
├── run.sh # 启动脚本
|
||||
├── common-java.sh # Java 环境检测
|
||||
├── start.sh # systemd 启动
|
||||
├── stop.sh # systemd 停止
|
||||
├── cw-elevator-application.service # systemd unit
|
||||
├── ddl/
|
||||
│ ├── tenant_visitor_floor_policy.sql # DDL
|
||||
│ ├── tenant_visitor_floor_policy_init_guangfa_fund.sql # 广发种子 [@deprecated]
|
||||
│ └── tenant_visitor_floor_policy_init_property_mgmt_6f.sql # 物业种子 [@deprecated]
|
||||
├── 版本升级说明书.md
|
||||
├── 发布说明.md
|
||||
├── 甲方版本升级说明.md
|
||||
├── 升级计划.md
|
||||
├── 实施交付清单.md
|
||||
├── 实施验收记录模板.md
|
||||
├── SQL与代码一致性审核记录.md
|
||||
├── collect_elevator_runtime_evidence.sh # 现场证据采集
|
||||
└── BUILD_MANIFEST.txt # 构建清单
|
||||
```
|
||||
|
||||
### 2.3 组织组件发布包内部结构
|
||||
|
||||
```
|
||||
ninca-common-component-organization-2.9.4-xinghewan-20260506/
|
||||
├── ninca-common-component-organization-V2.9.2_20210730.jar # JAR
|
||||
├── application.properties
|
||||
├── bootstrap.properties
|
||||
├── recognition-logback.xml
|
||||
├── run-verify.sh
|
||||
└── ddl/
|
||||
└── organization_tenant_visitor_floor_policy_init_tenants.sql # ★ 活跃策略种子
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. JAR 制品命名规范
|
||||
|
||||
### 3.1 电梯应用 (特殊)
|
||||
|
||||
```
|
||||
JAR 文件名: cw-elevator-application-V1.0.0.20211103.jar (固定)
|
||||
|
||||
原因: 生产部署脚本和运维习惯依赖此文件名。不随内部版本号变化。
|
||||
内部版本由 BUILD_MANIFEST.txt 中的 git_rev 追踪。
|
||||
```
|
||||
|
||||
### 3.2 其他组件
|
||||
|
||||
```
|
||||
JAR 文件名: <artifactId>-<version>.jar
|
||||
|
||||
示例:
|
||||
ninca-common-component-organization-V2.9.2_20210730.jar
|
||||
```
|
||||
|
||||
### 3.3 Maven 版本号
|
||||
|
||||
POM 中的 `<version>` 字段在构建时由 release 脚本自动设置:
|
||||
- 构建前: `mvn versions:set -DnewVersion=<目标版本>`
|
||||
- 构建后: 恢复为 `2.0-SNAPSHOT`
|
||||
|
||||
---
|
||||
|
||||
## 4. 配置文件规范
|
||||
|
||||
### 4.1 配置文件命名
|
||||
|
||||
| 文件 | 用途 | 必需 |
|
||||
|------|------|------|
|
||||
| `bootstrap.properties` | Spring Cloud 引导配置 (服务名, Consul/ZK) | ✅ |
|
||||
| `application.properties` | 业务配置 (数据源, Redis, Dubbo, 楼层) | ✅ |
|
||||
| `application-access-control.properties` | 门禁/通行规则配置 | ✅ |
|
||||
| `application-test.properties` | 测试环境覆盖配置 | 测试用 |
|
||||
|
||||
### 4.2 配置关键属性命名
|
||||
|
||||
| 属性 | 格式 | 示例 |
|
||||
|------|------|------|
|
||||
| 楼层属性 | `<tenant>OrgId`, `<tenant>DefaultFloorId` | `xhwId`, `gfOrgId`, `xhwDefaultFloorId` |
|
||||
| 楼栋属性 | `floor.building.id` | `605560539791228928` |
|
||||
| Redis | `spring.redis.*` | — |
|
||||
| 数据源 | `spring.datasource.url` | `jdbc:mysql://host:port/db` |
|
||||
|
||||
---
|
||||
|
||||
## 5. 数据库 SQL 脚本规范
|
||||
|
||||
### 5.1 SQL 文件命名
|
||||
|
||||
```
|
||||
格式: [<库名>_]<表名>[_<用途>].sql
|
||||
|
||||
# DDL
|
||||
tenant_visitor_floor_policy.sql
|
||||
organization_tenant_visitor_floor_policy.sql
|
||||
|
||||
# 种子数据
|
||||
organization_tenant_visitor_floor_policy_init_tenants.sql
|
||||
|
||||
# 迁移
|
||||
tenant_visitor_floor_policy_v2.sql
|
||||
tenant_visitor_floor_policy_migrate_org_id.sql
|
||||
```
|
||||
|
||||
**命名规则**:
|
||||
- 不带 `organization_` 前缀 = 电梯库 (历史 V1, 已废弃)
|
||||
- 带 `organization_` 前缀 = 组织库 (活跃 V2)
|
||||
- `_init_` = 种子数据 INSERT
|
||||
- `_v2`, `_v3` = 版本迁移 DDL
|
||||
- `_migrate_` = 数据迁移 DML
|
||||
|
||||
### 5.2 策略数据规范
|
||||
|
||||
`tenant_visitor_floor_policy` 行的命名规范:
|
||||
|
||||
```sql
|
||||
-- ID 格式: {tenant_abbrev}_vstr_policy_{org_description}_{seq}
|
||||
-- 广发基金: gf_vstr_policy_guangfa_fund_001x
|
||||
-- 物业管理: pm_6f_vstr_policy_001 ~ 007
|
||||
|
||||
-- policy_type: REPLACE_ALLOWLIST (V2 正确语义, 非旧 INTERSECT_ALLOWLIST)
|
||||
|
||||
-- remark 格式: '{租户简称} | {策略说明} | org={org_id}'
|
||||
-- 示例: '广发基金 | org=[28-38F] | 访客默认28F'
|
||||
-- '物业管理 | 访客默认28F+6F'
|
||||
```
|
||||
|
||||
### 5.3 V2 维护规则
|
||||
|
||||
| 规则 | 说明 |
|
||||
|------|------|
|
||||
| 策略唯一维护库 | `component-organization` |
|
||||
| 电梯库策略表 | 已废弃 (`enabled=0`, `[DEPRECATED]` 前缀) |
|
||||
| 种子 SQL 维护 | 仅 `organization_tenant_visitor_floor_policy_init_tenants.sql` |
|
||||
| 电梯侧种子 SQL | 保留仅供历史参考 (`@deprecated` 注释) |
|
||||
|
||||
---
|
||||
|
||||
## 6. 发布文档规范
|
||||
|
||||
### 6.1 必需文档 (每个版本)
|
||||
|
||||
| 文档 | 文件名格式 | 内容 |
|
||||
|------|-----------|------|
|
||||
| 版本升级说明书 | `cw-elevator-application-v<VERSION>-版本升级说明书.md` | 变更内容、升级步骤 |
|
||||
| 发布说明 | `cw-elevator-application-v<VERSION>-发布说明.md` | 版本概述、新功能、修复 |
|
||||
| 甲方版本升级说明 | `cw-elevator-application-v<VERSION>-甲方版本升级说明.md` | 面向客户的升级说明 |
|
||||
| 升级计划 | `cw-elevator-application-v<VERSION>-升级计划.md` | 时间表、里程碑 |
|
||||
| 实施交付清单 | `cw-elevator-application-v<VERSION>-实施交付清单.md` | 交付物核对 |
|
||||
| 实施验收记录模板 | `cw-elevator-application-v<VERSION>-实施验收记录模板.md` | 验收标准 |
|
||||
| SQL审核记录 | `cw-elevator-application-v<VERSION>-SQL与代码一致性审核记录.md` | DDL/DML 审核 |
|
||||
| 构建清单 | `BUILD_MANIFEST.txt` | 自动生成 (git rev, java version, timestamp) |
|
||||
|
||||
### 6.2 文档版本回退
|
||||
|
||||
release 脚本在找不到特定版本文档时,自动回退到 `DOC_FALLBACK_VER` (当前: `2.0.6`):
|
||||
|
||||
```bash
|
||||
DOC_FALLBACK_VER="${DOC_FALLBACK_VER:-2.0.6}"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 7. 构建流程
|
||||
|
||||
### 7.1 构建命令
|
||||
|
||||
```bash
|
||||
# 在仓库根目录执行
|
||||
./scripts/build/release-cw-elevator-application.sh <版本号>
|
||||
|
||||
# 示例: 构建 v2.0.18
|
||||
./scripts/build/release-cw-elevator-application.sh 2.0.18
|
||||
|
||||
# 指定日期标签
|
||||
RELEASE_DATE_LABEL=20260509 ./scripts/build/release-cw-elevator-application.sh 2.0.18
|
||||
|
||||
# 不生成 zip (仅目录)
|
||||
RELEASE_MAKE_ZIP=0 ./scripts/build/release-cw-elevator-application.sh 2.0.18
|
||||
```
|
||||
|
||||
### 7.2 构建步骤
|
||||
|
||||
```
|
||||
Step 1: 环境检查 (JDK 8)
|
||||
Step 2: mvn versions:set → 目标版本
|
||||
Step 3: mvn package → 编译打包 (fat JAR)
|
||||
Step 4: 复制 JAR 到 releases/
|
||||
Step 5: 复制 DDL/SQL 到 releases/ddl/
|
||||
Step 6: 复制文档到 releases/
|
||||
Step 7: 复制配置文件 (bootstrap/application*.properties)
|
||||
Step 8: 复制运行脚本 (run.sh, start.sh, stop.sh, common-java.sh)
|
||||
Step 9: 生成 systemd service 文件
|
||||
Step 10: 复制现场证据采集脚本
|
||||
Step 11: 生成 BUILD_MANIFEST.txt
|
||||
Step 12: 可选: 打包 zip
|
||||
Step 13: mvn versions:set → 恢复 2.0-SNAPSHOT
|
||||
```
|
||||
|
||||
### 7.3 构建产出
|
||||
|
||||
```
|
||||
backend/cw-elevator-application/releases/
|
||||
├── cw-elevator-application-V2.0.18.20260509/ # 发布目录
|
||||
└── cw-elevator-application-V2.0.18.20260509.zip # (可选) 压缩包
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 8. 部署包交付清单
|
||||
|
||||
### 8.1 必须交付
|
||||
|
||||
| # | 交付物 | 格式 | 说明 |
|
||||
|---|--------|------|------|
|
||||
| 1 | JAR 文件 | `.jar` | 固定文件名 |
|
||||
| 2 | bootstrap.properties | `.properties` | 启动引导 |
|
||||
| 3 | application.properties | `.properties` | 业务配置 |
|
||||
| 4 | application-access-control.properties | `.properties` | 门禁配置 |
|
||||
| 5 | DDL SQL | `.sql` | 表结构 |
|
||||
| 6 | 种子 SQL | `.sql` | 初始数据 (仅组织库) |
|
||||
| 7 | 运行脚本 | `.sh` | run.sh, start.sh, stop.sh |
|
||||
| 8 | systemd unit | `.service` | Linux 服务配置 |
|
||||
| 9 | 版本升级说明书 | `.md` | 变更内容 |
|
||||
| 10 | 发布说明 | `.md` | 版本概述 |
|
||||
| 11 | 甲方升级说明 | `.md` | 客户版 |
|
||||
| 12 | 升级计划 | `.md` | 时间表 |
|
||||
| 13 | 实施交付清单 | `.md` | 核对表 |
|
||||
| 14 | 验收记录模板 | `.md` | 验收标准 |
|
||||
| 15 | SQL审核记录 | `.md` | DDL/DML 审核 |
|
||||
| 16 | 构建清单 | `.txt` | git rev, 时间戳 |
|
||||
| 17 | 证据采集脚本 | `.sh` | 现场运维 |
|
||||
|
||||
### 8.2 不应交付
|
||||
|
||||
| 项目 | 原因 |
|
||||
|------|------|
|
||||
| Maven target/ 目录 | 构建中间产物 |
|
||||
| 源码 `.java` | 闭源交付 |
|
||||
| `.git/` | 版本库 |
|
||||
| IDE 配置 `.idea/`, `.iml` | 本地开发配置 |
|
||||
| 测试脚本和测试数据 | 非生产用途 |
|
||||
|
||||
---
|
||||
|
||||
## 9. 版本发布检查清单
|
||||
|
||||
### 发布前
|
||||
|
||||
- [ ] 所有单元测试通过
|
||||
- [ ] `policy_type` 值为 `REPLACE_ALLOWLIST` (非旧 `INTERSECT_ALLOWLIST`)
|
||||
- [ ] DDL 仅在 `organization_tenant_visitor_floor_policy_init_tenants.sql` 维护
|
||||
- [ ] 电梯侧 SQL 已标记 `@deprecated`
|
||||
- [ ] JDK 8 编译验证 (`java -version` → `1.8.x`)
|
||||
- [ ] Maven POM 版本号与发布版本一致
|
||||
- [ ] `BUILD_MANIFEST.txt` 包含正确的 git rev
|
||||
- [ ] 配置文件中无测试环境硬编码值 (如 `localhost:9517`)
|
||||
|
||||
### 发布后
|
||||
|
||||
- [ ] 发布包目录结构完整 (16 项交付物)
|
||||
- [ ] `run.sh` 可执行权限正确 (`chmod 755`)
|
||||
- [ ] systemd service 文件路径占位符已替换
|
||||
- [ ] zip 包 (如生成) 可正常解压
|
||||
- [ ] SQL 文件可正常导入 (语法无误)
|
||||
- [ ] 版本升级说明书版本号与发布包一致
|
||||
|
||||
### 数据库一致性
|
||||
|
||||
- [ ] `component-organization.tenant_visitor_floor_policy` 所有行:
|
||||
- `policy_type` = `REPLACE_ALLOWLIST`
|
||||
- `enabled` = 1 (需启用的行)
|
||||
- `remark` 格式统一: `'{租户} | {说明} | org={org_id}'`
|
||||
- [ ] `cw-elevator-application.tenant_visitor_floor_policy` 所有行:
|
||||
- `enabled` = 0
|
||||
- `remark` 以 `[DEPRECATED]` 开头
|
||||
+218
@@ -0,0 +1,218 @@
|
||||
#!/usr/bin/env bash
|
||||
# 构建 cw-elevator-application 指定版本发布包,输出到 maven 模块下 releases/。
|
||||
# 目录命名对齐历史运行包 cw-elevator-application-V1.0.0.20211103:
|
||||
# cw-elevator-application-V<版本>.<日期>(日期默认当天 YYYYMMDD,可用 RELEASE_DATE_LABEL 覆盖)。
|
||||
# 用法:在仓库根执行 ./scripts/release-cw-elevator-application.sh [版本号]
|
||||
# JAR 命名对齐 V1 运行包 cw-elevator-application-V1.0.0.20211103.jar。
|
||||
# 当前基线版本 v2.0.17,构建时传入新版本号:./release-cw-elevator-application.sh 2.0.x
|
||||
set -euo pipefail
|
||||
|
||||
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
|
||||
MAVEN_ROOT="${ROOT}/backend/cw-elevator-application"
|
||||
REL_VER="${1:-2.0.8}"
|
||||
RELEASE_DATE_LABEL="${RELEASE_DATE_LABEL:-$(date +%Y%m%d)}"
|
||||
JAR_NAME="cw-elevator-application-V1.0.0.20211103.jar"
|
||||
BUNDLE_DIR_NAME="cw-elevator-application-V${REL_VER}.${RELEASE_DATE_LABEL}"
|
||||
OUT_DIR="${MAVEN_ROOT}/releases/${BUNDLE_DIR_NAME}"
|
||||
DOC_FALLBACK_VER="${DOC_FALLBACK_VER:-2.0.6}"
|
||||
|
||||
JAVA_HOME="${JAVA_HOME:-/usr/lib/jvm/java-8-openjdk-amd64}"
|
||||
export JAVA_HOME
|
||||
export PATH="${JAVA_HOME}/bin:${PATH}"
|
||||
|
||||
if ! java -version 2>&1 | grep -q 'version "1\.8\.'; then
|
||||
echo "ERROR: 需要 JDK 8(JAVA_HOME=${JAVA_HOME})。当前:" >&2
|
||||
java -version >&2 || true
|
||||
exit 1
|
||||
fi
|
||||
|
||||
rm -rf "${OUT_DIR}"
|
||||
mkdir -p "${OUT_DIR}"
|
||||
|
||||
require_file() {
|
||||
local file_path="$1"
|
||||
local hint="$2"
|
||||
if [[ ! -f "${file_path}" ]]; then
|
||||
echo "ERROR: 缺少必需文件: ${file_path} (${hint})" >&2
|
||||
exit 1
|
||||
fi
|
||||
}
|
||||
|
||||
echo "==> Set reactor version to ${REL_VER}"
|
||||
(cd "${MAVEN_ROOT}" && mvn -q org.codehaus.mojo:versions-maven-plugin:2.16.2:set \
|
||||
-DnewVersion="${REL_VER}" -DprocessAllModules=true -DgenerateBackupPoms=false)
|
||||
|
||||
echo "==> Package starter (fat jar)"
|
||||
(cd "${MAVEN_ROOT}" && mvn -q -pl cw-elevator-application-starter -am package -DskipTests)
|
||||
|
||||
SRC_JAR="${MAVEN_ROOT}/cw-elevator-application-starter/target/${JAR_NAME}"
|
||||
if [[ ! -f "${SRC_JAR}" ]]; then
|
||||
for candidate in $(ls -1t "${MAVEN_ROOT}/cw-elevator-application-starter/target"/cw-elevator-application-*.jar 2>/dev/null || true); do
|
||||
if [[ "${candidate}" == *.jar.original ]]; then
|
||||
continue
|
||||
fi
|
||||
SRC_JAR="${candidate}"
|
||||
break
|
||||
done
|
||||
fi
|
||||
if [[ -z "${SRC_JAR}" || ! -f "${SRC_JAR}" ]]; then
|
||||
echo "ERROR: 未找到可用 starter 制品(期望 ${JAR_NAME} 或 cw-elevator-application-*.jar)" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
echo "==> Copy artifacts to ${OUT_DIR}"
|
||||
install -m0644 "${SRC_JAR}" "${OUT_DIR}/${JAR_NAME}"
|
||||
|
||||
# ── DDL (表结构) ──
|
||||
DDL_SRC="${ROOT}/docs/sql/tenant_visitor_floor_policy.sql"
|
||||
DDL_DIR="${OUT_DIR}/ddl"
|
||||
mkdir -p "${DDL_DIR}"
|
||||
require_file "${DDL_SRC}" "DDL"
|
||||
install -m0644 "${DDL_SRC}" "${DDL_DIR}/tenant_visitor_floor_policy.sql"
|
||||
|
||||
# ── 组织侧 DDL + 种子 (V2 活跃, 唯一维护点) ──
|
||||
ORG_DDL_SRC="${ROOT}/docs/sql/organization_tenant_visitor_floor_policy.sql"
|
||||
if [[ -f "${ORG_DDL_SRC}" ]]; then
|
||||
install -m0644 "${ORG_DDL_SRC}" "${DDL_DIR}/organization_tenant_visitor_floor_policy.sql"
|
||||
fi
|
||||
ORG_INIT_SRC="${ROOT}/docs/sql/organization_tenant_visitor_floor_policy_init_tenants.sql"
|
||||
require_file "${ORG_INIT_SRC}" "组织侧策略种子 (V2 活跃)"
|
||||
install -m0644 "${ORG_INIT_SRC}" "${DDL_DIR}/organization_tenant_visitor_floor_policy_init_tenants.sql"
|
||||
|
||||
# ── 电梯侧种子 (@deprecated, 仅历史参考) ──
|
||||
DDL_INIT_SRC="${ROOT}/docs/sql/tenant_visitor_floor_policy_init_guangfa_fund.sql"
|
||||
require_file "${DDL_INIT_SRC}" "初始化 SQL(广发基金-废弃)"
|
||||
install -m0644 "${DDL_INIT_SRC}" "${DDL_DIR}/tenant_visitor_floor_policy_init_guangfa_fund.sql"
|
||||
|
||||
DDL_PROP_MGMT_SRC="${ROOT}/docs/sql/tenant_visitor_floor_policy_init_property_mgmt_6f.sql"
|
||||
if [[ -f "${DDL_PROP_MGMT_SRC}" ]]; then
|
||||
install -m0644 "${DDL_PROP_MGMT_SRC}" "${DDL_DIR}/tenant_visitor_floor_policy_init_property_mgmt_6f.sql"
|
||||
fi
|
||||
|
||||
# ── DDL 废弃说明 ──
|
||||
cat > "${DDL_DIR}/README_DDL.txt" << 'DDL_README'
|
||||
# tenant_visitor_floor_policy DDL 说明
|
||||
#
|
||||
# V2 活跃策略(唯一维护点):
|
||||
# organization_tenant_visitor_floor_policy.sql — 组织库 DDL
|
||||
# organization_tenant_visitor_floor_policy_init_tenants.sql — 组织库种子数据
|
||||
# 执行目标库: component-organization
|
||||
#
|
||||
# @deprecated 电梯侧(历史遗留,V2 不查询):
|
||||
# tenant_visitor_floor_policy.sql
|
||||
# tenant_visitor_floor_policy_init_guangfa_fund.sql
|
||||
# tenant_visitor_floor_policy_init_property_mgmt_6f.sql
|
||||
# 保留仅供历史参考。V2 电梯代码已移除策略查询。
|
||||
DDL_README
|
||||
|
||||
UPGRADE_SRC="${ROOT}/docs/build/cw-elevator-application-v${REL_VER}-版本升级说明书.md"
|
||||
if [[ ! -f "${UPGRADE_SRC}" ]]; then
|
||||
UPGRADE_SRC="${ROOT}/docs/build/cw-elevator-application-v${DOC_FALLBACK_VER}-版本升级说明书.md"
|
||||
fi
|
||||
require_file "${UPGRADE_SRC}" "版本升级说明书"
|
||||
install -m0644 "${UPGRADE_SRC}" "${OUT_DIR}/版本升级说明书.md"
|
||||
|
||||
INDEX_SRC="${ROOT}/docs/build/cw-elevator-application-v${REL_VER}-发布说明.md"
|
||||
if [[ ! -f "${INDEX_SRC}" ]]; then
|
||||
INDEX_SRC="${ROOT}/docs/build/cw-elevator-application-v${DOC_FALLBACK_VER}-发布说明.md"
|
||||
fi
|
||||
require_file "${INDEX_SRC}" "发布说明"
|
||||
install -m0644 "${INDEX_SRC}" "${OUT_DIR}/发布说明.md"
|
||||
|
||||
CLIENT_SRC="${ROOT}/docs/build/cw-elevator-application-v${REL_VER}-甲方版本升级说明.md"
|
||||
if [[ ! -f "${CLIENT_SRC}" ]]; then
|
||||
CLIENT_SRC="${ROOT}/docs/build/cw-elevator-application-v${DOC_FALLBACK_VER}-甲方版本升级说明.md"
|
||||
fi
|
||||
require_file "${CLIENT_SRC}" "甲方版本升级说明"
|
||||
install -m0644 "${CLIENT_SRC}" "${OUT_DIR}/甲方版本升级说明.md"
|
||||
|
||||
PLAN_SRC="${ROOT}/docs/build/cw-elevator-application-v${REL_VER}-升级计划.md"
|
||||
if [[ ! -f "${PLAN_SRC}" ]]; then
|
||||
PLAN_SRC="${ROOT}/docs/build/cw-elevator-application-v${DOC_FALLBACK_VER}-升级计划.md"
|
||||
fi
|
||||
require_file "${PLAN_SRC}" "升级计划"
|
||||
install -m0644 "${PLAN_SRC}" "${OUT_DIR}/升级计划.md"
|
||||
|
||||
# 与历史运行包 cw-elevator-application-V1.0.0.20211103 一致:bootstrap/application*.properties 仅置于发布根目录(与 JAR、start.sh 同层),不另建 config/ 重复一份。
|
||||
for conf_name in bootstrap.properties application.properties application-access-control.properties; do
|
||||
CONF_SRC="${MAVEN_ROOT}/deploy/v2-maven/${conf_name}"
|
||||
require_file "${CONF_SRC}" "配置文件 ${conf_name}"
|
||||
install -m0644 "${CONF_SRC}" "${OUT_DIR}/${conf_name}"
|
||||
done
|
||||
|
||||
COMMON_JAVA_SRC="${MAVEN_ROOT}/deploy/common-java.sh"
|
||||
require_file "${COMMON_JAVA_SRC}" "common-java.sh(run.sh 依赖)"
|
||||
install -m0644 "${COMMON_JAVA_SRC}" "${OUT_DIR}/common-java.sh"
|
||||
|
||||
RUNNER_SRC="${MAVEN_ROOT}/deploy/v2-maven/run.sh"
|
||||
require_file "${RUNNER_SRC}" "启动脚本 run.sh"
|
||||
install -m0755 "${RUNNER_SRC}" "${OUT_DIR}/run.sh"
|
||||
|
||||
TEMPLATE_DIR="${MAVEN_ROOT}/deploy/release-bundle-templates"
|
||||
require_file "${TEMPLATE_DIR}/start.sh.template" "release-bundle start.sh.template"
|
||||
require_file "${TEMPLATE_DIR}/stop.sh.template" "release-bundle stop.sh.template"
|
||||
require_file "${TEMPLATE_DIR}/cw-elevator-application.service.template" "release-bundle service template"
|
||||
DEPLOY_DIR_PLACEHOLDER="${DEPLOY_DIR_PLACEHOLDER:-/path/to/cw-elevator-application}"
|
||||
sed -e "s/__JAR_NAME__/${JAR_NAME}/g" -e "s/__REL_VER__/${REL_VER}/g" \
|
||||
"${TEMPLATE_DIR}/start.sh.template" > "${OUT_DIR}/start.sh"
|
||||
chmod 0755 "${OUT_DIR}/start.sh"
|
||||
sed -e "s/__JAR_NAME__/${JAR_NAME}/g" \
|
||||
"${TEMPLATE_DIR}/stop.sh.template" > "${OUT_DIR}/stop.sh"
|
||||
chmod 0755 "${OUT_DIR}/stop.sh"
|
||||
sed -e "s/__JAR_NAME__/${JAR_NAME}/g" -e "s/__REL_VER__/${REL_VER}/g" \
|
||||
-e "s|__DEPLOY_DIR__|${DEPLOY_DIR_PLACEHOLDER}|g" \
|
||||
"${TEMPLATE_DIR}/cw-elevator-application.service.template" > "${OUT_DIR}/cw-elevator-application.service"
|
||||
chmod 0644 "${OUT_DIR}/cw-elevator-application.service"
|
||||
|
||||
EVIDENCE_SRC="${ROOT}/scripts/collect_elevator_runtime_evidence.sh"
|
||||
require_file "${EVIDENCE_SRC}" "collect_elevator_runtime_evidence.sh(现场证据采集)"
|
||||
install -m0755 "${EVIDENCE_SRC}" "${OUT_DIR}/collect_elevator_runtime_evidence.sh"
|
||||
|
||||
DELIVERY_SRC="${ROOT}/docs/build/cw-elevator-application-v${REL_VER}-实施交付清单.md"
|
||||
if [[ ! -f "${DELIVERY_SRC}" ]]; then
|
||||
DELIVERY_SRC="${ROOT}/docs/build/cw-elevator-application-v${DOC_FALLBACK_VER}-实施交付清单.md"
|
||||
fi
|
||||
require_file "${DELIVERY_SRC}" "实施交付清单"
|
||||
install -m0644 "${DELIVERY_SRC}" "${OUT_DIR}/实施交付清单.md"
|
||||
|
||||
ACCEPTANCE_SRC="${ROOT}/docs/build/cw-elevator-application-v${REL_VER}-实施验收记录模板.md"
|
||||
if [[ ! -f "${ACCEPTANCE_SRC}" ]]; then
|
||||
ACCEPTANCE_SRC="${ROOT}/docs/build/cw-elevator-application-v${DOC_FALLBACK_VER}-实施验收记录模板.md"
|
||||
fi
|
||||
require_file "${ACCEPTANCE_SRC}" "实施验收记录模板"
|
||||
install -m0644 "${ACCEPTANCE_SRC}" "${OUT_DIR}/实施验收记录模板.md"
|
||||
|
||||
AUDIT_SRC="${ROOT}/docs/build/cw-elevator-application-v${REL_VER}-SQL与代码一致性审核记录.md"
|
||||
if [[ ! -f "${AUDIT_SRC}" ]]; then
|
||||
AUDIT_SRC="${ROOT}/docs/build/cw-elevator-application-v${DOC_FALLBACK_VER}-SQL与代码一致性审核记录.md"
|
||||
fi
|
||||
require_file "${AUDIT_SRC}" "SQL与代码一致性审核记录"
|
||||
install -m0644 "${AUDIT_SRC}" "${OUT_DIR}/SQL与代码一致性审核记录.md"
|
||||
|
||||
{
|
||||
echo "artifact=${JAR_NAME}"
|
||||
echo "bundle_dir_name=${BUNDLE_DIR_NAME}"
|
||||
echo "directory=${OUT_DIR}"
|
||||
echo "built_at=$(date -Iseconds 2>/dev/null || date)"
|
||||
echo "java_home=${JAVA_HOME}"
|
||||
java -version 2>&1 | sed 's/^/java_version_line=/' || true
|
||||
echo -n "git_rev="
|
||||
(cd "${ROOT}" && git rev-parse HEAD 2>/dev/null) || echo "unknown"
|
||||
echo -n "git_branch="
|
||||
(cd "${ROOT}" && git rev-parse --abbrev-ref HEAD 2>/dev/null) || echo "unknown"
|
||||
} > "${OUT_DIR}/BUILD_MANIFEST.txt"
|
||||
|
||||
if [[ "${RELEASE_MAKE_ZIP:-1}" == "1" ]]; then
|
||||
ZIP_NAME="${BUNDLE_DIR_NAME}.zip"
|
||||
ZIP_OUT="${MAVEN_ROOT}/releases/${ZIP_NAME}"
|
||||
rm -f "${ZIP_OUT}"
|
||||
(cd "${MAVEN_ROOT}/releases" && zip -rq "${ZIP_NAME}" "${BUNDLE_DIR_NAME}")
|
||||
echo "==> Zip artifact: ${ZIP_OUT}"
|
||||
fi
|
||||
|
||||
echo "==> Restore reactor version to 2.0-SNAPSHOT"
|
||||
(cd "${MAVEN_ROOT}" && mvn -q org.codehaus.mojo:versions-maven-plugin:2.16.2:set \
|
||||
-DnewVersion=2.0-SNAPSHOT -DprocessAllModules=true -DgenerateBackupPoms=false)
|
||||
|
||||
echo "==> Done."
|
||||
ls -la "${OUT_DIR}"
|
||||
Reference in New Issue
Block a user