# 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
