Help
Operational guidance and product caveats.
The help surface keeps the user-facing caveats from the spec visible, especially around historical order imports, validation behavior, and downloadable artifacts.
Order Import Modes
Historical versus operational order import
The spec requires the merchant to choose one mode explicitly and to see plain-English warnings before submit.
Historical order recreation
Best-effort recreation for migration scenarios. Complex discounts, tax parity, and transaction parity may flatten or differ from the source platform.
Draft or manual order creation
Operational import for merchants bringing in back-office or wholesale orders that should remain editable inside current workflows.
Validation Model
Blocking errors stop rows, not always the whole job.
The spec distinguishes blocking issues from warnings and expects downloadable reports for both.
Blocking
Missing required fields, malformed JSON, invalid types, impossible enums, sheet or root missing.
Warnings
Duplicates, suspicious prices, unknown optional columns, unmatched references, unreachable image URLs.
Artifacts
What every completed job should expose
The UI foundation already accounts for a multi-artifact job record rather than a single download.
Implementation Notes
What is testable now and what still needs real infrastructure
The prototype now runs with postgresql job and installation store, s3-compatible storage (flowport-prod-store-715113907770-eu-west-2/flowport), signed downloads, server-side job actions, and embedded Shopify bootstrap primitives.
Testable now: persisted jobs, simulated worker stage progression, per-shop import and export lane coordination, create import and export flows, retry or duplicate, cancel, archive, dashboard refresh, signed artifact downloads, and embedded Shopify token bootstrap with uninstall handling.
Still pending on the Shopify side: syncing the live app record in the Developer Dashboard or via CLI so the hosted subdomain, redirect URLs, and webhook config are fully registered against the app.
Current production step completed: PostgreSQL for jobs and Shopify installation state, plus S3-backed artifacts.
Next production step: Redis-backed concurrency and worker orchestration.
Next production step: Shopify bulk operation handlers and write-side mutation pipelines.