System overview

👤 Ops · 🛠 Dev

Car Battery Pro is made up of four moving parts. The store you see is Shopify; the "smart" features are powered by a custom API behind it.

The four parts

1. Shopify store + theme — the catalogue, cart, checkout, payments, and the customer-facing pages. The theme is the custom CBP codebase that Conversion Kings maintains.
2. CBP backend API — a custom service (hosted on Cloudflare Workers, in the separate eb-cbp-rego-lookup repo) that answers the questions Shopify can't: which battery fits this car?, is this postcode valid?, what installation slots are free?. It does this by calling external providers — AutoInfo (vehicle data), Australia Post (postcodes), and Google (Calendar, Places, Gmail) — and the Shopify Admin API to match batteries to products. See The backend API.
3. Booking data source — installation availability comes from Google Calendars that the CBP office controls (one per installer). Bookings are confirmed when the order is paid, via a Shopify webhook. See Appointments & scheduling.
4. Tracking — a Shopify Web Pixel forwards customer events into Google Tag Manager. See Tracking & Analytics.

How they fit together

Customer's browser
      │
      ▼
Shopify store (CBP theme)  ──►  CBP backend API (Cloudflare Workers)
      │                              │   • vehicle lookup        → AutoInfo
      │                              │   • battery compatibility → Shopify Admin API
      │                              │   • postcode lookup       → Australia Post
      │                              │   • address autocomplete  → Google Places
      │                              │   • installation slots    → Google Calendars
      │                              ▼
      │                         Installer Google Calendars (office)
      ▼                                   ▲
Shopify checkout & orders ── order_paid ──┘  (confirms the booking)
      │
      ▼
Google Tag Manager  ◄── Shopify Web Pixel (tracking)

What's standard vs custom

If a task touches the Standard Shopify column, this handbook points you to Shopify's help docs. If it touches the Custom CBP column, it's documented in full here.