提交一次全量代码

docs/project/requirements/M002-backend-data-model-design.md

@@ -393,7 +393,8 @@
 - 任务卡字段矩阵配置：先写在代码 Provider 中。
 - 任务阻塞状态：实时计算，不落 `BLOCKED`。
 - OPERA 真实接口字段映射：后续真实系统接入后在 adapter 层补充。
-- 全量 Excel 字段路径：引用 `任务卡展示编辑矩阵.xlsx`，不手抄成数据库。
+- 全量 Excel 字段路径：后端引用 `docs/import/20260706/任务卡展示编辑矩阵.xlsx` 作为完整规则来源，不手抄成数据库。
+- 前端展示 / 编辑白名单：前端引用 `docs/import/20260708/任务卡前端展示字段表 3.0.xlsx`，该白名单不作为后端校验和 OPERA 映射的替代来源。
 
 ## 15. 待确认问题
 

docs/project/requirements/M002-superagent-task-result-api-contract.md

@@ -57,12 +57,15 @@ hotel_id + source_provider(默认 AGENTBUS) + source_channel(默认 EMAIL) + sou
 
 | 环境变量 | 是否必填 | 中文说明 |
 | --- | --- | --- |
-| `SUPERAGENT_TASK_RESULT_HMAC_SECRET` | 是 | SuperAgent 任务结果入站签名密钥，只能通过 Secret 注入 |
+| `SUPERAGENT_DEV_TASK_RESULT_HMAC_SECRET` | dev 必填 | dev SuperAgent 任务结果入站签名密钥，只能通过 Secret 注入 |
+| `SUPERAGENT_TEST_TASK_RESULT_HMAC_SECRET` | test 必填 | test SuperAgent 任务结果入站签名密钥，只能通过 Secret 注入 |
+| `SUPERAGENT_PROD_TASK_RESULT_HMAC_SECRET` | prod 必填 | prod SuperAgent 任务结果入站签名密钥，只能通过 Secret 注入 |
+| `SUPERAGENT_TASK_RESULT_HMAC_SECRET` | 兼容兜底 | 旧通用 HMAC 变量；新环境优先配置环境专属变量 |
 | `SUPERAGENT_TASK_RESULT_CLOCK_SKEW_SECONDS` | 否 | 请求时间允许偏移，默认 `300` 秒 |
 | `SUPERAGENT_TASK_RESULT_NONCE_TTL_SECONDS` | 否 | Nonce 去重窗口，默认 `600` 秒 |
 | `SUPERAGENT_TASK_RESULT_MAX_BODY_BYTES` | 否 | 请求体最大字节数，默认 `1048576` |
 
-如果 `SUPERAGENT_TASK_RESULT_HMAC_SECRET` 为空，生产环境应拒绝接口调用。
+如果当前 profile 对应的 `SUPERAGENT_*_TASK_RESULT_HMAC_SECRET` 和旧通用变量都为空，生产环境应拒绝接口调用。
 
 ### 3.2 请求 Header
 
@@ -92,7 +95,7 @@ POST
 签名算法：
 
 ```text
-signature = HMAC_SHA256(SUPERAGENT_TASK_RESULT_HMAC_SECRET, canonical_string)
+signature = HMAC_SHA256(当前 profile 生效的 SuperAgent HMAC secret, canonical_string)
 ```
 
 Header 写法：