实现V4目录管理后台CP1后端

This commit is contained in:
andy
2026-07-19 17:56:08 +07:00
parent 22767e194d
commit f2c2616ab0
23 changed files with 1958 additions and 31 deletions

View File

@@ -4,15 +4,15 @@
| --- | --- |
| 最近更新 | 2026-07-19 |
| 当前分支 | `feature/huangting` |
| 当前阶段 | M002 V4 入站、多卡模型、持久化基线、入站写入、查询接口、卡片确认、复核解阻、目录校验、订单详情时间线、DB 目录、Lookup API前端 lookup 接入并行 |
| 当前重点 | M002 V4 已完成 DB 管理目录与 Lookup API V1 后端,并完成前端 V4 多卡字段 lookup 第一版接入;后续可做目录管理后台或真实 PMS / OPERA / OHIP 同步 |
| 当前阶段 | M002 V4 入站、多卡模型、持久化基线、入站写入、查询接口、卡片确认、复核解阻、目录校验、订单详情时间线、DB 目录、Lookup API前端 lookup 接入和目录管理后台 CP1 后端 |
| 当前重点 | M002 V4 已完成 DB 管理目录与 Lookup API V1 后端前端 V4 多卡字段 lookup 第一版接入,并完成目录管理后台 CP1 后端接口;后续可做目录管理前端页面或真实 PMS / OPERA / OHIP 同步 |
## 1. 当前 Checkpoint
- 名称:`M002-V4-CP12-frontend-lookup-and-multicard-integration`
- 状态Done端已按 V4 任务卡 `fields[].options_source` 接入 Account / Room Type / Rate Code lookup API替换前端硬编码目录选项V4 多卡详情页会展示 lookup 空列表、stale、warnings、目录来源版本和 Account 派生 Market / Source确认 / 复核仍只提交 code订单详情页已消费 `v4_order_tasks[]` 展示 V4 订单任务时间线
- 目标:让 V4 任务详情字段控件不再依赖前端硬编码选项,后端入站、确认、复核统一按当前酒店数据库目录做校验
- 边界:本轮不接真实 PMS / OPERA / OHIP 同步,不做目录管理后台,不新增 `workflow_reservation_catalog_sync_run`,不做 SuperAgent 目录机器接口,不废弃旧 V2/V3 接口。
- 名称:`M002-V4-CP13-catalog-admin-backend-cp1`
- 状态Done端已开放 Account / Room Type / Rate Code 目录管理后台 CP1 接口,支持列表查询、新增、启用 / 停用;权限使用 `RESERVATION_CATALOG_MANAGE`,强制 Bearer 登录、权限码、酒店访问权和管理审计
- 目标:让测试机和后续系统设置页面可以通过后端维护第一版数据库目录,停用目录不再进入普通 V4 lookup
- 边界:本轮不接真实 PMS / OPERA / OHIP 同步,不做目录管理前端页面,不做 Market / Source 独立管理页面,不新增 `workflow_reservation_catalog_sync_run`,不做 SuperAgent 目录机器接口,不废弃旧 V2/V3 接口。
## 2. 当前优先级
@@ -39,7 +39,7 @@
## 5. Next Steps
- 后续如继续做 M002 V4可优先进入 V4 多卡真实联调验收、目录管理后台、真实 PMS / OPERA / OHIP 目录同步和 `workflow_reservation_catalog_sync_run` checkpoint。
- 后续如继续做 M002 V4可优先进入测试机 V4 冒烟、目录管理后台前端页面、真实 PMS / OPERA / OHIP 目录同步和 `workflow_reservation_catalog_sync_run` checkpoint。
- 后续新增重要功能时,优先在 `docs/project/requirements/` 或未来 `docs/specs/` 中形成 Spec再实现代码。
- M010 后续如需预览、历史记录、OSS 下载、订单 / 任务预填或客户字段目录化,再单独开前后端 checkpoint。