Skip to content

limitations.md

Latest commit

 

History

History
63 lines (39 loc) · 2.55 KB

limitations.md

File metadata and controls

63 lines (39 loc) · 2.55 KB
Raw

Limitations

This repository is intentionally narrow.

Not a runnable project

There is no public source code, package configuration, dependency file, test suite, Docker setup, or command-line workflow.

The runnable implementation is kept outside this public case-study repository.

Not a Shopify app

This is not a Shopify embedded app, public app, custom app scaffold, OAuth flow, webhook service, or production Admin API connector.

Not a production GraphQL connector

The v0.2 material describes a private GraphQL-shaped mock workflow using fake local fixtures. It is useful for showing cursor-style pagination concepts, but it does not include production Shopify GraphQL queries, OAuth handling, access tokens, real store domains, webhook handling, or connector code.

Not public live-store validation evidence

The v0.3 material describes evidence boundaries for development-store validation. Public materials focus on sanitized previews and high-level workflow notes; live Shopify validation evidence remains private unless it is prepared separately for public release.

Not a public connector template

The v0.4 material describes the private connector template at a high level. Connector source code, detailed request and response material, app identity values, automation-token handling, credentials, store identifiers, and redaction implementation details remain private.

Not an extension implementation

The v0.5 material documents optional extension planning only. Google Sheets, PostgreSQL, scheduler, dashboard, webhook, and cloud delivery integrations would be scoped separately for a real client project.

Not a complete API integration guide

The documentation describes workflow concepts, not a step-by-step connector implementation.

A real integration would need secure handling for:

  • Shopify Admin API credentials;
  • approved access scopes;
  • cursor pagination;
  • rate limits;
  • retries;
  • privacy-sensitive customer fields;
  • store-specific reporting definitions.

Not a complete mapping specification

The repo does not include full field mapping templates. Real Shopify reporting often depends on store-specific decisions for:

  • product variants;
  • refunds;
  • discounts;
  • taxes;
  • shipping;
  • fulfillment status;
  • sales channel;
  • locations;
  • custom attributes.

Not a replacement for business metric definitions

Gross sales, net sales, taxes, discounts, refunds, and shipping must be defined with the client before report numbers are treated as final.

The workflow can make those assumptions explicit, but it cannot decide them automatically.