shiyuyun/wyndham-ARR
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
aae3d8e1db4c13baf7b93e9d54a7ba14dfd2b486
wyndham-ARR/arr_ingestion/README.md
Wyndham ARR bf7939dd1a feat: sync latest ARR implementation
2026-07-31 15:11:42 +08:00

1.2 KiB
Raw Blame History

ARR validated daily ingestion

This package is the authoritative validate-before-write boundary for ARR2.

committed source/output objects
  -> DeliveryEnvelope 1.0
  -> DeliveryValidator (identity + strict v3 reconciliation + validate_daily.py)
  -> PostgresIngestionRepository (one atomic transaction)
  -> current Finance facts + privacy-minimized outbox

JobRegistration records source/processor/rule/attempt identity before processing. Controlled processor failures use a complete failed delivery and retain auditable outcomes without changing the current Finance version. Timeouts, process-start errors, malformed artifacts or pre-commit validation errors use explicit lifecycle failure state.

Only recognized transient PostgreSQL SQLSTATEs reopen the full transaction, at most four attempts. Business, Schema and identity errors are never retried. Exact delivery replay is idempotent; changed bytes under the same ID conflict.

Migrations 009/010 and direct-submission modules remain historical compatibility surfaces, but ARR2 uses the generic artifact-delivery tables with their existing artifact_callback default and does not expose an MCP gateway.