Data Handling

StoreStory Data Handling

StoreStory currently supports a narrow pilot workflow: upload structured Shopify exports, validate the dataset, compute deterministic KPIs, and generate a narrative report.

This page explains the main processing boundaries behind that workflow.

Supported data inputs

During the pilot phase, StoreStory supports a limited input scope designed to keep processing stable and interpretable.

  • Required dataset: orders.csv exported from Shopify.
  • Optional dataset: products.csv for product enrichment when available.
  • Additional datasets may be supported in future versions.

Validation rules

Uploaded datasets must pass validation before processing begins.

  • Validation includes required column checks.
  • Validation includes duplicate order detection.
  • Validation includes basic format verification.
  • If validation fails, report generation does not proceed.

Deterministic calculations

All KPI calculations are deterministic and are derived directly from uploaded datasets using versioned calculation logic.

This allows report results to remain reproducible for the same input data and metric definitions.

Confidence signals

When data coverage is limited, the system may mark results with a low-confidence status rather than presenting unsupported certainty.

  • Examples include insufficient prior baseline coverage.
  • Examples include incomplete or low-quality datasets.
  • Confidence notes appear directly in the report output.

Data minimization

StoreStory processes only the fields required to generate analytics insights.

Customer contact information is not required for the primary analysis flow.