收口V4 OWNER RATE目录数据

2026-07-21 19:11:57 +07:00
parent f3b6adda17
commit 6e97778633
19 changed files with 520 additions and 188 deletions
--- a/docs/project/requirements/M002-v4-agent-callback-field-contract.md
+++ b/docs/project/requirements/M002-v4-agent-callback-field-contract.md
@@ -16,7 +16,7 @@

 本契约用于后续 M002 V4 主流程设计、后端领域建模、前端页面模型、Adapter / MCP Schema 对齐和 SuperAgent 联调。当前后端已按本文完成 V4 入站解析和多卡模型基线：能识别 V4 包、校验关键契约、保存 AI transition / 任务卡原始 payload，并把可映射的六类 event 写入 V4 订单任务和任务卡模型。

-V4 订单任务与多卡领域模型的 CP2 设计已经单独落到 `M002-v4-order-task-card-domain-model-cp2.md`。截至 CP14 和停止旧任务双写 checkpoint，表结构、Entity、Mapper、Repository、SuperAgent V4 入站写入、V4 查询、普通卡片确认、S10/S99 ack、V4 复核解阻、数据库目录、Account / Room Type / Rate Code Lookup API、目录管理后台 CP1 后端接口、订单列表 V4 继续处理入口字段，以及 V4 普通业务不再创建旧 `workflow_reservation_task` 已实现。Room Information 卡 New / Update / Cancel 展示模型、Nights / Breakfast / Group Booking Status 派生，以及 Rooming List 确认后 Group 自动置 `DEF` 的后端联动已实现；这些均不扩大 SuperAgent 输入字段。下一阶段已确认 Rate Code 需要按订单级 Account + `booking_type`（GROUP / FIT）过滤和校验，当前实现仍是酒店级 Rate Code 目录；Payment 卡需要补付款凭证附件安全摘要和预览 / 下载联动；真实 PMS 同步仍后置，方案见 `M002-v4-real-catalog-lookup-api-design.md`。
+V4 订单任务与多卡领域模型的 CP2 设计已经单独落到 `M002-v4-order-task-card-domain-model-cp2.md`。截至 CP14 和停止旧任务双写 checkpoint，表结构、Entity、Mapper、Repository、SuperAgent V4 入站写入、V4 查询、普通卡片确认、S10/S99 ack、V4 复核解阻、数据库目录、Account / Room Type / Rate Code Lookup API、目录管理后台 CP1 后端接口、订单列表 V4 继续处理入口字段，以及 V4 普通业务不再创建旧 `workflow_reservation_task` 已实现。Room Information 卡 New / Update / Cancel 展示模型、Nights / Breakfast / Group Booking Status 派生，以及 Rooming List 确认后 Group 自动置 `DEF` 的后端联动已实现；这些均不扩大 SuperAgent 输入字段。2026-07-21 OWNER RATE `RATECODE (2)` 只读整理已确认：Room Type 第一阶段只维护 `RM2`、`RM3`、`RM4`、`SU1`、`SU2`、`SU3` 六个稳定 code，不建 Account -> Room Type 关系；Rate Code 第一阶段暂不建立 Account 适用关系，Q.B.D / LIAN TAI 的 40 个规范化 Rate Code 作为酒店级目录候选；真实 PMS 同步仍后置，方案见 `M002-v4-real-catalog-lookup-api-design.md`。

 当前已确认开发阶段数据可以清空，因此 M002 V4 后续可以按新模型重建，不要求兼容旧任务数据、旧草稿、旧 OPERA 模拟、旧 `S000/S999`、旧 Fallback 或旧 `case_keys`。

@@ -199,7 +199,7 @@ Agent 给出非空 `account_code`，但信息系统运行时目录不存在该
 - Market / Source：由 Account 派生，当前分别为 `LEISURE` / `TRAVEL_AGENT`。
 - SuperAgent 不需要输出 `market_code`、`source_code`、`account_name`，也不要输出显示名称替代 `account_code`。
 - 如果 SuperAgent 输出的 `account_code` 不在上述目录，后端会创建 `REVIEW_REQUIRED` Basic Information 卡，并在 `validation_errors_json` / 查询 `fields[].validation_errors` 中返回目录错误。
- 如果 SuperAgent 输出的业务卡 `room_items[].room_type_code` 或 `rate_code` 不在当前酒店数据库目录，后端会创建 `REVIEW_REQUIRED` 业务卡，并在 `validation_errors_json` / 查询 `fields[].validation_errors` 中返回目录错误；下一阶段 `rate_code` 还必须属于该 `order_ref` 的 Basic Information Account + 当前 event `target_order.booking_type` 的适用关系，否则同样进入 `REVIEW_REQUIRED`。用户可通过 V4 复核解阻接口提交对应字段 pointer 修正。
+- 如果 SuperAgent 输出的业务卡 `room_items[].room_type_code` 或 `rate_code` 不在当前酒店数据库目录，后端会创建 `REVIEW_REQUIRED` 业务卡，并在 `validation_errors_json` / 查询 `fields[].validation_errors` 中返回目录错误；Rate Code 第一阶段暂不校验 Account 适用关系。用户可通过 V4 复核解阻接口提交对应字段 pointer 修正。

 ## 8. message_events 公共字段

@@ -310,11 +310,11 @@ Fallback、`Need Manual Review`、独立 Voucher、旧 Payment Evidence、Vouche
  },
  "arrival_date": "2026-07-26",
  "departure_date": "2026-07-29",
-  "rate_code": "RATE_CODE",
+  "rate_code": "GRPA2-850UP",
  "booking_scenario": "STANDARD",
  "room_items": [
    {
-      "room_type_code": "TWN",
+      "room_type_code": "RM2",
      "room_count": 1
    }
  ],
@@ -336,7 +336,7 @@ Fit 条件字段：
 | --- | --- | --- | --- |
 | `arrival_date` | Group / Fit | 是，可为 `null` | 入住日期，酒店本地日期 |
 | `departure_date` | Group / Fit | 是，可为 `null` | 离店日期，酒店本地日期 |
-| `rate_code` | Group / Fit | 是，可为 `null` | 订单级 Rate Code；下一阶段必须属于该订单 Account + `booking_type` 的适用范围 |
+| `rate_code` | Group / Fit | 是，可为 `null` | 订单级 Rate Code；第一阶段只要求属于当前酒店 `ACTIVE` 的 `RATE_CODE` 目录 |
 | `room_items[]` | Group / Fit | 是 | 完整房型清单 |
 | `room_items[].room_type_code` | Group / Fit | 是，可为 `null` | 受控 RoomType code |
 | `room_items[].room_count` | Group / Fit | 是 | 房量，正整数 |
@@ -371,7 +371,7 @@ Fit 条件字段：
    "departure_date": "2026-07-30",
    "room_items": [
      {
-        "room_type_code": "TWN",
+        "room_type_code": "RM2",
        "room_count": 3
      }
    ]
@@ -447,7 +447,7 @@ Fit 条件字段：
    },
    {
      "item_type": "EXTRA_BED",
-      "target_room_type_code": "TWN",
+      "target_room_type_code": "RM2",
      "extra_bed_room_count": 1,
      "department_code": "FO+HSK"
    }
@@ -638,13 +638,13 @@ Account、RoomType、RateCode 的目录由信息系统或其主数据服务统
 规则：

 - SuperAgent 只能输出目录中已有的稳定 code；Trace `department_code` 在 Department 目录未正式落地前只能输出 `FO`、`HSK`、`FO+HSK`。
- SuperAgent 输出 `rate_code` 时必须结合当前 `order_ref` 的 `basic_information.account_code` 和 event `target_order.booking_type` 判断候选范围；本阶段只要求 Account + GROUP/FIT，不要求按房型、入住日期或价格计算。
+- SuperAgent 输出 `rate_code` 时只需要输出当前酒店目录中的稳定 code；第一阶段不要求结合当前 `order_ref` 的 `basic_information.account_code` 或 event `target_order.booking_type` 判断候选范围。
 - 不允许输出自由文本或自行创造 code。
 - Agent 无法可靠匹配时，按对应业务字段的未解决规则处理。
 - Agent 输出非空 code、但信息系统目录不存在该值时，属于目录校验或契约问题。
 - Market 和 Source 由信息系统根据订单级 `account_code` 派生，不由 Agent 输出。

-当前项目接受“SuperAgent 确定后把目录给本系统”的落地方式。第一阶段已用固定种子目录完成开发闭环；真实目录、系统管理维护、PMS / OPERA / OHIP 同步、前端 lookup API、缓存、权限和兜底策略已在 `M002-v4-real-catalog-lookup-api-design.md` 中设计。Account 范围 Rate Code 不改变 SuperAgent V4 输入结构：SuperAgent 仍只输出稳定 `rate_code`，不输出显示名、价格或目录完整对象；适用性由本系统后端目录服务最终校验。
+当前项目接受“SuperAgent 确定后把目录给本系统”的落地方式。第一阶段已用固定种子目录完成开发闭环；真实目录、系统管理维护、PMS / OPERA / OHIP 同步、前端 lookup API、缓存、权限和兜底策略已在 `M002-v4-real-catalog-lookup-api-design.md` 中设计。OWNER RATE 第一阶段暂不引入 Account 范围 Rate Code；SuperAgent 仍只输出稳定 `rate_code`，不输出显示名、价格或目录完整对象；是否存在于当前酒店目录由本系统后端目录服务最终校验。

 ## 21. 后端 V4 建模建议

@@ -748,12 +748,10 @@ AI 回调包
 - `POST /api/reservation/order-tasks/{orderTaskId}/cards/{cardId}/confirm` 确认 V4 卡片，强制 Bearer 登录、`RESERVATION_TASK_CONFIRM`、酒店访问权和 version 并发校验。
 - `POST /api/reservation/source-notifications/{notificationId}/ack` 确认 V4 S10/S99 来源通知已读 / 已处理，强制 Bearer 登录、`RESERVATION_TASK_CONFIRM`、酒店访问权和 version 并发校验。
 - CP7 已完成 `POST /api/reservation/order-tasks/{orderTaskId}/cards/{cardId}/review-resolution` 复核解阻和复核场景订单归属确认。
- CP8 已完成 Account / Room Type / Rate Code 目录校验和 V4 任务卡 `fields[]` 白名单；CP11 已把固定种子导入数据库目录并开放 Account / Room Type / Rate Code lookup API；CP13 已完成目录管理后台 CP1；CP14 已在 `GET /api/reservation/orders` 补齐 V4 下一步处理入口字段。Account + booking type 过滤 Rate Code 已确认为下一阶段待实现；真实 PMS 同步仍未实现。
+- CP8 已完成 Account / Room Type / Rate Code 目录校验和 V4 任务卡 `fields[]` 白名单；CP11 已把固定种子导入数据库目录并开放 Account / Room Type / Rate Code lookup API；CP13 已完成目录管理后台 CP1；CP14 已在 `GET /api/reservation/orders` 补齐 V4 下一步处理入口字段。OWNER RATE Room Type / Rate Code 目录口径已记录，Account + Rate Code 适用关系第一阶段暂不实现；真实 PMS 同步仍未实现。

 当前仍未完成：

- Account + booking type 过滤 Rate Code 的后端 lookup / 适用性校验和前端联动。
- Payment 卡付款凭证附件安全摘要、图片缩略图 / 大图预览、非图片文件列表 + 下载联动。
 - 尚未接入真实 PMS / OPERA / OHIP。
 - SuperAgent 目录机器接口和生产目录同步方案仍后置。

--- a/docs/project/requirements/M002-v4-order-task-card-domain-model-cp2.md
+++ b/docs/project/requirements/M002-v4-order-task-card-domain-model-cp2.md
@@ -16,7 +16,7 @@ M002 V4 CP1 已完成 SuperAgent V4 回调包入站解析、基础校验、路

 本文是 CP2 设计文档，用于把 2026-07-18 V4 字段契约落成后续可开发的数据模型和接口草案。

-截至 CP14、V4 业务审计查询、停止旧任务双写、Room Information 后端展示模型、Rooming List 确认自动 DEF 后端联动和 Payment 附件安全摘要后端第一版，后端已实现本文第 10、11、12 节中的持久化和查询基线，并已把 SuperAgent V4 入站结果写入新表：普通业务包只创建 V4 订单任务、来源邮件展示卡、Basic Information 卡和业务卡，不再创建旧 `workflow_reservation_task`；V4 S10/S99 创建来源通知。当前已开放 V4 工作台、订单任务列表 / 详情、来源通知详情查询接口、订单详情 V4 订单任务时间线、V4 卡片确认接口、S10/S99 来源通知 ack 接口、V4 `REVIEW_REQUIRED` 卡复核解阻接口、V4 订单任务 / 来源通知审计查询接口、当前酒店数据库目录校验、卡片 `fields[]` 白名单、Account / Room Type / Rate Code lookup API、目录管理后台 CP1、订单列表 V4 继续处理入口字段、Room Information New / Update / Cancel 第一版业务展示模型、Rooming List 确认触发 Group Booking Status 自动置 `DEF`，以及 Payment 卡 `payment_attachments[]` 安全摘要。下一阶段已确认 Rate Code 需要按订单级 Account + `booking_type`（GROUP / FIT）过滤和校验，当前后端 CP11 实现仍是酒店级 Rate Code 目录，是待补齐缺口；Payment 前端仍需基于安全摘要接入缩略图 / 文件列表交互，真实预览和下载 URL 必须走 SourceMessage 原文权限链路；真实 PMS 同步继续后置，设计见 `M002-v4-real-catalog-lookup-api-design.md`。
+截至 CP14、V4 业务审计查询、停止旧任务双写、Room Information 后端展示模型、Rooming List 确认自动 DEF 后端联动和 Payment 附件安全摘要后端第一版，后端已实现本文第 10、11、12 节中的持久化和查询基线，并已把 SuperAgent V4 入站结果写入新表：普通业务包只创建 V4 订单任务、来源邮件展示卡、Basic Information 卡和业务卡，不再创建旧 `workflow_reservation_task`；V4 S10/S99 创建来源通知。当前已开放 V4 工作台、订单任务列表 / 详情、来源通知详情查询接口、订单详情 V4 订单任务时间线、V4 卡片确认接口、S10/S99 来源通知 ack 接口、V4 `REVIEW_REQUIRED` 卡复核解阻接口、V4 订单任务 / 来源通知审计查询接口、当前酒店数据库目录校验、卡片 `fields[]` 白名单、Account / Room Type / Rate Code lookup API、目录管理后台 CP1、订单列表 V4 继续处理入口字段、Room Information New / Update / Cancel 第一版业务展示模型、Rooming List 确认触发 Group Booking Status 自动置 `DEF`，以及 Payment 卡 `payment_attachments[]` 安全摘要。2026-07-21 OWNER RATE `RATECODE (2)` 只读整理已确认：Room Type 第一阶段只维护 `RM2`、`RM3`、`RM4`、`SU1`、`SU2`、`SU3` 六个稳定 code，不建 Account -> Room Type 关系；Rate Code 第一阶段暂不建立 Account 适用关系，Q.B.D / LIAN TAI 的 40 个规范化 Rate Code 作为酒店级目录候选。真实 PMS 同步继续后置，设计见 `M002-v4-real-catalog-lookup-api-design.md`。

 后续如本文与 `M002-v4-agent-callback-field-contract.md` 的字段契约冲突，以字段契约为准；如与安全边界冲突，以 `security-access-control-boundary.md` 为准。

@@ -194,7 +194,7 @@ V4 新数据不再提供后端草稿保存。前端可以在页面本地维护
 - 用户只能从信息系统已有 Account 目录中选择。
 - 后端不得反向篡改 Agent 原始 `basic_information.manual_review`。

-CP11 起 Account / Market / Source 目录使用本系统数据库目录，不依赖 SuperAgent 动态提供目录文件。当前初始目录来自固定种子导入，`source_system=FIXED_SEED_IMPORT`；V24 会覆盖 `HOTEL-TEST`、`HOTEL-DEV` 和迁移执行时已有的 `ACTIVE` 酒店。后续 Account / Market / Source 优先由系统管理维护，Room Type / Rate Code 未来优先来自 PMS / OPERA / OHIP 同步，本地目录表和 lookup API 设计见 `M002-v4-real-catalog-lookup-api-design.md`。
+CP11 起 Account / Market / Source 目录使用本系统数据库目录，不依赖 SuperAgent 动态提供目录文件。当前初始目录来自固定种子导入，`source_system=FIXED_SEED_IMPORT`；V24 会覆盖 `HOTEL-TEST`、`HOTEL-DEV` 和迁移执行时已有的 `ACTIVE` 酒店。M002-V4-owner-rate-catalog-data-alignment 起，V25 和启动补种子已将 Room Type / Rate Code 固定种子收敛到 OWNER RATE 第一阶段目录。后续 Account / Market / Source 优先由系统管理维护，Room Type / Rate Code 未来优先来自 PMS / OPERA / OHIP 同步，本地目录表和 lookup API 设计见 `M002-v4-real-catalog-lookup-api-design.md`。

 CP11 数据库初始化种子：

@@ -203,10 +203,10 @@ CP11 数据库初始化种子：
 | Account | `QBD_TRAVEL`、`LIAN_TAI`、`HANATOUR_TD` |
 | Market | 由 Account 派生，当前固定为 `LEISURE` |
 | Source | 由 Account 派生，当前固定为 `TRAVEL_AGENT` |
-| Room Type | `TWN`、`KING`、`DBL`、`SGL`、`TRP`、`RM1`、`RM2`、`RM3` |
-| Rate Code | `BAR`、`RACK`、`PACKAGE`、`GROUP`、`FIT`；下一阶段候选需按 Account + `booking_type` 过滤 |
+| Room Type | `RM2`、`RM3`、`RM4`、`SU1`、`SU2`、`SU3` |
+| Rate Code | OWNER RATE `RATECODE (2)` 中 Q.B.D / LIAN TAI 的 40 个规范化酒店级候选，第一阶段暂不按 Account 过滤 |

-说明：Room Type / Rate Code 当前只作为确认和字段控件的第一版校验 / 选项来源代码；已开放 `GET /api/reservation/lookups/accounts|room-types|rate-codes`。Rate Code 下一阶段需引入 Account + `booking_type` 适用关系，前端不再展示全酒店 Rate Code 全量候选；房型 / 日期 / 价格过滤、真实 PMS 房型目录、Rate Code 配置中心和同步 run 后置。
+说明：Room Type / Rate Code 当前只作为确认和字段控件的第一版校验 / 选项来源代码；已开放 `GET /api/reservation/lookups/accounts|room-types|rate-codes`。Rate Code 第一阶段仍按酒店级目录 lookup；房型 / 日期 / 价格过滤、Account 适用关系、真实 PMS 房型目录、Rate Code 配置中心和同步 run 后置。

 ## 8. 订单归属和 target_order

@@ -759,7 +759,7 @@ POST /api/reservation/order-tasks/{orderTaskId}/cards/{cardId}/confirm
 - 前端只应提交当前卡 `fields[]` 中可编辑字段。后端确认时以当前卡展示快照为基准合并 `confirmed_payload`，未出现在展示快照 / 字段白名单中的字段会被忽略，不会写入 `confirmed_payload_json`。
 - Basic Information 确认时 `basic_information.account_code` 必须是当前酒店数据库 Account 目录值；后端确认前会派生 `account_name`、`market_code` 和 `source_code` 写入 `confirmed_payload_json`。
 - Room Information 确认时，前端优先提交 `confirmed_payload.room_information.final_values` 中当前 `fields[]` 可编辑字段；后端会生成稳定确认快照 `confirmed_payload_json.room_information.final_values`。该快照不包含 Agent 原始 `target_order`，也不包含邮件正文、附件 URL、raw evidence、Adult 或前端注入字段。
- 业务卡确认时，当前已递归校验已有 `rate_code`、`room_items[].room_type_code` 是否在当前酒店数据库目录中；下一阶段 `rate_code` 还必须属于当前订单 Basic Information 已确认 Account + 当前业务 event `booking_type` 的适用关系。Room Information 新结构的错误路径形如 `room_information.final_values.room_items.0.room_type_code`；旧兼容结构可能返回类似 `business_fields.after.room_items.0.room_type_code` 的路径，失败返回 `V4_FIELD_VALIDATION_FAILED`。
+- 业务卡确认时，当前已递归校验已有 `rate_code`、`room_items[].room_type_code` 是否在当前酒店数据库目录中；Rate Code 第一阶段暂不校验 Account 适用关系。Room Information 新结构的错误路径形如 `room_information.final_values.room_items.0.room_type_code`；旧兼容结构可能返回类似 `business_fields.after.room_items.0.room_type_code` 的路径，失败返回 `V4_FIELD_VALIDATION_FAILED`。
 - 不提交草稿。
 - 必须带 `version` 做并发校验。
 - 后端确认后卡片 `CONFIRMED` 并锁定。
@@ -874,9 +874,9 @@ AI 原始 payload、邮件正文、附件 URL 和技术 trace 不应直接进入
 | M002-V4-CP12 | 前端 Lookup 接入 | V4 卡片字段按 `options_source` 调用 lookup，替换固定种子硬编码选项，处理 stale / warning / 空目录 |
 | M002-V4-CP13 | 目录管理后台 V1 | Account / Market / Source 管理，临时 Room Type / Rate Code 管理，目录维护权限和管理审计 |
 | M002-V4-CP14 | 订单列表 V4 继续处理入口 | 已完成：`GET /api/reservation/orders` 返回 V4 下一步订单任务、卡片、动作类型、动作状态和 open 数，前端可优先跳 V4 订单任务详情 |
-| M002-V4-CP14.5 | Account 范围 Rate Code Lookup | 待实现：按 Account + `booking_type` 管理和查询 Rate Code 适用关系；业务卡确认 / 复核校验 Rate Code 适用性；前端在 Account 确认后加载对应 GROUP/FIT 候选 |
-| M002-V4-CP14.6 | Payment 附件预览 | 后端已完成：Payment 卡返回付款凭证附件安全摘要，不返回 URL；前端待接图片缩略图 + 大图预览、非图片文件列表 + 下载；预览 / 下载走 SourceMessage 原文权限链路 |
-| M002-V4-CP14.7 | Rooming List 事项确认卡 | 待实现前端轻量展示：Rooming List 卡第一版只展示事项和确认按钮，不解析名单、不预览附件、不生成 Excel、不导入 PMS |
+| M002-V4-CP14.5 | OWNER RATE 目录导入口径 | 已完成：V25 和启动补种子按人工确认结果维护 6 个 Room Type 和 Q.B.D / LIAN TAI 的 40 个酒店级 Rate Code 候选；暂不新增 Account + Rate Code 适用关系 |
+| M002-V4-CP14.6 | Payment 附件预览 | 已完成前后端第一版：Payment 卡返回付款凭证附件安全摘要，不返回 URL；前端通过 SourceMessage 原文权限链路做图片缩略图 / 大图预览和非图片下载 |
+| M002-V4-CP14.7 | Rooming List 事项确认卡 | 已完成前端轻量展示：Rooming List 卡第一版只展示事项和确认按钮，不解析名单、不预览附件、不生成 Excel、不导入 PMS |
 | M002-V4-CP14.8 | Room Information 展示模型 | 已完成前后端第一版：后端返回 `display_payload.room_information` 稳定展示模型；前端按 New / Update / Cancel 业务表单展示最终值、差异、Nights、Breakfast、Group Booking Status 和本地订单投影；Adult 不显示 |
 | M002-V4-CP14.9 | Rooming List 确认自动 DEF | 已完成后端第一版：确认 `ROOMING_LIST` 卡时，Group 同订单存在可更新 Room Information 确认快照则自动置 `DEF` 并写审计；Fit 不变更；无投影不造脏数据 |
 | M002-V4-CP14.10 | 复核态卡片字段白名单和统一确认交互 | 已完成前端第一版：`REVIEW_REQUIRED` 保持原业务卡内编辑，问题字段红字提示，前端按钮显示“确认卡片”但调用 `review-resolution`；后端 `fields[]` 返回当前卡业务字段白名单，复核写入不再只限空值或目录错误字段 |
--- a/docs/project/requirements/M002-v4-real-catalog-lookup-api-design.md
+++ b/docs/project/requirements/M002-v4-real-catalog-lookup-api-design.md
@@ -4,9 +4,9 @@

 | 项目 | 内容 |
 | --- | --- |
-| 文档版本 | 0.4 |
-| 日期 | 2026-07-20 |
-| 状态 | CP11 已落地第一版数据库目录与 lookup API；目录管理后台 CP1 已落地后端接口；Account + booking type 过滤 Rate Code 和 Room Information 早餐派生已确认为下一阶段待实现契约；真实 PMS 同步继续后置 |
+| 文档版本 | 0.5 |
+| 日期 | 2026-07-21 |
+| 状态 | CP11 已落地第一版数据库目录与 lookup API；目录管理后台 CP1 已落地后端接口；OWNER RATE `RATECODE (2)` 只读整理已确认 Room Type 第一版只维护 6 个稳定 code，Rate Code 第一阶段暂不建立 Account 适用关系；Room Information 早餐派生和真实 PMS 同步继续后置 |
 | 适用范围 | M002 V4 Account、Market、Source、Room Type、Rate Code 目录来源、Room Information 早餐派生、数据模型、前端 lookup、缓存、酒店隔离、权限和失败兜底 |
 | 不适用范围 | 真实 OPERA / OHIP 写操作、真实价格计算、房型 / 日期 / 价格级 Rate Code 适用规则、前端页面实现、SuperAgent Prompt 修改、目录同步任务、SuperAgent 机器目录接口 |

@@ -16,8 +16,8 @@ M002 V4 CP8 已实现第一版固定种子目录校验；M002 V4 CP11 已把该

 - Basic Information 的 `account_code` 必须存在于当前酒店数据库 Account 目录。
 - Market / Source 由 Account 派生，不由 SuperAgent 输出。
- Room Type 第一版使用当前酒店数据库目录校验和字段选项提示。
- Rate Code 当前 CP11 实现仍是酒店级目录校验和字段选项提示；下一阶段已确认需要按订单级 Account + `booking_type`（`GROUP` / `FIT`）过滤候选和校验适用性。
+- Room Type 第一版使用当前酒店数据库目录校验和字段选项提示；2026-07-21 经需求方确认，正式业务目录先收敛为 `RM2`、`RM3`、`RM4`、`SU1`、`SU2`、`SU3` 六个稳定 code，不按 Account 限定房型可用范围。
+- Rate Code 当前 CP11 实现仍是酒店级目录校验和字段选项提示；2026-07-21 经需求方确认，第一阶段暂不建立 Account 与 Rate Code 的适用关系，先把 OWNER RATE `RATECODE (2)` 中已确认 Account 的 Rate Code 作为酒店级 `RATE_CODE` 目录候选维护。
 - Room Information 卡中 Breakfast 第一版由后端派生：Group 固定含早；Fit 按 Rate Code 中 `RB` / `RO` 判断，无法派生时要求用户在卡片中必填确认。
 - 目录错误会让对应 V4 卡片进入 `REVIEW_REQUIRED`，用户通过复核解阻选择合法 code。

@@ -34,11 +34,53 @@ CP11 之前固定种子实现位于后端 `ReservationV4DirectoryService` 和 `F
 | Account | Basic Information 可选目录；SuperAgent 和用户提交都使用稳定 code | `QBD_TRAVEL`、`LIAN_TAI`、`HANATOUR_TD` | 已进入数据库初始化目录，仍不是 PMS 全量 Account；后台 CP1 可新增、启用 / 停用 |
 | Market | 由 Account 派生的订单级 Market | 当前 Account 均派生 `LEISURE` | 已进入通用代码目录，前端仍不直接编辑 |
 | Source | 由 Account 派生的订单级 Source | 当前 Account 均派生 `TRAVEL_AGENT` | 已进入通用代码目录，前端仍不直接编辑 |
-| Room Type | 房型 code 校验和字段选项提示 | `TWN`、`KING`、`DBL`、`SGL`、`TRP`、`RM1`、`RM2`、`RM3` | 已进入数据库初始化目录，仍不是 PMS 全量房型；后台 CP1 可新增、启用 / 停用 |
-| Rate Code | Rate Code 校验和字段选项提示 | `BAR`、`RACK`、`PACKAGE`、`GROUP`、`FIT` | 已进入数据库初始化目录；当前实现仍是酒店级目录，下一阶段改为 Account + booking type 适用范围过滤；不按房型、日期或价格过滤；后台 CP1 可新增、启用 / 停用 |
+| Room Type | 房型 code 校验和字段选项提示 | `RM2`、`RM3`、`RM4`、`SU1`、`SU2`、`SU3` | 已通过 `V25__align_owner_rate_catalog_data.sql` 和启动补种子收敛为 OWNER RATE 第一阶段目录，仍不是 PMS 全量房型；后台 CP1 可新增、启用 / 停用 |
+| Rate Code | Rate Code 校验和字段选项提示 | OWNER RATE `RATECODE (2)` 的 40 个规范化 Rate Code | 已通过 `V25__align_owner_rate_catalog_data.sql` 和启动补种子收敛为当前酒店级目录；第一阶段暂不建立 Account 适用关系，不按房型、日期或价格过滤；后台 CP1 可新增、启用 / 停用 |

 当前固定种子只能支撑开发和演示闭环，不能作为生产长期事实源。

+## 2.1 OWNER RATE `RATECODE (2)` 目录整理结论
+
+本节来自 2026-07-21 对 `/Users/andy/Downloads/OWNER RATE.xlsx` 中 `RATECODE (2)` sheet 的只读整理。M002-V4-owner-rate-catalog-data-alignment 已把本节 6 个 Room Type 和 40 个 Rate Code 写入固定初始化种子与 `V25__align_owner_rate_catalog_data.sql`；不处理 `RATECODE` sheet，不新增 Account 适用关系，不改变 lookup 接口参数契约。
+
+### 2.1.1 Room Type 第一阶段稳定集合
+
+需求方已确认当前系统第一阶段只维护以下 6 个 Room Type code：
+
+| code | 中文说明 |
+| --- | --- |
+| `RM2` | 高级花园景观大床房 |
+| `RM3` | 高级花园景观双床房 |
+| `RM4` | 高级花园景观家庭房 |
+| `SU1` | 花园景观小套房（大床） |
+| `SU2` | 泳池景观小套房（大床） |
+| `SU3` | 家庭套房 |
+
+结论：
+
+- 第一阶段不建立 `Account -> Room Type` 关系表。
+- 所有 Account 默认都可使用上述 6 个 Room Type。
+- `RM2/RM3`、`SU1/SU2` 这类 Excel 组合值在后续导入或人工维护时应拆成多个候选 code；前端和 SuperAgent 最终提交仍只能提交单个稳定 `room_type_code`。
+- 其它 Excel 文本，例如 `Deluxe TWN`、`GLSPCB-1800`，暂不进入第一阶段 Room Type 目录，除非后续人工确认映射到上述 6 个 code 或新增正式房型。
+
+### 2.1.2 Q.B.D 与 LIAN TAI Rate Code 参考清单
+
+Rate Code 取 `RATECODE (2)` sheet 的 E 列原值，仅做连字符两边空格清理，例如 `GRPA2 - 850UP` 规范化为 `GRPA2-850UP`；不拆分价格、餐食、早餐地点或其它说明，不强行派生 `booking_type`。
+
+第一阶段暂不建立 `Account -> Rate Code` 适用关系。下表只记录来源 Account 下出现过的 Rate Code，便于后续导入酒店级 `RATE_CODE` 目录、人工核对或未来再建适用关系。
+
+| source_account_name | 当前系统 Account code 参考 | Rate Code 清单 |
+| --- | --- | --- |
+| `Q.B.D` | 当前固定种子为 `QBD_TRAVEL`；是否改为更短 `QBD` 待确认 | `GRPA2-850UP`、`GRPA2-1275`、`GRPA2-1400`、`GRPA2-1800`、`GRPA2-2400`、`GRPA1-900`、`GRPA1-1400`、`GRPA1-1300`、`GRPA1-1150`、`GRPA1-1725`、`GRPA1-2300`、`GRPA3-1200*B'FAST BUALUANG`、`GRPA3-2000*B'FAST BUALUANG`、`GRPA3-1400*B'FAST BUALUANG`、`GRPA3-1800*B'FAST BUALUANG`、`GRPA3-2400*B'FAST BUALUANG`、`GRPA4-1200*B'FAST LEELA`、`GRPA4-2000*B'FAST LEELA`、`GRPA4-1400*B'FAST LEELA`、`GRPA4-1800*B'FAST LEELA`、`GRPA4-2400*B'FAST LEELA` |
+| `LIAN TAI` | `LIAN_TAI` | `WHO1-850UP`、`WHO1-1275`、`WHO1-1400`、`WHO1-1800`、`WHO1-2400`、`GRP1-900`、`GRP1-1400`、`GRP1-1300`、`GRP1-1800`、`GRP1-2400`、`WHO2-1100`、`WHO2-1600`、`WHO2-1400`、`WHO2-1800`、`WHO2-2400`、`WHO3-1200`、`WHO3-1800`、`WHO3-1400`、`WHO3-2400` |
+
+目录落地口径：
+
+- 当前固定初始化和 V25 已把上表 40 个去重值作为当前酒店 `workflow_reservation_catalog_code.catalog_type=RATE_CODE` 的候选目录维护，`code` 和 `display_name` 暂相同。
+- 这些值是 OWNER RATE 人工整理口径，不等同 PMS / OPERA / OHIP 的最终 Rate Plan code。
+- `B'FAST BUALUANG`、`B'FAST LEELA`、`850UP`、数字价格等内容第一阶段只作为 Rate Code 字符串的一部分保留，不单独进入价格、早餐或餐厅规则。
+- 后续如果需求方要求按 Account 限制 Rate Code，再新建适用关系表并从本节清单回填，不影响第一阶段酒店级目录校验。
+
 ## 3. 设计目标

 真实目录能力要解决以下问题：
@@ -49,7 +91,7 @@ CP11 之前固定种子实现位于后端 `ReservationV4DirectoryService` 和 `F
 4. 目录有来源、版本、更新时间和启停状态，便于排查 SuperAgent 输出 code 与系统目录不一致的问题。
 5. PMS / OPERA / OHIP 不稳定或暂未接入时，系统仍可使用最后一次成功目录快照或系统管理目录兜底。
 6. 固定种子目录可以作为 dev/test 或导入初始化兜底，但生产不应默认靠代码固定值。
-7. Rate Code 不再作为全酒店通用下拉；业务卡 Rate Code 候选必须先受当前订单 Basic Information 的 Account 和 event `booking_type` 限定。
+7. Rate Code 第一阶段仍作为当前酒店级目录下拉；暂不按 Account、Room Type、入住日期或价格过滤。后续若需求方明确 Account 适用范围，再新增关系表和联动过滤。

 ## 4. 目录来源分层

@@ -58,7 +100,7 @@ CP11 之前固定种子实现位于后端 `ReservationV4DirectoryService` 和 `F
 | 阶段 | 来源 | 中文说明 | 适用目录 |
 | --- | --- | --- | --- |
 | Phase 0 | `FIXED_SEED_IMPORT` | CP11 已将固定种子通过 Flyway 和启动补种子流程导入数据库，不再作为运行时代码全局 Map | 当前 Account、Market、Source、Room Type、Rate Code |
-| Phase 1 | `SYSTEM_MANAGED` / `IMPORT_FILE` | 本系统数据库目录，由初始化脚本、管理后台或受控导入文件维护；`IMPORT_FILE` 用于 OWNER RATE 等人工确认过的目录 / 适用关系导入 | Account、Market、Source；也可临时维护 Room Type、Rate Code 和 Account + booking type 的 Rate Code 适用关系 |
+| Phase 1 | `SYSTEM_MANAGED` / `IMPORT_FILE` | 本系统数据库目录，由初始化脚本、管理后台或受控导入文件维护；`IMPORT_FILE` 用于 OWNER RATE 等人工确认过的目录导入。当前结论是不先导入 Account 与 Rate Code 的适用关系 | Account、Market、Source；也可临时维护 Room Type、Rate Code |
 | Phase 2 | `PMS_SYNC` | 后端从 PMS / OPERA / OHIP 同步目录到本系统本地表，业务查询只读本地快照 | Room Type、Rate Code 优先；Account、Market、Source 视 PMS 能力再接 |

 原则：
@@ -75,7 +117,7 @@ CP11 之前固定种子实现位于后端 `ReservationV4DirectoryService` 和 `F
 | Market | 本系统管理目录 | 可选同步 PMS market code 配置 | 否，随 Account 派生展示 | 前端不直接改 Market；修改 Account 后后端派生 Market |
 | Source | 本系统管理目录 | 可选同步 PMS source code 配置 | 否，随 Account 派生展示 | 前端不直接改 Source；修改 Account 后后端派生 Source |
 | Room Type | PMS / OPERA / OHIP 同步目录优先 | 同步酒店有效房型、展示名、人数、启停状态 | 是，业务卡选择房型 | 若 PMS 未接入，可临时由系统管理维护或固定种子初始化 |
-| Rate Code | PMS / OPERA / OHIP 同步目录优先；在 PMS 未接前可由系统管理或导入文件维护 Account 适用关系 | 同步有效 Rate Plan / Rate Code；Account、booking type、房型、日期和价格适用规则逐步扩展 | 是，New Booking 选择 Rate Code | 下一阶段先按 Account + GROUP/FIT 过滤候选，只选 code，不做价格计算 |
+| Rate Code | PMS / OPERA / OHIP 同步目录优先；在 PMS 未接前可由系统管理或导入文件维护酒店级 Rate Code 目录 | 同步有效 Rate Plan / Rate Code；Account、booking type、房型、日期和价格适用规则后续按真实需求扩展 | 是，New Booking 选择 Rate Code | 第一阶段暂不按 Account 过滤，只选 code，不做价格计算 |

 Department 目录在 V4 字段契约中也会被 Trace 使用。当前任务详情页第一版先固定 `FO`、`HSK`、`FO+HSK` 三个 Department code，用于 Trace 卡下拉和 SuperAgent 输出约束；这不是正式数据库目录。后续可沿用本文模型扩展 `DEPARTMENT`、lookup API、系统管理维护和目录校验，不放入本 checkpoint。

@@ -138,11 +180,11 @@ Market、Source、Room Type、Rate Code 可先使用统一 code 表。
 uk_reservation_catalog_code(hotel_id, catalog_type, code)
 ```

-### 6.3 推荐表：`workflow_reservation_rate_code_applicability`
+### 6.3 后置备选表：`workflow_reservation_rate_code_applicability`

-Rate Code 本身仍保存在 `workflow_reservation_catalog_code` 中，`catalog_type=RATE_CODE` 表示该 code 是当前酒店已知的 Rate Code；是否对某个 Account、GROUP/FIT 可用，由适用关系表表达。这样可以避免在 `metadata_json` 中写不可查询的业务规则，也避免前端硬编码 OWNER RATE Excel。
+Rate Code 本身仍保存在 `workflow_reservation_catalog_code` 中，`catalog_type=RATE_CODE` 表示该 code 是当前酒店已知的 Rate Code。2026-07-21 最新结论是第一阶段暂不建立 Account 与 Rate Code 的适用关系；普通 lookup 继续返回当前酒店 `ACTIVE` Rate Code 目录。

-本 checkpoint 只确认 Account + booking type 粒度，不纳入房型、日期和价格规则。后续如果需要按 Room Type 或入住日期进一步过滤，应在此表或独立价格规则表上扩展，不改变前端只提交稳定 `rate_code` 的基本原则。
+如果后续需求方明确“某些 Account 只能使用部分 Rate Code”，再引入本备选表表达 Account + booking type 粒度的适用关系。后续如果还需要按 Room Type 或入住日期进一步过滤，应在此表或独立价格规则表上扩展，不改变前端只提交稳定 `rate_code` 的基本原则。

 | 字段 | 中文说明 |
 | --- | --- |
@@ -228,7 +270,6 @@ workflows.reservation.service
    - listAccounts(...)
    - listRoomTypes(...)
    - listRateCodes(...)
-    - listRateCodesByAccountAndBookingType(...)

 integrations.ohip / integrations.pms
  CatalogSyncAdapter
@@ -238,7 +279,7 @@ integrations.ohip / integrations.pms
 规则：

 - V4 入站、确认、复核只调用 `ReservationV4DirectoryService`。
- Basic Information 的 `account_code` 先确认或在同次复核中修正后，业务卡 Rate Code 才能按该 Account + `booking_type` 做适用性校验。
+- Rate Code 第一阶段只校验是否属于当前酒店 `ACTIVE` 的 `RATE_CODE` 目录；如未来引入 Account 适用关系，再基于 Basic Information 的 `account_code` 和业务 event 的 `booking_type` 扩展适用性校验。
 - 前端 lookup Controller 调用 `ReservationV4CatalogLookupService`，该服务同样只读本地目录表。
 - PMS / OHIP 同步 Adapter 只能写本地目录表或同步 run，不直接参与用户确认事务。
 - 如果目录服务不可用，确认接口 fail closed，不接受自由文本。
@@ -370,12 +411,10 @@ GET /api/reservation/lookups/rate-codes
 | 参数 | 必需 | 中文说明 |
 | --- | --- | --- |
 | `hotel_id` | 否 | 当前酒店 ID |
-| `account_code` | 是 | 已选择或已确认的 Reservation Account code；必须属于当前酒店 ACTIVE Account 目录 |
-| `booking_type` | 是 | `GROUP` / `FIT`；取自当前业务 event 的 `target_order.booking_type` |
 | `keyword` | 否 | 匹配 Rate Code 或显示名 |
 | `page_num` / `page_size` | 否 | 分页 |

-下一阶段 Rate Code lookup 必须按 `account_code + booking_type` 返回 `ACTIVE` 且适用的 Rate Code。`account_code` 未传、无效或不属于当前酒店时返回 400；`booking_type` 非 `GROUP` / `FIT` 时返回 400；Account 合法但当前无适用 Rate Code 时返回空 `items[]`。前端在 Account 未选时不应拉全酒店 Rate Code。`arrival_date` / `departure_date`、房型和价格过滤后置。
+当前 Rate Code lookup 保持酒店级目录查询，只返回当前酒店 `ACTIVE` Rate Code。2026-07-21 结论是第一阶段暂不接收 `account_code`、`booking_type` 作为必填过滤条件，也不按房型、入住日期、价格或 Account 限制候选；如未来引入 `workflow_reservation_rate_code_applicability`，再扩展查询参数和校验规则。

 响应草案：

@@ -383,17 +422,15 @@ GET /api/reservation/lookups/rate-codes
 {
  "hotel_id": "HOTEL-TEST",
  "catalog_type": "RATE_CODE",
-  "account_code": "QBD_TRAVEL",
-  "booking_type": "GROUP",
-  "catalog_source": "IMPORT_FILE",
-  "catalog_version": "owner-rate-20260720-v1",
+  "catalog_source": "FIXED_SEED_IMPORT",
+  "catalog_version": "owner-rate-20260721-v1",
  "stale": false,
  "items": [
    {
-      "code": "GRPA1",
-      "display_name": "GRPA1",
+      "code": "GRPA2-850UP",
+      "display_name": "GRPA2-850UP",
      "status": "ACTIVE",
-      "catalog_source": "IMPORT_FILE",
+      "catalog_source": "FIXED_SEED_IMPORT",
      "pricing_available": false
    }
  ],
@@ -409,8 +446,8 @@ GET /api/reservation/lookups/rate-codes
 前端用途：

 - `fields[].options_source=reservation_v4_rate_code_catalog` 时调用。
- 只能在当前订单 Basic Information 已有有效 Account，且当前业务 event 有 `booking_type` 时调用；Account 切换后必须清空或重新校验已选 Rate Code。
- 下一阶段只选 `rate_code`，不展示或计算真实价格。
+- 当前第一阶段可以按当前酒店目录查询 Rate Code，不要求已有 Account 或 `booking_type`。
+- 第一阶段只选 `rate_code`，不展示或计算真实价格。
 - V4 契约仍禁止 `UPDATE_BOOKING` 携带 Rate Code；lookup API 不改变该规则。

 ### 8.4 Market / Source Lookup
@@ -427,7 +464,7 @@ Market / Source 第一版不作为用户可编辑字段，不建议给普通业
 | --- | --- | --- |
 | `reservation_v4_account_catalog` | `GET /api/reservation/lookups/accounts` | 渲染 Account 下拉 / 搜索选择，展示派生 Market / Source |
 | `reservation_v4_room_type_catalog` | `GET /api/reservation/lookups/room-types` | 渲染房型搜索选择 |
-| `reservation_v4_rate_code_catalog` | `GET /api/reservation/lookups/rate-codes?account_code=...&booking_type=...` | 渲染当前 Account + GROUP/FIT 适用的 Rate Code 搜索选择 |
+| `reservation_v4_rate_code_catalog` | `GET /api/reservation/lookups/rate-codes` | 渲染当前酒店级 Rate Code 搜索选择 |
 | `static_enum` | 使用 `fields[].enum_options` | 不调用 lookup |
 | `system_case_lookup` | 后续订单 / 任务对象 lookup | 不属于本目录 checkpoint |

@@ -537,7 +574,7 @@ SuperAgent 当前不调用本 lookup API。SuperAgent 目录供给后续有两
 2. 遍历每张卡 `fields[]`。
 3. 只有字段 `editable=true` 且 `control_type=select/lookup` 时才加载 lookup。
 4. 根据 `options_source` 选择 lookup 接口。
-5. Rate Code 字段必须先取得当前订单 Basic Information 的 Account 和当前业务 event 的 `booking_type`；缺任一条件时禁用或显示空态，不调用全酒店 Rate Code 全量查询。
+5. Rate Code 字段第一阶段按当前酒店级目录查询；如未来引入 Account 适用关系，再要求先取得当前订单 Basic Information 的 Account 和当前业务 event 的 `booking_type`。
 6. 搜索输入做 debounce，不一次性拉全量。
 7. 显示 `stale=true` 或 `warnings[]` 时给用户非阻塞提醒。
 8. 用户提交确认或复核时只提交 code，不提交显示名、Market / Source 派生值或目录完整对象。
@@ -546,7 +583,7 @@ SuperAgent 当前不调用本 lookup API。SuperAgent 目录供给后续有两
 前端禁止：

 - 硬编码 PMS 房型或 Rate Code 全集。
- 硬编码 OWNER RATE Excel 中 Account 到 Rate Code 的映射；该映射必须由后端目录 / 适用关系接口提供。
+- 硬编码 OWNER RATE Excel 中 Account 到 Rate Code 的映射；当前仅允许后端目录维护酒店级 Rate Code，未来若引入适用关系也必须由后端接口提供。
 - 把目录显示名当业务 code 提交。
 - 绕过 `fields[]` 自行补业务字段。
 - 使用 lookup API 给 SuperAgent、AgentBus 或 Debug 链路拼接输入。
@@ -560,11 +597,11 @@ SuperAgent 当前不调用本 lookup API。SuperAgent 目录供给后续有两
 | M002-V4-CP12 | 前端 Lookup 接入 | V4 卡片字段渲染按 `options_source` 调用 lookup，替换固定种子硬编码选项，处理 stale / warning / 空目录 |
 | M002-V4-CP13 | 目录管理后台 V1 | CP1 已完成 Account / Room Type / Rate Code 前后端列表、新增、启用 / 停用闭环、`RESERVATION_CATALOG_MANAGE` 权限和管理审计；Market / Source 独立管理后置 |
 | M002-V4-CP14 | 订单列表 V4 继续处理入口 | 已完成：订单列表返回 V4 下一步订单任务、卡片、动作类型、动作状态和 open 数，前端可优先跳 V4 订单任务详情 |
-| M002-V4-CP14.5 | Account 范围 Rate Code Lookup | 待实现：新增 Account + booking type 适用关系模型 / 导入种子，Rate Code lookup 接收 `account_code`、`booking_type`，确认和复核校验 Rate Code 适用性，前端联动 Account 后展示候选 |
+| M002-V4-CP14.5 | OWNER RATE 目录导入口径 | 已完成：固定初始化种子和 V25 已把 Room Type 收敛为 `RM2`、`RM3`、`RM4`、`SU1`、`SU2`、`SU3`，并将 Q.B.D / LIAN TAI 的 40 个 Rate Code 候选作为酒店级 `RATE_CODE` 目录维护；暂不新增 Account + Rate Code 适用关系 |
 | M002-V4-CP15 | PMS / OPERA / OHIP 目录同步 | 同步 Adapter、同步 run 表、失败重试、最后成功快照、同步状态管理入口 |
 | M002-V4-CP16 | SuperAgent 目录供给 | 明确目录版本如何给 SuperAgent，必要时新增机器目录接口或导出包 |

-CP11 已作为后端第一步落地，因为它不依赖真实 PMS，也能让前端后续不再硬编码当前固定种子。CP13 CP1 继续沿用本地目录表，不接真实 PMS，也不改变 SuperAgent 输入契约。
+CP11 已作为后端第一步落地，因为它不依赖真实 PMS，也能让前端后续不再硬编码当前固定种子。CP13 CP1 继续沿用本地目录表，不接真实 PMS，也不改变 SuperAgent 输入契约。CP14.5 已完成 OWNER RATE 目录数据收口，但只替换系统固定种子；测试 / 开发库如果存在人工新增的旧 Room Type / Rate Code，需要按本文第 16 节的限定 SQL 清理或重建。

 ## 15. 仍需确认的问题

@@ -572,8 +609,48 @@ CP11 已作为后端第一步落地，因为它不依赖真实 PMS，也能让
 2. Account code 是否继续使用本系统定义的稳定 code，例如 `QBD_TRAVEL`，还是必须对齐 PMS profile code。
 3. Market / Source 是否只允许随 Account 派生，还是未来允许用户在 Basic Information 中单独改选。
 4. Room Type 第一版后端已支持系统管理维护；后续是否仍要接 PMS / OHIP 同步替换为主来源待确认。
-5. Rate Code 已确认下一阶段按 `account_code + booking_type` 过滤；入住日期、房型和价格是否也要进入过滤仍待后续确认。
+5. Rate Code 第一阶段已确认暂不按 `account_code + booking_type` 过滤；如未来出现 Account 专属候选、入住日期、房型或价格过滤诉求，再单独确认是否引入适用关系或价格规则表。
 6. 生产是否允许 `FIXED_SEED` 作为兜底，还是只允许 dev/test 使用。
 7. SuperAgent 是否需要读取目录；如果需要，是离线给目录包，还是新增 HMAC 机器接口。

 在这些问题未确认前，当前实现仍按 DB 管理目录 + 前端 lookup 查询 + 后台 CP1 手工维护闭环推进，不接真实 PMS，也不替换 SuperAgent 输入契约。
+
+## 16. 测试 / 开发库 OWNER RATE 目录清理步骤
+
+`V25__align_owner_rate_catalog_data.sql` 只替换 `source_system=FIXED_SEED_IMPORT` 的 Room Type / Rate Code 固定种子，不清理人工通过管理后台新增的目录项。测试机或开发库如果在 V25 前已经手工新增了旧目录值，且希望 lookup 严格只返回本阶段 6 个 Room Type 和 40 个 Rate Code，可以先备份后执行下面的限定更新。该步骤只停用当前酒店旧 Room Type / Rate Code，不清理 Account、Market、Source、用户、权限、SourceMessage、V4 order task 或 task card。
+
+```sql
+-- 执行前先确认目标酒店。
+SET @target_hotel_id = 'HOTEL-TEST';
+
+UPDATE workflow_reservation_catalog_code
+SET status = 'DISABLED',
+    updated_at = UTC_TIMESTAMP(6),
+    version = version + 1
+WHERE hotel_id = @target_hotel_id
+  AND catalog_type = 'ROOM_TYPE'
+  AND status = 'ACTIVE'
+  AND code NOT IN ('RM2', 'RM3', 'RM4', 'SU1', 'SU2', 'SU3');
+
+UPDATE workflow_reservation_catalog_code
+SET status = 'DISABLED',
+    updated_at = UTC_TIMESTAMP(6),
+    version = version + 1
+WHERE hotel_id = @target_hotel_id
+  AND catalog_type = 'RATE_CODE'
+  AND status = 'ACTIVE'
+  AND code NOT IN (
+      'GRPA2-850UP', 'GRPA2-1275', 'GRPA2-1400', 'GRPA2-1800', 'GRPA2-2400',
+      'GRPA1-900', 'GRPA1-1400', 'GRPA1-1300', 'GRPA1-1150', 'GRPA1-1725', 'GRPA1-2300',
+      'GRPA3-1200*B''FAST BUALUANG', 'GRPA3-2000*B''FAST BUALUANG',
+      'GRPA3-1400*B''FAST BUALUANG', 'GRPA3-1800*B''FAST BUALUANG',
+      'GRPA3-2400*B''FAST BUALUANG',
+      'GRPA4-1200*B''FAST LEELA', 'GRPA4-2000*B''FAST LEELA',
+      'GRPA4-1400*B''FAST LEELA', 'GRPA4-1800*B''FAST LEELA',
+      'GRPA4-2400*B''FAST LEELA',
+      'WHO1-850UP', 'WHO1-1275', 'WHO1-1400', 'WHO1-1800', 'WHO1-2400',
+      'GRP1-900', 'GRP1-1400', 'GRP1-1300', 'GRP1-1800', 'GRP1-2400',
+      'WHO2-1100', 'WHO2-1600', 'WHO2-1400', 'WHO2-1800', 'WHO2-2400',
+      'WHO3-1200', 'WHO3-1800', 'WHO3-1400', 'WHO3-2400'
+  );
+```
--- a/docs/project/requirements/M002-v4-test-machine-smoke-checklist.md
+++ b/docs/project/requirements/M002-v4-test-machine-smoke-checklist.md
@@ -91,7 +91,7 @@ GET /api/reservation/order-tasks/{orderTaskId}
 ```text
 GET /api/reservation/lookups/accounts?hotel_id=HOTEL-TEST&keyword=QBD
 GET /api/reservation/lookups/room-types?hotel_id=HOTEL-TEST&keyword=RM2
-GET /api/reservation/lookups/rate-codes?hotel_id=HOTEL-TEST&keyword=GROUP
+GET /api/reservation/lookups/rate-codes?hotel_id=HOTEL-TEST&keyword=GRPA2
 ```

 期望：