35 lines
1.3 KiB
Markdown
35 lines
1.3 KiB
Markdown
# Project Positioning
|
||
|
||
## One-line Positioning
|
||
|
||
ARR 是一个面向酒店 Finance 的 Opera XML 数据接入、验证入库与报表自动化系统。
|
||
|
||
## Primary Goal
|
||
|
||
用户只需上传 Opera XML；ARR 自己运行固定处理器、验证完整结果并写入数据库，再由后台自动触发月报等下游处理程序。
|
||
|
||
## Target Users / Consumers
|
||
|
||
- 酒店 Finance 操作员
|
||
- 消费已验证数据库事实的月报、渠道分析和公司报表程序
|
||
|
||
## Non-goals
|
||
|
||
- 不要求业务用户为月报提交年份、月份、截止日期或其他内部控制参数。
|
||
- 月报程序不重复执行 XML 解析、白名单、去重、定价或公司匹配。
|
||
|
||
## Core Constraints
|
||
|
||
- 只有 ARR 程序化结果成功验证并提交数据库后，才允许触发下游月报程序。
|
||
- 月报所需的年月和截止范围由业务系统内部推导；内部审计字段不得变成用户输入要求。
|
||
- 工作簿必须保留 `TOTAL PRICE` 字段，其数据行公式为 `REAL PRICE × NIGHTS × NO_OF_ROOMS`。
|
||
- 数据处理应确定、可追溯、隐私最小化并支持安全重试。
|
||
|
||
## Quality Bar
|
||
|
||
正确实现应让上传、固定处理、独立验证、数据库提交和报表触发形成可验证的完整链路，并通过自动化测试证明字段、公式与触发边界。
|
||
|
||
## Last Reviewed
|
||
|
||
2026-07-30
|