# ARR 测试数据库远程迁移记录

执行日期：2026-07-28  
状态：完整迁移已提交并验收。

## 范围

- 源：`<LEGACY_DB_HOST>:5433/booking_test`，PostgreSQL 15.18
- 目标：`<ARR_DB_HOST>:5432/booking_test`，PostgreSQL 15.14
- 目标用户：`<TEST_DB_OWNER>`，数据库 owner，非超级用户
- 迁移对象：`ingestion`、`booking`、`finance`
- 源库处理：只读，未修改、未删除，继续保留作为临时回退

## 执行内容

- 应用 DDL：`database/008_arr_mvp_v1_rebuild.sql`
- DDL SHA-256：`a29df928a2bcfca262216a9d53260528374b830266b3285f3687199cb802a530`
- 基础表：14
- 视图：8
- 同步所有 identity sequence 的 `last_value/is_called`
- 迁移全部现有测试数据、处理审计和工件元数据

## 迁移前备份

- 目录：`<PRIVATE_BACKUP_ROOT>/booking_test_pre_remote_migration_20260728T180747+0800`
- manifest SHA-256：`db8ca84fed52123d10151b475aca31659be237c6e7d513484e4f25b1d9a89c4d`
- 备份权限：目录 0700，文件 0600
- 内容：14 表逐行 gzip JSON、schema/约束/索引/视图/函数/触发器/sequence 元数据、目标空库证据

## 安全执行

1. 只读确认目标 ARR schema 为空，用户为数据库 owner 且具备 CREATE。
2. 在目标执行一次完整 DDL + 全量复制 + 校验 + 强制 ROLLBACK 演练。
3. 第二连接确认演练后目标仍为空。
4. 正式执行相同流程，结构与数据在一个 SERIALIZABLE 事务内提交。
5. 任一步失败都会回滚；未发生部分提交。

## 最终一致性

- 双端结构 signature：`0d64002b919d439dbbbbf78d1f5c5fab86d8f815f80dc6225f17a91ab5455e38`
- 双端 14 表内容 hash bundle：`42faf898d67b3015e85baf00bbd66a1fa4448d80daa7f5d9d0207a4004fad35c`
- 双端逐表行数和逐表内容 SHA-256：全部一致
- identity sequence state：全部一致
- 未验证约束：0
- 目标 `public` 用户对象：0

关键数据计数：

| 表 | 行数 |
|---|---:|
| `booking.source_rows` | 867 |
| `booking.parse_versions` | 867 |
| `booking.room_items` | 867 |
| `booking.current_row_parses` | 867 |
| `finance.daily_versions` | 1 |
| `finance.current_daily_versions` | 1 |
| `finance.daily_records` | 3 |
| `ingestion.artifacts` | 5 |
| `ingestion.processing_runs` | 2 |

Finance outcome：retained、duplicate、excluded_rate_code 各 1。

## 应用验收

使用新远程数据库实际运行：

- 渠道 BI：1 个渠道、1 条 retained；
- 渠道明细：1 行；
- 月报生成源：1 行；
- 公司报表：1 行，Booking Room 为 `【DBL】1`；
- Web 日报列表：1 条；
- Web 月度数据源投影：1 行。

## 当前配置

- 当前测试库配置：`/path/to/private/booking-test-db.env`（0600）
- 旧 LAN 回退配置：`/path/to/private/booking-test-lan-db.env`（0600）

文档不保存密码。应用应优先使用新远程配置；在观察期结束前不要删除旧 LAN 库。