wyndham-ARR/README.md

Wyndham ARR

ARR 是一套受控的 Opera 日报处理与经营数据应用。当前可部署链路为：

业务页面上传 XML
  -> ARR 写入私有 OSS 并登记任务
  -> ARR 调用 SuperAgent Open API
  -> SuperAgent 读取 OSS XML 并执行确定性日报 Skill
  -> SuperAgent 调用 ARR MCP 的 arr_submit_processing_result
  -> ARR 独立复验源 XML 后事务落库
  -> 日报历史、月度投影和渠道看板从数据库读取

公网部署

仓库提供 Docker Compose + Caddy 部署入口。该入口显式使用 --enable-processing 打开 XML 上传处理，并使用 --secure-cookies、HTTPS、 Web Basic Auth 和 MCP Bearer 保护公网服务。

完整步骤见 deploy/README.md。部署后必须确认：

• GET /api/health 的 database_ready=true；
• GET /api/health 的 processing_ready=true；
• MCP 未认证请求返回 401；
• 认证后的 MCP 工具发现只返回 arr_submit_processing_result。

应用源码默认仍为 fail-closed；直接运行 python -m arr_web.run 不会自动开启上传处理。

主要入口

• arr_web：上传、任务历史、月度数据与渠道看板 Web/API；
• arr_mcp：SuperAgent 结构化处理结果的单工具 MCP 入库网关；
• arr-opera-daily-ingest：Opera XML 的确定性日报处理 Skill；
• database：PostgreSQL 15+ schema、增量迁移和 MCP 契约；
• tests：单元、契约和无隐私合成链路测试。

当前能力边界

• XML 上传、私有 OSS 保存、SuperAgent 任务发起和 MCP 直接落库代码已接线；
• 正式公网环境仍需部署者注入数据库、OSS、SuperAgent 和 MCP Secret，并完成一次无隐私 XML 竖切验收；
• “日报落库后自动触发月报”与月报 TOTAL PRICE 指定公式仍未实现，本部署配置不会开启月报/公司报表写入端点，也不会把远端 Agent success 误报为数据库已提交。

本地测试

python3 -m unittest discover -s tests -v

项目不会从仓库内自动加载 .env。真实凭据、业务 XML/XLSX、数据库文件、运行输出和虚拟环境均不得提交。