Una piattaforma ecommerce contro cui non devi combattere

Scegli una qualsiasi delle prime 10 piattaforme commerce SaaS e guarda la loro documentazione API. Poi guarda la loro UI admin. Le funzionalità non corrispondono. L'admin può fare cose che l'API non può. Peggio, il vendor della piattaforma lo sa — e considera questo una feature, non un bug. Bloccare capacità dietro l'admin è ciò che ti tiene sulla loro piattaforma. Nel momento in cui puoi fare tutto via API, puoi anche andartene.

Questa è la tensione fondamentale. Le grandi piattaforme SaaS (Shopify, BigCommerce, Wix Commerce) ottimizzano per merchant non tecnici perché sono la maggior parte del loro TAM. Quando gli sviluppatori chiedono un webhook su un evento specifico, un modo per registrare uno step di checkout custom, o accesso in scrittura a una risorsa prima read-only, la risposta è di solito «passa al tier enterprise» o «usa Zapier».

Axnify è costruita diversamente perché il suo backend è strutturato per esserlo. Ogni dominio è un microservizio (product, order, cart, theme, billing, asset, customer, payment, shipping, ecc.) con il proprio schema di database e la propria API HTTP. L'UI admin è un frontend che parla a queste API — esattamente come fa il tuo codice. Non esiste una capacità admin-only. Non esiste un «endpoint interno» che non puoi chiamare. La superficie API È la piattaforma.

Quella scelta di design ha conseguenze. Significa che Axnify è più onesta su cosa supporta e cosa no: se non è nell'API, non esiste. Significa che i breaking change vengono colti più velocemente — non puoi rilasciare una feature admin senza rilasciare anche l'API. E significa che tu, come sviluppatore che integra contro la piattaforma, non sei mai nella posizione di scrivere uno screen-scraper perché l'admin può fare qualcosa che il tuo codice non può.

L'architettura classica di una piattaforma ecommerce — Shopify, Magento, WooCommerce — è una singola codebase monolitica che gira contro un singolo database. Questo rende la piattaforma veloce da costruire all'inizio e facile da ragionare per shop piccoli. Significa anche che ogni feature condivide lo stesso runtime, lo stesso pool di connessioni al database e lo stesso ciclo di release. Quando il team della piattaforma rilascia una nuova feature, ogni merchant la ottiene (o il bug che ci viene con) lo stesso giorno.

Axnify prende l'approccio opposto. Ogni dominio commerce vive nel suo proprio microservizio Go. Il servizio product possiede prodotti, varianti, opzioni e inventario. Il servizio order possiede ordini, righe e fulfillment. Il servizio cart possiede i carrelli attivi. Il servizio asset possiede lo storage di file. Il servizio theme possiede temi, pagine, sezioni e blocchi. Ci sono più di 20 servizi così in totale, ognuno con il proprio schema PostgreSQL, la propria directory di migrazioni, i propri test, ognuno deployabile indipendentemente.

I servizi comunicano via HTTP usando autenticazione con chiave interna per chiamate service-to-service e JWT/X-Tenant-ID per chiamate originate da end-user. Le preoccupazioni condivise (auth, risoluzione tenant, rate limiting, logging, metrics, error tracking) vivono in un package middleware condiviso che ogni servizio importa. PostgreSQL è condiviso ma gli schemi sono isolati; un servizio può fare JOIN contro le tabelle di un altro via view, ma le scritture passano per l'API del servizio proprietario.

Per te come sviluppatore che integra contro la piattaforma, questa architettura ha implicazioni pratiche. Le API sono stabili per servizio: l'API product evolve al proprio ritmo, l'API order al suo. I webhook vengono dal servizio che possiede l'evento, con metadati ricchi su quale servizio ha emesso cosa. Le performance sono limitate per dominio: una query di report lenta nel servizio analytics non può bloccare la tua chiamata order-create. E il debugging è più facile perché ogni request porta un request ID loggato attraverso ogni servizio che tocca.