- Core Architecture: Unlimited-Depth Hierarchy
The platform is built on a highly scalable multi-tenant architecture designed to model complex logistics networks. It uses a recursive Directed Acyclic Graph (DAG), enabling unlimited hierarchical levels from Master entities to national distributors, regional agents, and local merchants.Each node operates within a strictly isolated subtree, ensuring complete data privacy. Users can only access and manage data within their own hierarchy, with no visibility into sibling or parent nodes.
- Financial Engine: Chain Accounting & Cost Hiding
The system acts as a financial clearinghouse using a Bring Your Own Contract (BYOC) model. Parent nodes assign carrier contracts (e.g., BRT, Poste Italiane) to child nodes with marked-up pricing, while all cost calculations remain server-side to ensure complete cost hiding.
When a shipment is created, the system automatically generates a cascade of ledger entries across all hierarchy levels, capturing profit margins at each stage. At the end of the day, transactions are aggregated and settled by debiting child wallets and crediting parent nodes, fully automating financial reconciliation.
- Execution Engine: E-Commerce & Carrier Connectivity
The platform connects e-commerce systems with logistics providers in a scalable and resilient manner. Leaf nodes can integrate platforms like Shopify or Amazon for automatic order import.
High-volume operations are handled through asynchronous batch processing, enabling thousands of shipments to be processed within minutes. Built-in resilience mechanisms, such as circuit breakers, ensure uninterrupted operations by switching to alternative carriers when needed.
Once shipment labels are generated, tracking data is automatically pushed back to connected platforms and shared across the network via secure webhooks, ensuring real-time visibility.
- AI Commander (Prompt-Based Navigation Layer) – Key Differentiator
The AI Commander is the core innovation of the platform, transforming how users interact with the system. It introduces a multilingual conversational interface that eliminates manual navigation and form filling.
Through a chat-style widget in the Flutter frontend, users can issue natural language commands in English, Italian, Urdu, or Roman Urdu. These commands are processed by a FastAPI backend integrated with Large Language Models (Qwen3-Coder, with fallbacks such as NVIDIA Nemotron and Google Gemma for reliability).
The AI operates within a structured JSON schema (`myappschema.json`) that defines all application screens and required inputs. Using tool-calling, it generates deterministic JSON commands, ensuring accurate and safe execution.
For example, a command like “Create shipment from Mario Milano to Luigi Napoli 2kg” automatically navigates to the correct screen and pre-fills all required fieldsreducing a multi-step process to a single prompt. This significantly enhances usability, minimizes errors, and boosts operational efficiency.
Summary
This system is a scalable, multi-level logistics and financial platform connecting e-commerce businesses with carriers. Its key differentiator is the AI Commander, which enables full system control through a multilingual conversational interface, automating complex workflows and dramatically improving user experience.