Moxy

Kontekst

Moxy je zasnovan za organizacije s kompleksnimi e‑commerce operacijami: več prodajnih kanalov, skladišč, prevoznikov in compliance zahtev. Platforma poenoti vnos naročil, fulfillment, odpremo, dokumente in avtomatizacijo v enoten operativni sistem.

Problem

• Naročila prihajajo iz več platform z različnimi shemami.
• Fulfillment zahteva zanesljiva stanja, nalepke in tracking posodobitve.
• Compliance dokumenti morajo biti natančni in audit‑ready.
• Ročno delo ustvarja napake in upočasni throughput.
• Iskanje in preiskovanje po podatkih je počasno in razdrobljeno.

Težava ni v manjkajoči funkciji, temveč v pomanjkanju enotnega, determinističnega operativnega sloja.

Cilji projekta

• Centralizacija naročil z eksplicitnim upravljanjem stanj.
• Podpora multi‑store in multi‑warehouse inventory workflowom.
• Avtomatizacija nalepk in trackinga pri več prevoznikih.
• Compliance dokumenti in fiskalizacija (razširljivo).
• Event‑driven avtomatizacija za obvestila, dokumente in zalogo.
• Natural language iskanje po operativnih podatkih.
• Moderen UI za vsakodnevno operativno rabo.

Omejitve in izzivi

• Normalizacija več webhook payloadov.
• Stroga skladnost in integriteta dokumentov.
• Različni kurir API‑ji in statusni modeli.
• Visoke zahteve po zmogljivosti pod obremenitvijo.
• Avtomatizacija mora biti močna, varna in deterministična.

Pregled rešitve

Moxy združuje modern async backend, hiter React UI, event‑driven avtomatizacijo, logistične in compliance integracije ter semantično iskanje. Rezultat je enoten sistem, ki nadomesti razdrobljena orodja z audit‑ready operativnim jedrom.

Arhitektura in tehnični pristop

Core domain model

• Eksplicitni modeli za naročila, plačila, pošiljke, stranke, produkte in dokumente.
• Konfigurabilni statusni workflowi in lifecycle.
• Multi‑address podpora z validacijo in cachingom.

Store ingestion & webhooks

• Multi‑store podpora za WooCommerce, Shopify in custom vire.
• Varni endpointi z nastavljivimi metodami dostopa.
• Fleksibilne transformacije platformnih payloadov.

Shipping & kurirji

• Integracije za nalepke in tracking sinhronizacijo.
• Konsistentno mapiranje statusov znotraj sistema.
• Avtomatsko polling in sprožilci ob spremembah.

Compliance dokumenti

• Dokumentni pipeline za račune, dobropise, potrdila in dobavnice.
• Template sistem za branded PDF-je (HTML → PDF).
• Procesi zasnovani za strogo auditabilnost.

Automation macros

• Event‑driven makroji za email/SMS, zalogo, dokumente in webhooke.
• Deklarativna pravila s pogoji in taski za varno avtomatizacijo.

AI semantično iskanje

• Natural language iskanje po operativnih podatkih z embeddings.
• Vector search v PostgreSQL (pgvector) za hitro iskanje.

Tehnološki sklad

• 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. Zasnova domain modela glede na operativne tokove in compliance.
2. Multi‑store ingestion z varnostjo in transformacijami.
3. Kurir integracije in status mapping.
4. Dokumenti in compliance workflowi.
5. Makroji za avtomatizacijo na obsegu.
6. Semantično iskanje za hitro preiskovanje.
7. UI optimiziran za vsakodnevno delo.

Rezultati in učinek

• Enoten sistem nadomesti razdrobljena operativna orodja.
• Audit‑ready procesi s compliance vgrajenim v jedro.
• Hitrejši fulfillment z avtomatizirano logistiko.
• Manj ročnega dela zaradi makrojev in strukturiranih workflowov.
• Hitro preiskovanje in podpora prek semantičnega iskanja.

Refleksija

Moxy deluje, ker operacije obravnava kot produkt: eksplicitna stanja, deterministična avtomatizacija in dokumenti, pripravljeni za compliance. Platforma je zasnovana za rast – tehnično in operativno.

Povzetek

Moxy je enterprise platforma, ki poenoti multi‑store ingestion, logistiko, compliance dokumente, avtomatizacijo in AI iskanje v en, zanesljiv sistem.