shiyuyun/wyndham-ARR
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: prepare ARR for controlled public deployment

Browse Source
This commit is contained in:
Wyndham ARR
2026-07-29 16:38:05 +08:00
commit a701de9f0e
271 changed files with 48472 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
.project-docs/40-domain/business-rules.md Normal file
View File

@@ -0,0 +1,20 @@
# Business Rules
## Durable Rules
- The user uploads XML; the user does not submit a report year, report month, cutoff date, or separate monthly-generation request in the primary workflow.
- The Agent returns structured data, which must be validated and successfully committed to the database before downstream monthly processing starts.
- A successful database commit automatically triggers the monthly-report processing program through the business system.
- Year, month, cutoff/as-of date, and similar fields are internal derived execution/audit values. Their presence in code or metadata does not make them user inputs.
- The monthly output contains the exact business dimension/field `TOTAL PRICE`.
- Each monthly XLSX data-row `TOTAL PRICE` cell is a formula whose business meaning is `REAL PRICE × NIGHTS × NO_OF_ROOMS` (current layout example: `=R2*C2*G2`).
- A stored database `total_price` may be used for integrity checking, but it does not replace the required formula in the exported workbook.
## Open Questions
- The internal event/outbox/worker mechanism for automatic dispatch is not yet selected.
- The exact business-time and cutoff derivation policy is not yet specified; the system must derive it without user input.
## Last Reviewed
2026-07-29

10
.project-docs/40-domain/glossary.md Normal file
View File

@@ -0,0 +1,10 @@
# Glossary
| Term | Meaning | Notes |
|---|---|---|
| `REAL PRICE` | Unit/base price used by the report calculation | Existing layout places it in column R. |
| `NIGHTS` | Number of nights for the row | Existing layout places it in column C. |
| `NO_OF_ROOMS` | Number of rooms for the row | Existing layout places it in column G. |
| `TOTAL PRICE` | Required report dimension calculated as `REAL PRICE × NIGHTS × NO_OF_ROOMS` | Must be an XLSX formula cell, not only a static exported value. |
| Internal report parameters | Derived values such as report year, month and cutoff/as-of date | May exist in program calls and audit metadata; never a required user submission in the primary flow. |
| Successful commit | Agent structured result has passed validation and been atomically persisted as accepted Finance facts | Automatic monthly processing may start only after this point. |