Moxy

Contexte

Moxy est conçu pour les organisations gérant des opérations e-commerce complexes : canaux de vente multiples, entrepôts, transporteurs et exigences strictes de conformité. La plateforme unifie l'ingestion, l'exécution, l'expédition, la facturation et l'automatisation dans un système opérationnel unique.

Problématique

• Les commandes arrivent de multiples plateformes avec des schémas incohérents.
• L'exécution nécessite un contrôle fiable des statuts, des étiquettes et des mises à jour de suivi.
• Les documents de conformité doivent être exacts et auditables.
• Le travail manuel crée des erreurs et ralentit le débit.
• La recherche et l'investigation dans de grands ensembles de données deviennent lentes et fragmentées.

Le véritable problème est l'absence d'une couche opérationnelle unifiée et déterministe.

Objectifs du projet

• Centraliser toutes les commandes avec un contrôle explicite des statuts.
• Prendre en charge les workflows d'inventaire multi-magasins et multi-entrepôts.
• Automatiser les étiquettes d'expédition et le suivi auprès des transporteurs.
• Fournir une facturation et une fiscalisation conformes (extensible).
• Activer l'automatisation pilotée par événements pour les notifications, documents et inventaire.
• Offrir une recherche en langage naturel sur toutes les données opérationnelles.
• Fournir une interface utilisateur moderne optimisée pour une utilisation quotidienne intensive.

Contraintes et défis

• Normalisation de multiples charges utiles de webhooks.
• Exigences strictes de conformité et d'intégrité des documents.
• APIs de transporteurs avec des formats et modèles de statut variables.
• Attentes de performance élevées sous charge opérationnelle.
• L'automatisation doit être puissante, sûre et déterministe.

Aperçu de la solution

Moxy combine un backend asynchrone moderne, une interface React rapide, une automatisation pilotée par événements, des intégrations natives de logistique et de conformité, ainsi qu'une recherche sémantique. Le résultat est un système unique qui remplace des outils fragmentés par un noyau opérationnel cohérent et prêt pour l'audit.

Architecture et approche technique

Modèle de domaine central

• Modèles explicites pour les commandes, paiements, expéditions, clients, produits et documents.
• Workflows de statut configurables et gestion du cycle de vie.
• Support multi-adresses avec validation et mise en cache.

Ingestion de magasins et webhooks

• Support multi-magasins pour WooCommerce, Shopify et sources personnalisées.
• Points d'accès sécurisés avec méthodes d'accès configurables.
• Transformations flexibles pour les charges utiles spécifiques aux plateformes.

Expédition et transporteurs

• Intégrations de transporteurs pour la génération d'étiquettes et la synchronisation du suivi.
• Mapping interne cohérent entre les modèles de statut des transporteurs.
• Interrogation automatisée et déclencheurs d'événements lors des changements de suivi.

Documents de conformité

• Pipeline de documents pour factures, avoirs, reçus et bons de livraison.
• Système de templates pour PDF de marque (HTML → PDF).
• Workflows de conformité conçus pour une auditabilité stricte.

Macros d'automatisation

• Macros pilotées par événements pour email/SMS, inventaire, documents et webhooks.
• Règles déclaratives avec conditions et tâches pour une automatisation sûre.

Recherche sémantique IA

• Recherche en langage naturel dans les données opérationnelles utilisant des embeddings.
• Recherche vectorielle dans PostgreSQL (pgvector) pour une récupération rapide.

Stack technologique

• Backend : Litestar 2 (Python), async SQLAlchemy
• Base de données : PostgreSQL + pgvector
• Frontend : Vite + React + TypeScript, Tailwind, Radix UI
• Tâches en arrière-plan : SAQ (file d'attente basée sur PostgreSQL)
• Logging et observabilité : structlog, Sentry
• Documents et templates : Jinja2, WeasyPrint

Processus de mise en œuvre

1. Conception du modèle de domaine autour des workflows opérationnels et de la conformité.
2. Construction d'une ingestion multi-magasins sécurisée avec transformations.
3. Implémentation des intégrations de transporteurs et mapping des statuts.
4. Développement de la génération de documents et workflows de conformité.
5. Ajout de macros pour l'automatisation à grande échelle.
6. Implémentation de la recherche sémantique pour une investigation rapide.
7. Livraison d'une interface opérationnelle optimisée pour un usage quotidien.

Résultats et impact

• Un système unique remplace les outils opérationnels fragmentés.
• Workflows prêts pour l'audit avec conformité intégrée.
• Exécution plus rapide grâce aux intégrations logistiques automatisées.
• Réduction du travail manuel via macros et workflows structurés.
• Investigation à haute vitesse via la recherche sémantique.

Réflexion

Moxy fonctionne parce qu'il traite les opérations comme un produit de première classe : modélisation explicite des états, automatisation déterministe et documents conformes. La plateforme est conçue pour évoluer à la fois techniquement et opérationnellement.

Résumé

Moxy est une plateforme d'opérations de niveau entreprise qui unifie l'ingestion multi-magasins, la logistique des transporteurs, les documents de conformité, l'automatisation et la recherche IA dans un système unique et fiable.