feat: prepare ARR for controlled public deployment
This commit is contained in:
34
.project-docs/00-brief/project-positioning.md
Normal file
34
.project-docs/00-brief/project-positioning.md
Normal file
@@ -0,0 +1,34 @@
|
||||
# Project Positioning
|
||||
|
||||
## One-line Positioning
|
||||
|
||||
ARR 是一个面向酒店 Finance 的 Opera XML 数据接入、验证入库与报表自动化系统。
|
||||
|
||||
## Primary Goal
|
||||
|
||||
用户只需上传 Opera XML;Agent 处理后提交结构化结果,业务系统验证并写入数据库,再由后台自动触发月报等下游处理程序。
|
||||
|
||||
## Target Users / Consumers
|
||||
|
||||
- 酒店 Finance 操作员
|
||||
- 消费已验证数据库事实的月报、渠道分析和公司报表程序
|
||||
|
||||
## Non-goals
|
||||
|
||||
- 不要求业务用户为月报提交年份、月份、截止日期或其他内部控制参数。
|
||||
- 月报程序不重复执行 XML 解析、白名单、去重、定价或公司匹配。
|
||||
|
||||
## Core Constraints
|
||||
|
||||
- 只有 Agent 结构化结果成功验证并提交数据库后,才允许触发下游月报程序。
|
||||
- 月报所需的年月和截止范围由业务系统内部推导;内部审计字段不得变成用户输入要求。
|
||||
- 工作簿必须保留 `TOTAL PRICE` 字段,其数据行公式为 `REAL PRICE × NIGHTS × NO_OF_ROOMS`。
|
||||
- 数据处理应确定、可追溯、隐私最小化并支持安全重试。
|
||||
|
||||
## Quality Bar
|
||||
|
||||
正确实现应让上传、Agent 回写、数据库提交和报表触发形成可验证的完整链路,并通过自动化测试证明字段、公式与触发边界。
|
||||
|
||||
## Last Reviewed
|
||||
|
||||
2026-07-29
|
||||
Reference in New Issue
Block a user