Files
ARR-2.0-0918/.project-docs/00-brief/project-positioning.md
T

2.7 KiB
Raw Blame History

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(按用户明确的直接数据入口方向与当前实施边界更新)