diff --git a/PROJECT_STATE.md b/PROJECT_STATE.md
index 7b9d6cf..ac11063 100644
--- a/PROJECT_STATE.md
+++ b/PROJECT_STATE.md
@@ -4,16 +4,16 @@
 | --- | --- |
 | 最近更新 | 2026-07-24 |
 | 当前分支 | `feature/huangting` |
-| 当前阶段 | M002 V4 入站、多卡模型、持久化基线、入站写入、查询接口、卡片确认、复核解阻、目录校验、订单详情 V4 总览、DB 目录、Lookup API、前端 lookup 接入、目录管理后台 CP1 前后端、订单列表 V4 继续处理入口 / open count 收口、V4 业务审计查询、停止旧任务双写、Debug EML V4 profile 对齐、Room Information 后端展示模型与前端业务化展示、V4 任务详情 smoke 修复、Rooming List 确认自动 DEF 后端联动、Rooming List 前端轻量事项卡、Room Information 复核 pointer 与任务详情安全边界修复、Room Information 复核 pointer 运行时规则收口、复核 pointer 部署证明与运行时 trace、OWNER RATE Room Type / Rate Code 目录口径、Payment 附件预览后端安全摘要与前端预览接入、Trace 卡后端字段契约收口、Trace 确认态字段刷新、Rooming List 事项确认卡文档口径、V4 复核态卡片交互和字段白名单文档口径、V4 工作台 / 订单详情 / 任务详情普通酒店员工用户化展示与 polish 收口、订单事项办理页克制业务办理台视觉 polish、SuperAgent MCP 入站诊断链路第一版，以及 AI-NSES v0.2 / TH Hotel 项目级 Overlay 文档治理规则 |
+| 当前阶段 | M002 V4 入站、多卡模型、持久化基线、入站写入、查询接口、卡片确认、复核解阻、目录校验、订单详情 V4 总览、DB 目录、Lookup API、前端 lookup 接入、目录管理后台 CP1 前后端、订单列表 V4 继续处理入口 / open count 收口、V4 业务审计查询、停止旧任务双写、Debug EML V4 profile 对齐、Room Information 后端展示模型与前端业务化展示、V4 任务详情 smoke 修复、Rooming List 确认自动 DEF 后端联动、Rooming List 前端轻量事项卡、Room Information 复核 pointer 与任务详情安全边界修复、Room Information 复核 pointer 运行时规则收口、复核 pointer 部署证明与运行时 trace、OWNER RATE Room Type / Rate Code 目录口径、Payment 附件预览后端安全摘要与前端预览接入、Trace 卡后端字段契约收口、Trace 确认态字段刷新、Rooming List 事项确认卡文档口径、V4 复核态卡片交互和字段白名单文档口径、V4 工作台 / 订单详情 / 任务详情普通酒店员工用户化展示与 polish 收口、订单事项办理页克制业务办理台视觉 polish、SuperAgent MCP 入站诊断链路第一版、AI-NSES v0.2 / TH Hotel 项目级 Overlay 文档治理规则，以及 M002 V4 增量需求模板化 Spec 对齐 |
 | 当前重点 | M002 V4 已停止普通业务入站双写旧 `workflow_reservation_task`，V4 后新业务主线只写 V4 order task / cards / source notification；Debug EML V4 smoke 默认复用实时 AgentBus V4 Open API subject，避免误走历史 Debug V2/V3 profile。开发阶段不维护 V2/V3 旧任务兼容，测试数据可重建，生产迁移策略后续上线前单独设计。`GET /api/reservation/orders` 可返回 V4 下一步订单任务、卡片、动作类型、动作状态、V4 open 数和统一展示字段 `open_work_item_count`；旧 `open_task_count` / `next_processable_task_id` 仅作历史诊断兼容。Room Information 已完成后端稳定展示模型和前端业务化展示：`GET /api/reservation/order-tasks/{orderTaskId}` 在 `display_payload.room_information` 返回 New / Update / Cancel 的 `current_values`、`proposed_values`、`final_values`、`change_summary[]`，前端只消费该展示模型和 `fields[]`，不再从 Agent raw payload、`business_fields` 或 `target_order` 自行推导；如果卡片 payload 已经是稳定 `room_information.final_values` 结构，后端会按稳定模型归一化查询和复核；Nights、Breakfast 和 Group Booking Status 均以后端派生值为准；确认和复核写入稳定 `confirmed_payload_json.room_information.final_values`，不回写 Agent 原始 `target_order`、Adult、邮件正文或附件 URL；接口对前端暴露的 `fields[].write_target` 使用 `confirmed_payload` / `review_resolution.field_overrides` 这类安全语义，不暴露内部列名；查询侧 `fields[].editable` 和命令侧 `review-resolution` 复核 pointer 校验已共用同一套 Room Information 字段策略。Trace 卡后端契约已收口：普通事项内容字段统一为 `trace_items[].text`，不使用 `content`；`department_code` 第一版只允许 `FO`、`HSK`、`FO+HSK`，任务详情字段会返回 `options_source=reservation_v4_trace_department_fixed` 和 `fixed_options[]` 三个固定选项；`EXTRA_BED.target_room_type_code` 只校验当前酒店 Room Type 目录存在，暂不校验当前订单已有房型；确认和复核共用同一套 Trace 字段白名单，`display_payload` / `confirmed_payload` 不返回 `target_order`、邮件正文、附件 URL、raw evidence 或 AI 原始 payload。复核 pointer 拒绝前会记录 `review_pointer_policy=m002_v4_review_pointer_runtime_fix_v1`，包含 order task、card、incoming pointer、query-side editable pointers、command-side allowed pointers、validation error pointers 和 reject reason，但不记录 payload、邮件正文或附件 URL。V4 任务详情 smoke 修复已完成：页面顺序固定为 Basic Information、业务卡、SourceMessage Display；来源邮件卡位于页面底部，只通过 SourceMessage conversation 接口定位当前触发邮件并默认折叠正文；Basic Information 和普通业务卡的展示 / 确认 payload 不再返回 Agent `target_order`，普通业务卡还会移除邮件 HTML、raw evidence、附件原始 URL 和 PMS 原始响应等敏感字段；Basic Information 的 Market Code / Source Code 前端已改为可编辑字段，普通业务页不再展示字段下方 control hint、lookup 空目录提示或“只读”胶囊。Rooming List 卡确认时已实现 Group 自动置 `DEF`：如同订单存在可更新的已确认 Room Information 快照，后端会覆盖其 `group_booking_status=DEF` 并写 `V4_ROOMING_LIST_AUTO_DEF` 审计；刷新任务详情时 `display_payload` 和 `confirmed_payload` 均以 DEF 后的确认快照为准；当前订单详情 `order_overview` 不返回 Group Booking Status 字段；如没有可更新投影，Rooming List 确认仍成功，只写安全审计提示，不临时创建不完整 Room Information。V4 任务详情已支持 ROOMING_LIST 轻量事项卡：页面只显示 “Rooming List / 房表事项”、目标订单线索、人工处理说明和确认按钮，不展示 rows、名单明细、附件预览、导入 / 生成入口、AI payload、邮件正文或附件 URL；PENDING_CONFIRM 确认只提交 `version`，成功后完全使用后端刷新详情，不由前端自行设置 `group_booking_status=DEF`。OWNER RATE `RATECODE (2)` 已确认第一阶段 Room Type 稳定集合为 `RM2`、`RM3`、`RM4`、`SU1`、`SU2`、`SU3`，不建立 Account -> Room Type 关系；Rate Code 第一阶段暂不建立 Account 适用关系，Q.B.D 与 LIAN TAI 的 40 个规范化 Rate Code 仅作为当前酒店级 `RATE_CODE` 目录候选维护。Payment 卡已在 `display_payload.payment_attachments[]` 返回付款凭证附件安全摘要，字段只包含附件 ID、文件名、类型、大小、是否图片、是否理论可预览 / 下载和可选 `external_media_id`，前端在 V4 任务详情 Payment 卡中按当前触发 SourceMessage 的 conversation 附件匹配缩略图、大图预览和非图片下载，匹配优先 `external_media_id` / `externalMediaId`，其次 `attachment_id`，不按文件名猜测；`attachment_ids[]` 第一版仍只读，前端不增删或替换附件集合，Payment 确认只提交 `version`，不提交附件 ID、附件 URL 或完整附件对象；真实 URL 仍只来自 SourceMessage 原文权限链路，权限不足或 conversation 失败时降级展示不可预览 / 不可下载。已确认 `REVIEW_REQUIRED` 仍是原业务卡复核态，页面按钮统一叫“确认卡片”，复核态允许编辑当前卡 `fields[]` 白名单内业务字段，问题字段红字提示。后续可继续做测试机 V4 smoke 复测、OWNER RATE 目录导入、真实 PMS / OPERA / OHIP 同步或 SuperAgent 目录供给方案。 |
 
 ## 1. 当前 Checkpoint
 
-- 名称：`TH-Hotel-AI-NSES-overlay-v1`
-- 状态：Done，已把通用 AI-NSES 升级为 v0.2，并新增 TH Hotel 项目级 Overlay。后续 V4 重要需求不再只散落追加到 M002 大文档，必须先形成或更新模板化 Spec / Change Request，再安排后端、前端或测试 agent 开工。
-- 目标：通用标准补 Definition of Ready、Definition of Done、Change Request、Traceability Matrix 和 Agent Handoff；项目级 Overlay 补 V4 需求门禁、核心概念守门、前后端 / 测试追踪表、后端 / 前端 / 测试 agent 交接规则和文档同步清单。
-- 边界：本 checkpoint 只改文档流程和入口索引，不改业务代码、不改变 M002 V4 已实现接口、不改变 SuperAgent 入站 JSON、不改变权限、酒店隔离、审计或安全脱敏业务规则。
-- 联调备注：后续如继续新增 Payment、Trace、Rooming List、Room Information、订单详情或任务列表体验需求，应先在 `docs/project/requirements/` 形成模板化 Spec / Change Request；现有 M002 V4 大文档继续作为字段、接口、安全和实现契约。
+- 名称：`M002-V4-requirement-spec-template-alignment`
+- 状态：Done，已新增 `docs/project/requirements/M002-v4-requirement-spec-template-alignment.md`，把近期 V4 增量需求整理为模板化 Spec 入口和需求追踪表。
+- 目标：汇总 Room Information 多房型 / 展示模型 / 派生字段、Payment 附件预览、Rooming List 轻量事项卡、Trace 专属卡、REVIEW_REQUIRED 原卡复核、SourceMessage Display 底部折叠、普通酒店员工用户化展示和单卡可操作态测试数据需求。
+- 边界：本 checkpoint 只改文档，不改业务代码、不改变 M002 V4 已实现接口、不改变 SuperAgent 入站 JSON、不改变权限、酒店隔离、审计或安全脱敏业务规则。
+- 联调备注：单卡可操作态测试数据仍待测试 agent 返回结果；返回后应回填本文追踪表或追加测试记录。
 
 ## 2. 当前优先级
 
@@ -35,7 +35,7 @@
 - 现有历史文档暂不按 AI-NSES 目录大搬迁，先通过索引和采用说明建立映射关系。
 - `docs/import/` 下按日期导入的资料是输入材料，不等同于当前权威开发契约；当前开发应优先看 `docs/project/README.md` 标记为当前有效或权威契约的文档。
 - 后续每完成一个 Feature 或 Checkpoint，需要更新本文件，避免项目状态继续沉淀在聊天记录里。
-- AI-NSES v0.2 和 TH Hotel 项目级 Overlay 已落地；但近期 M002 V4 新增需求仍需要后续专项整理成模板化 Spec / Change Request，避免继续只散落在当前有效大文档中。
+- AI-NSES v0.2 和 TH Hotel 项目级 Overlay 已落地；近期 M002 V4 新增需求已新增模板化 Spec 入口。后续新增或变更 V4 需求时必须继续维护该 Spec、后续 Change Request 或新 Spec，避免只散落在当前有效大文档中。
 - M010 Rooming List Excel 生成后端 CP1 和前端 V1 已实现：前端 `/reservation/rooming-lists/new` 上传来源名单并下载后端同步生成的 `.xlsx`，第一版不落库、不上传 OSS。CP2 已实现：来源 Excel `旅游日期` 派生 Arrival / Departure，Adults 由系统按分房结果计算，目标默认值区域只保留 Payment Type / Nationality，Payment Type 默认 `BTQR` 且当前允许 `BTQR` / `CA`，Nationality 只允许 `KR` / `CHN`。
 - M011 Booking Excel 附件预处理 CP1/CP2/CP3 已实现：后端可排除人员名单类 Excel，按最近 6 个月候选窗口选择实际存在的最新 3 个业务月，抽取 Booking Update / 附加费表高亮行业务 JSON；Debug EML 和 AgentBus dispatch 在各自 include 开关与总开关同时启用时，会在调用 SuperAgent 前追加 `attachment_extractions[]`。测试机 AgentBus 增强已开启；生产链路仍默认关闭，生产开启需单独确认。
 - M002 V4 CP1 当前已完成入站解析和现有任务链路过渡适配；M002 V4 CP2 已完成订单任务与多卡领域模型设计；M002 V4 CP3 已完成 V4 订单任务、多卡和 S10/S99 来源通知表结构与 Repository 基线；M002 V4 CP4 已完成入站写入新模型；M002 V4 CP5 已完成前端查询接口并补齐订单详情 `v4_order_tasks[]` 时间线；M002 V4 CP6 已完成普通卡片确认和 S10/S99 来源通知 ack；M002 V4 CP7 已完成 `REVIEW_REQUIRED` 卡复核解阻和复核场景订单归属确认；M002 V4 CP8 已完成目录校验、V4 卡片 `fields[]` 字段白名单、确认写入白名单收口和嵌套业务字段目录校验；M002 V4 CP11 已完成数据库目录、初始化种子、启动补种子、Account / Room Type / Rate Code lookup API，并把 V4 入站、确认、复核目录校验切换到当前酒店数据库目录；M002 V4 CP12 已完成前端 lookup 接入第一版和 V4 订单任务时间线消费；M002 V4 CP13 目录管理后台 CP1 已完成前后端列表、新增、启用 / 停用闭环；M002 V4 CP14 已完成订单列表 V4 继续处理入口字段和前端入口消费，`GET /api/reservation/orders` 返回 V4 下一步订单任务、卡片、动作类型、动作状态、V4 open 数和统一展示计数 `open_work_item_count`，前端按 V4 优先跳转，并按 `open_work_item_count` 展示待处理数量；V4 业务审计查询已补齐订单任务审计和来源通知 ack 审计两个只读接口；订单详情已补齐并完成前端接入 V4 `order_overview`、`next_v4_action`、`related_source_messages[]` 和 `v4_order_tasks[].cards[]`；V4 普通业务入站已停止双写旧 `workflow_reservation_task`；MCP `th_hotel_submit_task_results` 已收口为 M002 V4-only，旧 V2/V3 submit payload 返回 `MCP_SUBMIT_V4_REQUIRED`，不再影响 SuperAgent 输出契约；Room Information 后端展示模型和前端业务化展示第一版已完成；Rooming List 确认触发 Group Booking Status 自动置 `DEF` 已完成，前端轻量事项确认卡也已完成；Payment 附件安全摘要后端和前端预览接入均已完成。OWNER RATE Room Type / Rate Code 目录口径已落文档；真实 PMS 同步和 SuperAgent 目录机器接口仍未完成。
@@ -46,7 +46,7 @@
 - 后续如继续做 M002 V4，可优先进行测试机联调，或推进真实 PMS / OPERA / OHIP 目录同步、`workflow_reservation_catalog_sync_run` checkpoint 和 SuperAgent 目录供给方案。
 - SuperAgent 通过 MCP 提交时，排障优先查询 `platform_superagent_mcp_call_diagnostic`，对比 `arguments_json`、`adapted_payload_json`、`mapping_diagnostics_json` 和业务 batch / transition，判断问题来自 SuperAgent 原始参数、MCP adapter 还是业务入站层；V4-only 模式下 `mapping_diagnostics_json` 通常为空对象，若错误码为 `MCP_SUBMIT_V4_REQUIRED`，说明 SuperAgent 仍按旧 V2/V3 schema 输出；旧 V2/V3 被拒也会入本诊断表但不会进入业务写入 Service；V4 `source_message.conversation_id` 可缺省；该诊断表不作为业务事实来源，不进入普通前端接口。
 - 后续新增重要功能时，优先在 `docs/project/requirements/` 或未来 `docs/specs/` 中形成 Spec，再实现代码；V4 相关需求必须按 `docs/project/ai-nses-project-overlay.md` 补核心概念守门、需求追踪表和 agent 交接边界。
-- 建议下一轮文档 checkpoint：`M002-V4-requirement-spec-template-alignment`，把近期 Payment、Trace、Rooming List、Room Information、多房型、用户化展示和单卡可操作态测试数据整理为模板化 V4 增量需求 Spec / Change Request。
+- 单卡可操作态测试数据结果返回后，回填 `M002-v4-requirement-spec-template-alignment.md` 的追踪表或追加测试记录。
 - M010 CP2 字段收口已完成；预览、历史记录、OSS 下载、订单 / 任务预填或客户字段目录化仍后置，需单独开前后端 checkpoint。
 - M011 CP4 暂不推进；当前停留在 CP3 边界，只增强 SuperAgent 输入，不直接落订单、任务或长期解析历史。后续如确实需要运营查询或长期追踪，再单独设计 Excel 解析批次 / 行级持久化表。
 
diff --git a/docs/project/README.md b/docs/project/README.md
index 1e672a3..04ff0a3 100644
--- a/docs/project/README.md
+++ b/docs/project/README.md
@@ -48,6 +48,7 @@
 | `requirements/M002-task-field-control-contract-v1.md` | 当前有效 | M002 任务卡字段控件契约 V1，记录任务详情 `fields[]` 控件元数据、人工复核控件复用和前后端开发边界。 |
 | `requirements/M002-v4-agent-callback-field-contract.md` | 当前有效 | M002 V4 Agent 回调字段契约，基于 2026-07-18 业务基线和最新答复，冻结 `source_message`、`order_contexts`、`message_events`、订单级 Basic Information、六类 Event、S10/S99 和校验口径；后端已完成 V4 入站解析、持久化、查询、确认、复核和当前酒店数据库目录校验。 |
 | `requirements/M002-v4-order-task-card-domain-model-cp2.md` | 当前有效 | M002 V4 CP2 订单任务与多卡领域模型设计，并记录 CP3-CP8 表结构、入站写入、查询、确认、复核和目录校验已落地状态；CP11 已完成 DB 目录与 lookup API，CP12 已完成前端 lookup 接入，CP13 已完成目录管理后台 CP1，CP14 已完成订单列表 V4 继续处理入口，CP15 已完成 V4 业务审计查询，CP15.1 已完成订单详情 V4 总览后端补齐，当前已停止 V4 普通业务双写旧 `workflow_reservation_task`，并已完成 Room Information 后端展示模型和前端业务化展示第一版，以及 Rooming List 确认自动 DEF 后端联动；已补 OWNER RATE Room Type / Rate Code 目录口径、Payment 附件预览、Rooming List 事项确认卡、V4 复核态卡片交互、可编辑字段白名单和 V4 工作台 / 订单详情 / 任务详情普通酒店员工用户化展示契约；开发阶段不维护 V2/V3 旧任务兼容，测试数据可重建，生产迁移策略后置。 |
+| `requirements/M002-v4-requirement-spec-template-alignment.md` | 当前有效 | M002 V4 近期增量需求的模板化 Spec 入口，汇总 Room Information 多房型、Payment、Rooming List、Trace、REVIEW_REQUIRED、SourceMessage Display、普通员工用户化展示和单卡可操作态测试数据的需求追踪表；不替代字段契约、接口契约或安全边界。 |
 | `requirements/M002-v4-real-catalog-lookup-api-design.md` | 当前有效 | M002 V4 真实目录与 Lookup API 设计及 CP11 / CP13 CP1 实现记录，记录 Account、Market、Source、Room Type、Rate Code 从固定种子导入数据库、前端 lookup API、目录管理后端接口、权限、缓存后置、PMS / OPERA / OHIP 同步后置和失败兜底；已记录 OWNER RATE `RATECODE (2)` 只读整理结论：Room Type 第一阶段收敛为 `RM2`、`RM3`、`RM4`、`SU1`、`SU2`、`SU3`，Rate Code 第一阶段暂不建立 Account 适用关系，Q.B.D / LIAN TAI 清单作为酒店级目录候选。 |
 | `requirements/M002-v4-test-machine-smoke-checklist.md` | 当前有效 | M002 V4 测试机冒烟清单，覆盖登录、酒店权限、V4 工作台、订单任务详情、lookup、确认、复核解阻、S10/S99 ack、订单详情 V4 时间线和目录管理 CP1 排查点。 |
 | `requirements/M002-superagent-task-result-api-contract.md` | 阶段记录 | M002 SuperAgent 任务结果入站接口契约阶段记录；对外总契约以 `integrations/superagent-api-contract.md` 为准。 |
@@ -102,6 +103,6 @@
 - 接口暴露、权限、酒店隔离和审计边界以 `security-access-control-boundary.md` 为总检查清单；具体 SuperAgent / MCP / AgentBus 请求响应契约仍以 `integrations/` 下对应文档为准。
 - AI-NSES 的通用标准以 `../import/reusable/ai-native-software-engineering-standard.md` 为复用来源；本项目采用方式以 `ai-native-adoption.md` 为准；V4 需求门禁、核心概念守门、需求追踪和 agent 交接规则以 `ai-nses-project-overlay.md` 为本项目补充。
 - M002 V1 只作为历史参考；V2 记录当前阶段实现；后续 M002 新开发以 `requirements/M002-order-task-workflow-v3.md` 为开发基线。
-- 2026-07-18 导入的业务基线已形成 `requirements/M002-v4-agent-callback-field-contract.md` 字段契约；M002 V4 入站解析 CP1 已落地，V4 订单任务 + 多卡领域模型设计和关键业务决策见 `requirements/M002-v4-order-task-card-domain-model-cp2.md`；M002 V4 CP3 已落地 V4 订单任务、任务卡、来源通知表结构和 Repository 基线，CP4 已落地普通 V4 业务包和 S10/S99 来源通知入站写入新模型，CP5 已落地工作台、订单任务和来源通知查询接口，CP6/CP7 已落地卡片确认、S10/S99 ack 和复核解阻，CP11 已落地 DB 目录与 lookup API，CP12 已落地前端 lookup 接入，CP13 已落地目录管理后台 CP1，CP14 已落地订单列表 V4 继续处理入口，CP15 已落地 V4 业务审计查询，CP15.1 已落地订单详情 V4 总览后端补齐且前端已接入，Room Information 后端展示模型第一版、前端业务化展示和 Rooming List 确认自动 DEF 后端联动已落地；已确认 Rooming List 卡第一版只做事项确认，`REVIEW_REQUIRED` 保持原业务卡内编辑并统一显示“确认卡片”；OWNER RATE Room Type / Rate Code 目录导入口径已落地；V4 工作台 / 订单详情 / 任务详情页默认面向普通酒店员工，技术信息只允许放在高级筛选、折叠区或受控调试模式；真实 PMS / OPERA / OHIP 同步仍后置。
+- 2026-07-18 导入的业务基线已形成 `requirements/M002-v4-agent-callback-field-contract.md` 字段契约；M002 V4 入站解析 CP1 已落地，V4 订单任务 + 多卡领域模型设计和关键业务决策见 `requirements/M002-v4-order-task-card-domain-model-cp2.md`；近期 V4 增量需求的模板化入口和追踪表见 `requirements/M002-v4-requirement-spec-template-alignment.md`；M002 V4 CP3 已落地 V4 订单任务、任务卡、来源通知表结构和 Repository 基线，CP4 已落地普通 V4 业务包和 S10/S99 来源通知入站写入新模型，CP5 已落地工作台、订单任务和来源通知查询接口，CP6/CP7 已落地卡片确认、S10/S99 ack 和复核解阻，CP11 已落地 DB 目录与 lookup API，CP12 已落地前端 lookup 接入，CP13 已落地目录管理后台 CP1，CP14 已落地订单列表 V4 继续处理入口，CP15 已落地 V4 业务审计查询，CP15.1 已落地订单详情 V4 总览后端补齐且前端已接入，Room Information 后端展示模型第一版、前端业务化展示和 Rooming List 确认自动 DEF 后端联动已落地；已确认 Rooming List 卡第一版只做事项确认，`REVIEW_REQUIRED` 保持原业务卡内编辑并统一显示“确认卡片”；OWNER RATE Room Type / Rate Code 目录导入口径已落地；V4 工作台 / 订单详情 / 任务详情页默认面向普通酒店员工，技术信息只允许放在高级筛选、折叠区或受控调试模式；真实 PMS / OPERA / OHIP 同步仍后置。
 - V3 / 旧任务前端展示和编辑字段仍以 2026-07-11 P0 冻结基线中的前端字段表、0712 字段控件说明和 `requirements/M002-task-field-control-contract-v1.md` 为白名单和控件契约基线；V4 订单任务前端展示和编辑字段以 `requirements/M002-v4-order-task-card-domain-model-cp2.md`、后端返回的 `fields[]` 和 V4 前后端协作文档为准。
 - 时间点语义以 `backend-time-design.md` 为准；数据库时间点按 UTC 理解，API 返回带 `Z` 的 UTC 时间，页面再按酒店或用户时区展示。
diff --git a/docs/project/ai-nses-project-overlay.md b/docs/project/ai-nses-project-overlay.md
index c1897aa..51b3ee1 100644
--- a/docs/project/ai-nses-project-overlay.md
+++ b/docs/project/ai-nses-project-overlay.md
@@ -150,7 +150,7 @@ V4 新需求落地后，至少检查以下文档：
 
 M002 V4 已有大量规则落在当前有效大文档中。短期不做大搬迁，避免打断开发和测试。
 
-后续建议开 `M002-V4-requirement-spec-template-alignment` 文档 checkpoint，把近期新增需求整理成模板化 Spec / Change Request，包括：
+已开 `M002-V4-requirement-spec-template-alignment` 文档 checkpoint，并新增 `docs/project/requirements/M002-v4-requirement-spec-template-alignment.md`，把近期新增需求整理成模板化 Spec 入口和需求追踪表，包括：
 
 - Room Information 多房型、展示模型、Nights / Breakfast / Group Booking Status 和复核白名单。
 - Payment 附件安全摘要和前端预览。
@@ -159,4 +159,4 @@ M002 V4 已有大量规则落在当前有效大文档中。短期不做大搬迁
 - V4 工作台、订单详情和订单事项办理页普通酒店员工用户化展示。
 - 单卡可操作态测试数据和 smoke 追踪表。
 
-整理后的 Spec 作为需求入口；现有 M002 V4 大文档继续保留为字段、接口、安全和实现契约。
+该 Spec 作为近期 V4 增量需求入口；现有 M002 V4 大文档继续保留为字段、接口、安全和实现契约。
diff --git a/docs/project/requirements/M002-v4-requirement-spec-template-alignment.md b/docs/project/requirements/M002-v4-requirement-spec-template-alignment.md
new file mode 100644
index 0000000..eaba809
--- /dev/null
+++ b/docs/project/requirements/M002-v4-requirement-spec-template-alignment.md
@@ -0,0 +1,223 @@
+# M002 V4 增量需求模板化 Spec
+
+| 项 | 内容 |
+| --- | --- |
+| 状态 | Implemented |
+| 日期 | 2026-07-24 |
+| 负责人 | TH Hotel 项目总揽 agent |
+| 需求来源 | 2026-07-21 至 2026-07-24 V4 联调、测试机 smoke、用户新增需求确认 |
+| 关联 Change Request | 无；本文作为近期 V4 增量需求入口和追踪表 |
+
+## 1. 背景
+
+M002 V4 近期连续新增了 Room Information 展示模型、Payment 附件预览、Rooming List 轻量事项卡、Trace 专属卡、普通酒店员工用户化展示、多房型展示和单卡可操作态测试数据等需求。
+
+这些内容已经同步到字段契约、领域模型、前后端协作文档、安全边界和项目状态中，但结构上仍是补丁式写入大文档，不利于新 agent 快速判断需求、实现、测试和文档是否一致。
+
+本文按 AI-NSES Spec 模板整理近期 V4 增量需求，作为需求入口。现有 M002 V4 大文档继续作为字段、接口、安全和实现契约。
+
+## 2. 目标
+
+- 建立近期 V4 增量需求的模板化入口。
+- 明确每个需求项的后端、前端、测试和文档状态。
+- 固定 Order、Order Task、Task Card、SourceMessage、S10/S99 来源通知和 SuperAgent 入站边界，避免后续 agent 混用概念。
+- 明确普通酒店员工页面默认不展示技术信息，技术信息只能进入高级筛选、折叠区或受控调试模式。
+- 为后续后端、前端和测试 agent 提示词提供共同基线。
+
+## 3. 非目标
+
+- 不改业务代码。
+- 不改变 SuperAgent V4 JSON 入站字段。
+- 不改变当前 V4 查询、确认、复核、ack 接口路径或权限。
+- 不推进真实 PMS / OPERA / OHIP。
+- 不恢复旧 V2/V3 任务兼容；开发阶段测试数据仍可重建。
+- 不把本文变成完整 API 契约；接口细节仍以现有前后端协作文档、安全边界和 SuperAgent 契约为准。
+
+## 4. 用户与场景
+
+| 用户 / 角色 | 场景 | 期望 |
+| --- | --- | --- |
+| 普通酒店员工 | 查看待处理预订事项、订单总览和订单事项办理页 | 看到业务语言、待确认事项和确认入口，不被技术字段干扰 |
+| 后端 agent | 修改 V4 入站、任务卡模型、确认 / 复核或安全边界 | 先看本文确认需求，再同步领域模型、接口和安全文档 |
+| 前端 agent | 实现 V4 任务列表、订单详情和任务详情 UI | 先看本文确认页面定位和可展示字段，再看接口细节 |
+| 测试 agent | 测试机 smoke 和造数 | 按本文追踪表覆盖各卡片、写操作、安全扫描和阻塞规则 |
+| SuperAgent 对接方 | 输出 V4 JSON | 继续以 V4 Agent 回调字段契约为准，不因展示模型新增字段 |
+
+## 5. Definition of Ready
+
+- 需求来源已确认：来自 V4 联调和用户在 2026-07-21 至 2026-07-24 的新增需求确认。
+- 目标和非目标已确认：本文只整理需求入口，不改变业务代码。
+- 影响范围已确认：涉及 M002 V4 需求文档、前后端协作文档、安全边界、项目状态和测试 agent 交接。
+- 权限、安全、审计和数据边界已确认：继续以 `security-access-control-boundary.md` 为总边界。
+- 前后端 / 测试分工已确认：通过本文追踪表表达。
+- 未确认问题已列出：见本文第 12 节。
+
+### 5.1 模板对齐说明
+
+本文按 `docs/import/reusable/ai-native-templates/SPEC.template.md` 组织背景、目标、非目标、用户与场景、Definition of Ready、业务规则、接口或交互契约、需求追踪表、验收标准、测试范围、Definition of Done 和文档更新。
+
+Reservation V4 还必须满足 `docs/project/ai-nses-project-overlay.md` 的项目级补充，因此本文额外保留“核心概念守门”和“未确认问题”两类内容。后续若 V4 需求继续变化，应优先更新本文追踪表；如果变更已经影响已实现口径，再追加 Change Request 或新 Spec。
+
+## 6. 核心概念守门
+
+| 概念 | 本文口径 | 禁止混淆 |
+| --- | --- | --- |
+| Order | 本系统本地订单投影，用于订单总览、订单归属和同订单队列 | 不等同一封 SourceMessage，不等同 V4 Order Task，不等同 PMS 最终订单 |
+| Order Task | 同一 `source_message + order_ref` 形成的 V4 业务处理聚合 | 不等同旧 `workflow_reservation_task`，不直接代表单张卡 |
+| Task Card | Order Task 下可独立确认 / 复核 / 锁定的业务卡或来源展示卡 | 不等同整个订单，不等同 SourceMessage |
+| SourceMessage | 外部邮件或消息来源事实 | 不等同 SuperAgent 建议，不等同最终订单事实 |
+| SourceMessage Display | 普通业务 Order Task 底部来源邮件展示卡 | 不是可确认业务卡，不直接改变订单状态 |
+| S10/S99 来源通知 | V4 来源通知模型，只表示邮件需要查看或确认已处理 | 不创建订单，不创建业务 Order Task，不阻塞订单队列 |
+| SuperAgent 入站 | 外部 Agent 提交的建议、证据和结构化事件 | 不是最终业务事实，不能绕过人工确认、权限、审计和校验 |
+| REVIEW_REQUIRED | 原业务卡的复核状态 | 不新增独立复核卡，不等于允许编辑所有字段 |
+
+## 7. 业务规则
+
+### 7.1 Room Information
+
+- 只由 `NEW_BOOKING`、`UPDATE_BOOKING`、`CANCEL_BOOKING` 触发；`TRACE_RESERVATION_NOTES`、`ROOMING_LIST`、`PAYMENT` 不触发房型信息卡。
+- 后端提供 `display_payload.room_information` 稳定展示模型，前端不从 Agent raw payload、`business_fields` 或 `target_order` 自行推导。
+- `room_items[]` 支持多个房型行。每个 `room_items[].room_type_code` 必须是单个当前酒店 Room Type 目录 code；`RM2/RM3` 这类组合值必须拆成多行，不作为合法单 code。
+- `NEW_BOOKING` 展示最终值；`UPDATE_BOOKING` 展示当前值、建议值、最终值和 `change_summary[]`；`CANCEL_BOOKING` 从本地订单投影只读展示。
+- `nights` 由后端按酒店本地日期计算；日期变更时差异区也要展示 nights 变化。
+- `breakfast_included`：Group 固定含早；Fit 按 Rate Code 中 `RB` / `RO` 派生，无法派生时由用户必填确认。
+- Adult 第一版不展示。
+- Group Booking Status 仅 Group 显示，稳定 code 为 `TEN`、`DEF`、`INQ`，显示为 `TEN-Tentative`、`DEF-Definite`、`INQ-Inquiry`。New Group 默认 `TEN`，用户可在确认前改选。
+- New Booking 最终订单投影字段 `group_block_name` / `fit_name` 允许编辑，但不回写 Agent 原始 `target_order.locator_value`。
+
+### 7.2 Payment
+
+- Payment 卡业务事实仍是 Agent 返回的 `attachment_ids[]`。
+- 第一版 `attachment_ids[]` 只读，只展示并确认，不允许前端增删、替换或重新选择附件。
+- 后端在 `display_payload.payment_attachments[]` 返回安全摘要，不返回 OSS URL、签名 URL、附件正文或二进制。
+- 图片附件在卡片内展示缩略图，点击打开大图预览。
+- 非图片附件统一显示文件列表和下载动作，不在卡片内嵌 PDF、Word、Excel 或压缩包预览。
+- 图片预览和非图片下载的真实 URL 只能通过 `GET /api/source-messages/{sourceMessageId}/conversation` 原文权限链路取得。
+- Payment 确认只提交 `version`，不提交 `attachment_ids[]`、附件 URL 或完整附件对象。
+
+### 7.3 Rooming List
+
+- Rooming List 卡第一版只做事项确认。
+- 不做名单解析、附件预览、Excel 生成、PMS / OPERA / OHIP 导入。
+- 用户点击“确认卡片”表示已人工处理该 Rooming List 事项。
+- 如果同订单为 Group 且存在可更新的已确认 Room Information 快照，确认 Rooming List 后后端自动把 Group Booking Status 置为 `DEF`，并写 `V4_ROOMING_LIST_AUTO_DEF` 审计。
+- 如果此前 Group Booking Status 是 `TEN` 或 `INQ`，确认 Rooming List 后也强制覆盖为 `DEF`。
+- Fit 不显示也不变更 Group Booking Status。
+- 独立 Rooming List Excel 生成仍属于 M010 `/reservation/rooming-lists/new`，不嵌入 V4 Rooming List 卡。
+
+### 7.4 Trace
+
+- Trace 普通事项正式字段统一为 `trace_items[].text`，不使用 `trace_items[].content`。
+- `department_code` 第一版固定为 `FO`、`HSK`、`FO+HSK` 三个值，不调用 Department lookup，不开放自由文本。
+- `GENERAL` 可编辑 `trace_items[].text` 和 `trace_items[].department_code`。
+- `EXTRA_BED` 展示固定动作 `SET EXTRA BED`，可编辑 `target_room_type_code`、`extra_bed_room_count` 和 `department_code`。
+- `target_room_type_code` 只校验当前酒店 Room Type 目录存在，暂不校验当前订单已有房型。
+- `extra_bed_room_count` 必须为正整数。
+- Trace 确认或复核后，详情刷新应优先显示 confirmed payload 中的最终值，并清空旧 validation errors。
+
+### 7.5 REVIEW_REQUIRED
+
+- `REVIEW_REQUIRED` 是原业务卡的复核态，不新建独立复核卡。
+- 页面用户可见状态显示为“需要复核”，主按钮仍显示“确认卡片”。
+- 前端内部根据 `card_status=REVIEW_REQUIRED` 调用 `review-resolution`，不能调用普通 `confirm`。
+- 复核态只允许编辑当前卡 `fields[]` 白名单内 `editable=true` 的业务字段。
+- 问题字段通过 `fields[].validation_errors` 红字提示；如果后端 400 错误无法映射到可见字段，应展示在卡片动作错误区。
+
+### 7.6 普通酒店员工用户化展示
+
+- `/reservation/tasks` 默认是“待处理预订事项 / 预订事项”列表，不是 V4 工作台调试页。
+- `/reservation/orders/{orderId}` 默认是“订单总览”页，不直接确认、复核或编辑任务卡。
+- `/reservation/order-tasks/{orderTaskId}` 默认是“订单事项办理”页，不是 Task Card 模型调试页。
+- 技术信息如 `order_task_id`、`card_id`、`source_message_id`、JSON Pointer、payload、route、adapter 诊断、version 等不能出现在默认主信息层级；确需排查时只能进入高级筛选、折叠区或受控调试模式。
+- 每张事项卡的主动作按钮放在该事项卡右侧；移动端空间不足时放到卡片底部右对齐。
+- SourceMessage Display 固定在业务事项之后，邮件正文默认折叠，用户展开后才读取当前触发该 order task 的 SourceMessage 正文。
+
+### 7.7 单卡可操作态测试数据
+
+- 测试 agent 可以为每种卡片制造“目标卡单独可操作”的测试数据。
+- 造数应使用唯一 runId，不复用旧 SourceMessage 时间线导致阻塞误判。
+- 为了让目标业务卡可操作，可以先确认同 order task 内 Basic Information；目标卡本身不得提前确认。
+- 每条样例应记录 orderId、orderTaskId、sourceMessageId、目标 cardId、version、卡片状态、允许动作和安全扫描结果。
+
+## 8. 接口或交互契约
+
+本文不重复完整接口 schema，只固定入口和边界：
+
+- 后端契约：继续由后端负责入站解析、目录校验、状态机、确认 / 复核、审计、酒店隔离、脱敏和安全摘要。
+- 前端契约：只消费后端安全展示模型和 `fields[]` 白名单，负责普通酒店员工页面展示、人工确认、复核交互和受控原文读取。
+- 测试与 smoke 契约：测试 agent 需要记录版本线索、关键 ID、允许写操作、状态变化、请求摘要和安全扫描结果。
+
+| 能力 | 接口 / 文档 | 契约口径 |
+| --- | --- | --- |
+| V4 任务详情 | `GET /api/reservation/order-tasks/{orderTaskId}` | 返回安全展示模型、`fields[]`、`availability`；不返回 AI 原始 payload、邮件正文、附件 URL |
+| 卡片确认 | `POST /api/reservation/order-tasks/{orderTaskId}/cards/{cardId}/confirm` | 只确认 `PENDING_CONFIRM` 卡；业务卡按 `fields[]` 白名单提交；Payment / Rooming List 第一版只提交 `version` |
+| 复核并确认 | `POST /api/reservation/order-tasks/{orderTaskId}/cards/{cardId}/review-resolution` | 只处理 `REVIEW_REQUIRED` 卡；只接收当前卡可编辑 pointer |
+| 来源邮件正文 / 附件 URL | `GET /api/source-messages/{sourceMessageId}/conversation` | 必须有 `SOURCE_MESSAGE_READ + SOURCE_MESSAGE_ORIGINAL_READ`；写原文读取审计 |
+| 订单总览 | `GET /api/reservation/orders/{orderId}` | 只从已确认 V4 卡片派生 `order_overview`；办理动作跳 V4 order task |
+| 工作台 / 任务列表 | `GET /api/reservation/workbench-items`、`GET /api/reservation/order-tasks`、`GET /api/reservation/orders` | V4 入口优先；S10/S99 来源通知不挂订单、不进入订单队列 |
+| SuperAgent 入站 | `docs/project/requirements/M002-v4-agent-callback-field-contract.md`、`docs/project/integrations/superagent-api-contract.md` | SuperAgent 输出仍是建议和证据，不直接成为最终业务事实 |
+| 安全边界 | `docs/project/security-access-control-boundary.md` | 所有接口继续按登录、权限、酒店隔离、审计和脱敏边界执行 |
+
+## 9. 需求追踪表
+
+| 需求项 | 后端状态 | 前端状态 | 测试状态 | 文档位置 | 当前状态 |
+| --- | --- | --- | --- | --- | --- |
+| Room Information 展示模型 | Done | Done | Passed | `M002-v4-order-task-card-domain-model-cp2.md`、前后端协作文档 | Implemented |
+| Room Information 多 `room_items[]` 展示 | Done | Done | Passed | 本文、V4 领域模型、Lookup 文档 | Implemented |
+| Nights 后端派生 | Done | Done | Passed | V4 领域模型、Lookup 文档 | Implemented |
+| Breakfast 派生：Group 固定含早，Fit 按 RB / RO | Done | Done | Partially Covered | V4 领域模型、Lookup 文档 | Implemented |
+| Adult 不展示 | Done | Done | Passed | V4 领域模型、前后端协作文档 | Implemented |
+| Group Booking Status：TEN / DEF / INQ 和 Rooming List 自动 DEF | Done | Done | Passed | V4 领域模型、安全边界、审计文档 | Implemented |
+| Payment 附件安全摘要和前端预览 | Done | Done | Passed | V4 领域模型、安全边界、前后端协作文档 | Implemented |
+| Payment `attachment_ids[]` 只读、确认只提交 `version` | Done | Done | Passed | V4 领域模型、前后端协作文档 | Implemented |
+| Rooming List 轻量事项确认卡 | Done | Done | Passed | V4 领域模型、Agent 字段契约、前后端协作文档 | Implemented |
+| Trace GENERAL / EXTRA_BED 专属卡 | Done | Done | Passed | V4 领域模型、Agent 字段契约、前后端协作文档 | Implemented |
+| Trace 确认态字段刷新 | Done | Done | Passed | V4 领域模型、测试机 smoke 记录 | Implemented |
+| REVIEW_REQUIRED 原卡复核、按钮显示“确认卡片” | Done | Done | Passed | V4 领域模型、前后端协作文档 | Implemented |
+| SourceMessage Display 底部展示、正文默认折叠 | Done | Done | Passed | V4 领域模型、安全边界、前后端协作文档 | Implemented |
+| V4 工作台 / 订单详情 / 任务详情普通员工用户化展示 | N/A | Done | Passed | V4 领域模型、前后端协作文档 | Implemented |
+| 单卡可操作态测试数据 | N/A | N/A | Pending | 本文 | Approved |
+| 模板化 Spec 对齐 | N/A | N/A | N/A | 本文、AI-NSES Overlay、项目索引 | Implemented |
+
+## 10. 验收标准
+
+- Given 一个新的 V4 需求改变业务卡、接口、页面交互或安全边界，When 分派给后端 / 前端 / 测试 agent，Then 必须先引用本文或后续 Change Request，并列出需求追踪表。
+- Given 一个普通酒店员工打开任务列表、订单总览或订单事项办理页，When 页面默认加载，Then 不应在主信息层级展示 V4 模型、JSON Pointer、payload、内部 ID、route 或 adapter 诊断。
+- Given Room Information 存在多个 `room_items[]`，When 打开 V4 任务详情，Then API 和页面都应展示多行房型，不把组合 code 当成单个合法房型。
+- Given Payment 卡引用图片和非图片附件，When 打开 V4 任务详情，Then 任务详情 API 只返回附件安全摘要，前端通过 SourceMessage 原文权限链路展示图片预览和非图片下载。
+- Given Rooming List 卡被确认且同订单 Group 有可更新 Room Information 快照，When 刷新详情，Then Group Booking Status 显示 `DEF-Definite` 并可查到自动 DEF 审计。
+- Given Trace 卡确认或复核成功，When 刷新详情，Then `fields[].value` 显示已确认值，旧 validation errors 清空。
+
+## 11. 测试范围
+
+- 单元测试：本文不新增代码测试；后续代码变更仍按对应前后端模块测试要求执行。
+- 集成测试：本文不改变接口；已有 smoke 已覆盖主要 V4 卡片链路。
+- 手工验证：本次文档 checkpoint 使用 `git diff --check` 验证 Markdown 格式。
+- 后续 smoke：需要测试 agent 继续补“单卡可操作态”数据集并回填结果。
+
+## 12. 未确认问题
+
+- `QBD_TRAVEL` 是否后续改为更短的 `QBD` 仍未确认；当前继续使用现有 Account code。
+- Rate Code 第一阶段仍是酒店级目录，不按 Account / booking type 过滤；未来如需求方要求 Account 适用关系，需要另开 Change Request。
+- Payment 第一版不支持人工增删或替换附件；未来如要做附件集合编辑，需要新增数组编辑契约和审计口径。
+- Trace `target_room_type_code` 第一版只校验目录存在，不校验当前订单已有房型；未来是否收紧待确认。
+- 真实 PMS / OPERA / OHIP 目录同步、价格计算、库存校验和导入执行均后置。
+
+## 13. Definition of Done
+
+- 实现满足 Spec：本文为文档整理 checkpoint，不改业务实现。
+- 测试已运行或说明无法运行原因：运行 `git diff --check`。
+- 需求追踪表已更新：见第 9 节。
+- Project State 已更新：本 checkpoint 更新 `PROJECT_STATE.md`。
+- 接口、安全、权限、审计、集成契约已同步：本文不改变接口、安全、权限、审计或 SuperAgent 入站契约；现有契约文档保持权威。
+- 无 Secret、真实数据、构建产物或无关本地变更：本文只新增 / 修改文档。
+
+## 14. 文档更新
+
+本 checkpoint 需要同步：
+
+- `PROJECT_STATE.md`
+- `docs/project/README.md`
+- `docs/project/ai-nses-project-overlay.md`
+
+本 checkpoint 不需要同步后端代码、前端代码、数据库 migration 或安全边界，因为没有改变业务接口、权限、酒店隔离、审计或敏感数据返回规则。