49 lines
2.7 KiB
Markdown
49 lines
2.7 KiB
Markdown
# Project Positioning
|
||
|
||
## One-line Positioning
|
||
|
||
ARR 是一个面向酒店财务部的 Opera ARR 源报表获取、处理、验证入库与下游报表全流程服务。
|
||
|
||
## Primary Goal
|
||
|
||
目标是通过接口取得需要处理的 ARR 业务数据，按固定业务规则加工、验证并写入数据库，再由后台自动触发
|
||
月报等下游程序，向财务部提供可下载的结果。用户于2026-09-18明确保留人工XML入口，新增按日期查询OHIP数据的
|
||
直接数据入口，两者采用一致的业务规则；自动入口不再以取得或重建XML为前提。
|
||
当前人工上传与15字段直接数据处理、校验、页面及日报/月报衔接均已实现并完成本机模拟检查；
|
||
用户确认日期选择交互。生产配置与真实数据验收待完成，详见交付说明。
|
||
|
||
## Same-Hotel Project Context
|
||
|
||
用户于 2026-09-16 明确：ARR 服务财务部，`Wyndham-RSVN0804` 下的预订部项目服务同一家酒店。
|
||
两者使用同一 OHIP 封装平台和酒店接入背景，保留各自的部门业务处理、应用和凭据。
|
||
|
||
预订部任务中用户已明确当前使用标准测试环境，先联调，经 Oracle 审批后再接入该酒店正式环境；接口契约
|
||
沿用，环境参数分别配置。当前 `OHIPSB02` 是已知测试酒店，不再把其身份作为 ARR 研究的未知阻碍或要求用户
|
||
重复确认。正式接入时核对实际地址、凭据、酒店 ID 和代码映射；正式参数缺失不阻止测试阶段的接口研究。
|
||
来源和可复用结论见 [跨项目上下文核对](../50-evidence/topics/2026-09-16-shared-hotel-rsvn-context.md)。
|
||
|
||
## Target Users / Consumers
|
||
|
||
- 酒店 Finance 操作员
|
||
- 消费已验证数据库事实的月报、渠道分析和公司报表程序
|
||
|
||
## Non-goals
|
||
|
||
- 不要求业务用户为月报提交年份、月份、截止日期或其他内部控制参数。
|
||
- 月报程序不重复执行 XML 解析、白名单、去重、定价或公司匹配。
|
||
|
||
## Core Constraints
|
||
|
||
- 只有 ARR 程序化结果成功验证并提交数据库后，才允许触发下游月报程序。
|
||
- 月报所需的年月和截止范围由业务系统内部推导；内部审计字段不得变成用户输入要求。
|
||
- 工作簿必须保留 `TOTAL PRICE` 字段，其数据行公式为 `REAL PRICE × NIGHTS × NO_OF_ROOMS`。
|
||
- 数据处理应确定、可追溯、隐私最小化并支持安全重试。
|
||
|
||
## Quality Bar
|
||
|
||
正确实现应让源报表获取/上传、固定处理、独立验证、数据库提交和报表触发形成可验证的完整链路，并通过自动化测试证明字段、公式与触发边界。
|
||
|
||
## Last Reviewed
|
||
|
||
2026-09-18（按用户明确的直接数据入口方向与当前实施边界更新）
|