Moxy

Kontekst

Moxy je dizajniran za organizacije s kompleksnim e‑commerce operacijama: više prodajnih kanala, skladišta, prijevoznika i compliance zahtjeva. Platforma objedinjuje unos narudžbi, fulfillment, otpremu, dokumente i automatizaciju u jedinstven operativni sustav.

Problem

• Narudžbe dolaze s više platformi s različitim shemama.
• Fulfillment zahtijeva pouzdana stanja, naljepnice i ažuriranja trackinga.
• Compliance dokumenti moraju biti natančni i audit‑ready.
• Ročno delo stvara napake i upočasni throughput.
• Pretraživanje i istraživanje podataka je sporo i rascjepkano.

Problem nije u nedostajućoj funkciji, nego u nedostatku jedinstvenog, determinističkog operativnog sloja.

Ciljevi projekta

• Centralizacija narudžbi s eksplicitnim upravljanjem stanja.
• Podrška multi‑store i multi‑warehouse inventory workflowima.
• Automatizacija naljepnica i trackinga kod više prijevoznika.
• Compliance dokumenti i fiskalizacija (proširivo).
• Event‑driven automatizacija za obavijesti, dokumente i zalihe.
• Natural language pretraživanje po operativnim podatcima.
• Moderan UI za svakodnevnu operativnu upotrebu.

Ograničenja i izazovi

• Normalizacija više webhook payloada.
• Stroga usklađenost i integritet dokumenata.
• Različni kurir API‑ji i statusni modeli.
• Visoki zahtjevi za performanse pod opterećenjem.
• Automatizacija mora biti močna, varna i deterministična.

Pregled rješenja

Moxy spaja moderan async backend, brz React UI, event‑driven automatizaciju, logističke i compliance integracije te semantičko pretraživanje. Rezultat je jedinstven sustav koji zamjenjuje rascjepkane alate audit‑ready operativnom jezgrom.

Arhitektura i tehnički pristup

Core domain model

• Eksplicitni modeli za narudžbe, plaćanja, pošiljke, stranke, produkte i dokumente.
• Konfigurabilni statusni workflowi i lifecycle.
• Multi‑address podrška s validacijom i cachingom.

Store ingestion & webhooks

• Multi‑store podrška za WooCommerce, Shopify i custom izvore.
• Sigurni endpointi s podesivim metodama pristupa.
• Fleksibilne transformacije platformnih payloadov.

Shipping & kuriri

• Integracije za naljepnice i sinkronizaciju trackinga.
• Konzistentno mapiranje statusa unutar sustava.
• Automatski polling i okidači kod promjena.

Compliance dokumenti

• Dokumentni pipeline za račune, dobropise, potrdila i dobavnice.
• Template sustav za brendirane PDF-ove (HTML → PDF).
• Procesi zasnovani za strogo auditabilnost.

Automation macros

• Event‑driven makroi za email/SMS, zalihe, dokumente i webhooke.
• Deklarativna pravila s uvjetima i zadacima za sigurnu automatizaciju.

AI semantično pretraživanje

• Natural language pretraživanje po operativnim podatcima s embeddingsima.
• Vector search u PostgreSQL (pgvector) za brzo pretraživanje.

Tehnološki stack

• Backend: Litestar 2 (Python), async SQLAlchemy
• Baza: PostgreSQL + pgvector
• Frontend: Vite + React + TypeScript, Tailwind, Radix UI
• Background jobs: SAQ (PostgreSQL queue)
• Logging & observability: structlog, Sentry
• Docs & templates: Jinja2, WeasyPrint

Proces implementacije

1. Dizajn domain modela prema operativnim tokovima i complianceu.
2. Multi‑store ingestion sa sigurnošću i transformacijama.
3. Kurir integracije i status mapping.
4. Dokumenti i compliance workflowi.
5. Makroi za automatizaciju na opsegu.
6. Semantičko pretraživanje za brzo istraživanje.
7. UI optimiziran za svakodnevni rad.

Rezultati i učinak

• Jedinstven sustav zamjenjuje rascjepkane operativne alate.
• Audit‑ready procesi s complianceom ugrađenim u jezgru.
• Brži fulfillment uz automatiziranu logistiku.
• Manje ručnog rada zahvaljujući makroima i strukturiranim workflowima.
• Brzo pretraživanje i podrška kroz semantičko pretraživanje.

Refleksija

Moxy funkcionira jer operacije tretira kao produkt: eksplicitna stanja, deterministična automatizacija i dokumenti spremni za compliance. Platforma je dizajnirana za rast – tehnički i operativno.

Sažetak

Moxy je enterprise platforma koja objedinjuje multi‑store ingestion, logistiku, compliance dokumente, automatizaciju i AI pretraživanje u jedan pouzdan sustav.