starcoach-hackathon/zarinpal-analytics-backend
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(import): approve validation and recovery policy

Browse Source
This commit is contained in:
Amirhossein Khalili
2026-08-20 18:49:12 +03:30
parent 7416a0859c
commit f9356da179
1 changed files with 2 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/IMPORT-VALIDATION-RECOVERY-SPEC.md
View File

@@ -1,6 +1,6 @@
# Import Validation, Rejection, and Recovery Specification # Import Validation, Rejection, and Recovery Specification
- Status: Decision-ready draft — stakeholder approval required - Status: Approved specification — implementation not yet authorized
- Capability: Data foundation bootstrap integrity - Capability: Data foundation bootstrap integrity
- Depends on: Approved physical schema and one-time Docker import workflow - Depends on: Approved physical schema and one-time Docker import workflow
- Implementation authorization: Not granted - Implementation authorization: Not granted
@@ -247,7 +247,7 @@ docker compose --profile bootstrap run --rm importer recover \
- Ask first: change a fatal/warning classification, expected count/checksum, size cap, transaction boundary, issue-retention field, or recovery behavior. - Ask first: change a fatal/warning classification, expected count/checksum, size cap, transaction boundary, issue-retention field, or recovery behavior.
- Never: partially publish, skip checks, accept another checksum, retain raw failed rows, log source values, guess missing data, mutate completed facts, or recover by truncating normalized tables. - Never: partially publish, skip checks, accept another checksum, retain raw failed rows, log source values, guess missing data, mutate completed facts, or recover by truncating normalized tables.
## Decision batch for approval ## Resolved decisions
1. Pin the exact supplied archive SHA-256, schema, filename, and expected reconciliation counts. 1. Pin the exact supplied archive SHA-256, schema, filename, and expected reconciliation counts.
2. Fail the whole import on any fatal issue; never publish a partial dataset. 2. Fail the whole import on any fatal issue; never publish a partial dataset.