Sync Status
Loading...
Catalog Admin UI
Live operational snapshot for ingestion, sync, and probe health.
Job Control
No job activity yet.
Snapshot
Entity Counts
Categories
Currencies
Probe Status
Loading...
Drift Status
Loading...
Recent Artifacts
| File | Size | Modified |
|---|
Products
Loading products...
| ID | Name | Category | Status | Cheapest |
|---|
Product
Pricing
Config Options
Promotions
Promotions
Loading promotions...
| Code | Status | Type | Value | Applies To |
|---|
Normalization Explorer
Reviewing normalized output from latest snapshot.
| ID | Name | Slug | Category | Prices | Missing Cycles |
|---|
Normalized Product
Loading...
Override Layer
Loading overrides...
Loading...
Sites
Loading sites...
| Site | Draft Date | Draft Version | Published Date | Published Version | Actions |
|---|
Site Workbench
Select a site and load its draft.
Friendly Product Editor
Use quick grid edit for product fields, then save draft.
| ID | Name | Slug | Status | Description | Pricing Rows | Apply |
|---|
Select a compare option.
Workflow Documentation
This page explains the end-to-end sync flow, safety gates, and what every UI button does.
End-to-End Process
- Probe (optional): Checks WHMCS connectivity and writes probe reports without changing catalog state.
- Sync ingest: Pulls WHMCS products and promotions, normalizes rows, and builds a snapshot.
- Draft latest write: Every successful ingest writes to draft latest so admin can inspect fresh data.
- Quality and drift checks: Gate logic validates the snapshot against thresholds and previous published version.
- Published latest promotion: Only happens when quality and drift gates pass.
- Per-site workflow: Push latest to a site draft, edit, save, then publish for that site.
- Public consumption: Public endpoint serves each site's published catalog only.
Site Publish Process (Required Steps)
- Run Run Sync Now so the latest WHMCS data is ingested into draft latest.
- Open Sites, select your site, then click Push Latest to copy latest data into that site's draft.
- Click Load Site (or Load Draft) to open the draft in the editor.
- Optional: edit products/pricing in grid mode or raw JSON mode.
- Click Save Draft (or Apply All + Save Draft) to persist your changes.
- Click Publish (or Publish Draft) to move that site's draft to published.
- Consumer systems should read from that site's public published endpoint only.
Diagram
WHMCS | | 1) Run Sync Now v Draft Latest Snapshot (global) | | 2) Push Latest (for selected site) v Site Draft (sites/<siteId>/draft) | | 3) Load + Edit + Save Draft v Site Draft (updated) | | 4) Publish / Publish Draft v Site Published (sites/<siteId>/published) | | 5) Public read path v /api/public/catalog?site=<siteId>
Important Behavior
- Gate failures no longer block draft freshness; they only block published latest promotion.
- Products and normalization views read draft latest first (with published fallback).
- Sites remain isolated: draft edits affect only that selected site until publish.
- Publish history records what was promoted for each site.
Button Reference
| Location | Button | Function |
|---|---|---|
| Top Bar | Run Sync Now | Triggers manual sync. Writes draft latest; publishes latest only if gates pass. |
| Top Bar | Run Probe Now | Runs connectivity probe against WHMCS and updates probe report/status. |
| Top Bar | Refresh | Reloads data for the current route. |
| Top Bar | Auto | When checked, refreshes the current route every 15 seconds. |
| Sites | Add Site | Creates a new site id and registry row for draft/published catalogs. |
| Sites | Refresh Sites | Reloads site list, status timestamps, and publish history. |
| Sites | Load Site | Loads selected site's draft into the editor. If missing, auto-pushes latest first. |
| Sites | Push Latest | Copies latest snapshot into the selected site's draft catalog. |
| Sites | Publish | Publishes selected site's current draft into its published catalog. |
| Draft Editor | Apply | Applies changed grid fields for a single product row into in-memory draft JSON. |
| Draft Editor | Apply All Grid Changes | Applies all modified product rows from grid controls to draft JSON. |
| Draft Editor | Apply All Pricing Changes | Applies all modified pricing rows/setup-fee controls to draft JSON. |
| Draft Editor | Apply All + Save Draft | Applies all grid changes, then persists draft to API in one step. |
| Draft Editor | Load Draft | Reloads draft from API, replacing unsaved in-memory edits. |
| Draft Editor | Save Draft | Saves current draft JSON to selected site draft storage. |
| Draft Editor | Publish Draft | Publishes selected site's draft from editor context. |
| Draft Editor | Show raw JSON editor | Toggles textarea view for direct JSON edits. |