2.7 KiB
2.7 KiB
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 和代码映射;正式参数缺失不阻止测试阶段的接口研究。
来源和可复用结论见 跨项目上下文核对。
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(按用户明确的直接数据入口方向与当前实施边界更新)