OCOMX

Documentation

Everything a merchant (or a reviewer) needs in one place.

TutorialInstall → campaign → deposits → SUCCESS/MITIGATE → first PO. Live market evidenceNo credentials needed: real provider reads against public market data.Legacy deposit demoHistoric deposit-campaign UI. Its data endpoints require a signed storefront request, so it is not a live demo. FAQDeposits, refunds, data, voice agent, POS. ChangelogWhat shipped, newest first. Privacy PolicyEvery data flow, retention and deletion. Terms of ServiceRules of use, hedge rules, fees, liability.

How the engine works

OCOMX compiles demand validation into a six-node pipeline:

Node	What it does
`1 · Insight`	Paste product reviews (EN/CN) → TF-IDF cosine clustering extracts unmet-demand clusters, each with a design proposal and render prompt.
`2 · Render`	AIGC product renders with no prototypes (mock / ComfyUI / Ray providers).
`3 · Deposit`	Deposit block on the product page (theme app extension + App Proxy); buyers pay through your Shopify checkout.
`4 · Hedge`	Threshold reached → SUCCESS; timeout → MITIGATE (delist + full refunds). Persisted state machine, resumes after restart.
`5 · PO/BOM compile`	First purchase order sized at deposits × safety factor (default 1.75), MOQ and lead-time (+18 days) constraints applied.
`6 · M2H voice`	Twilio voice chasing for factory/buyer nodes; DRY-RUN when no numbers are configured.

Shopify integration notes

OAuth: install-time token exchange; redirect URI is pinned to https://ocomx.com/auth/callback.
Webhooks: orders/create (deposit ledger, idempotent by order id), app/uninstalled (token + record cleanup), products/update (product state sync).
App Proxy: signed storefront endpoints used by the deposit block.
Scopes: read/write products, read orders, plus the minimum needed for refunds and theme extension rendering.

Operations

Health: /api/health reports service, frontend contract and tunnel status; a supervised daemon restarts the service and pages an out-of-band alert channel on failure.
Persistence: atomic-write JSON storage with PostgreSQL as a drop-in upgrade path; Shopify tokens are encrypted at rest.
Deploys: gated by a release-readiness check with automatic backup and rollback.

Contact

Support and review communication: [email protected].