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

docs(import): approve docker bootstrap workflow

Browse Source
This commit is contained in:
Amirhossein Khalili
2026-08-20 18:44:31 +03:30
parent 8ff093b238
commit d978730202
1 changed files with 2 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/IMPORT-WORKFLOW-SPEC.md
View File

@@ -1,6 +1,6 @@
# One-Time CSV-to-PostgreSQL Import Workflow Specification # One-Time CSV-to-PostgreSQL Import Workflow Specification
- Status: Decision-ready draft — stakeholder approval required - Status: Approved specification — implementation not yet authorized
- Capability: Data foundation bootstrap - Capability: Data foundation bootstrap
- Depends on: Approved PostgreSQL physical schema - Depends on: Approved PostgreSQL physical schema
- Implementation authorization: Not granted - Implementation authorization: Not granted
@@ -169,7 +169,7 @@ Progress logging is rate-limited by time or aggregate row milestones rather than
- Ask first: replace the dataset, resume or delete failed staging, change batch/resource limits, add Python, alter normalization, or run against a non-empty fact database. - Ask first: replace the dataset, resume or delete failed staging, change batch/resource limits, add Python, alter normalization, or run against a non-empty fact database.
- Never: run on a timer, import on every restart, expose an importer port, bake the dataset into an image, auto-migrate in application startup, log raw rows/tokens/secrets, or silently truncate production tables. - Never: run on a timer, import on every restart, expose an importer port, bake the dataset into an image, auto-migrate in application startup, log raw rows/tokens/secrets, or silently truncate production tables.
## Decision batch for approval ## Resolved decisions
1. Use Bash for Docker orchestration and the compiled Go importer for CSV/database work; do not add Python. 1. Use Bash for Docker orchestration and the compiled Go importer for CSV/database work; do not add Python.
2. Run import during the explicit `first-start.sh` bootstrap, not ordinary container startup or restart. 2. Run import during the explicit `first-start.sh` bootstrap, not ordinary container startup or restart.