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

feat: add daily manual price review workflow

Browse Source
This commit is contained in:
Wyndham ARR
2026-08-06 22:40:18 +08:00
parent aae3d8e1db
commit ca3e8e18fa
77 changed files with 7750 additions and 602 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
.project-docs/40-domain/business-rules.md
View File

@@ -16,6 +16,12 @@
recent month containing that record type. Viewing-month state is read-only: it resets list paging but never changes
monthly derivation or a company generation request. Company `生成月份` and history `查看月份` are separate inputs.
- ARR's frozen processor generates complete structured data, which must be independently validated and successfully committed to the database before downstream monthly processing starts.
- A non-empty set of errors made entirely of `PRICE_UNMATCHED` is the sole exception to immediate failure: it becomes a pending manual-price review and remains active without a Finance version, daily download, failure event or monthly trigger.
- The review key is normalized company + Rate Code + Opera price. Staff may set only its non-negative integer price
(including explicit `0`); they may not change XML/company/rate/Opera fields or the fixed reference table. ARR stores
the accepted integer as exact `numeric(18,2)` and freezes canonical `.00` manifest text for deterministic replay.
- Finalization freezes one canonical manifest bound to job, case, source SHA, business date, processor/rule identity and the complete key set, then replays original XML plus the fixed table. Only independently accepted final replay creates `manual_review` retained facts and one daily-commit event.
- If the processor/rule identity changes while a case is open, staff must cancel and re-upload. Retryable infrastructure errors preserve the frozen manifest; deterministic final errors formally fail the case/run.
- The production XML path must not require Agent, MCP, prompts, model-generated JSON, fetch grants, or a public source URL.
- A successful database commit automatically triggers the monthly-report processing program through the business system.
- Automatic monthly processing runs in a dedicated worker process, not inside the Web request process.
@@ -73,4 +79,4 @@
## Last Reviewed
2026-07-31
2026-08-06