shiyuyun/wyndham-ARR
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
ad3d9878c5aa8d956339ef6871322000e694f5ca
wyndham-ARR/.project-docs/20-architecture/data-flow.md
Wyndham ARR a701de9f0e feat: prepare ARR for controlled public deployment
2026-07-29 16:38:05 +08:00

1.1 KiB
Raw Blame History

Data Flow

Primary Flows

Flow Source Destination Notes
XML ingestion User upload Agent processing Upload is the user's only required action for this flow.
Structured result commit Agent output PostgreSQL Finance facts Independent validation/replay must succeed before commit.
Automatic monthly trigger Successful database commit Monthly-report worker/program Month and cutoff values are derived internally, not supplied by the user.
Monthly workbook build Committed Finance facts XLSX artifact TOTAL PRICE cells use REAL PRICE × NIGHTS × NO_OF_ROOMS formulas.

State Ownership

  • PostgreSQL owns accepted/current Finance facts and processing state.
  • Generated XLSX files are artifacts derived from a pinned database snapshot; they are not an alternative fact source.

External Interfaces

  • User-facing: XML upload, processing status, and controlled report download.
  • Internal: Agent structured-result submission and automatic report-task dispatch after commit.

Last Updated

2026-07-29