Skip to content

Flexli mSort — Distribution Management Server

One codebase. One signed artifact. Tenant-aware activation at deploy time.

The Flexli Distribution Management Server (DMS) is the software core of the mSort warehouse automation platform — it receives barcode scans from conveyor belt scanners, looks up routing decisions from Flexli's partner APIs, and drives physical sort bins, bots, and infeed conveyors in real time.

Start in 30 seconds

docker compose up -d --build
make docker-smoke
Open http://localhost:5269/swagger

bash scripts/dev-setup-macos.sh
Open http://localhost:5269/swagger

Open folder in VS Code → "Reopen in Container" → press F5

What's in this documentation

  • Getting Started

    New to the project? Start here. Prerequisites, one-command setup, and the daily workflow.

    Getting Started

  • Architecture

    System diagram, database schema, two-layer Core + Meesho architecture, and API contracts.

    Architecture

  • Developer Guide

    Branching model, Makefile reference, EF migrations, environment variables, and troubleshooting.

    Developer Guide

  • Runbooks

    Rollback procedure, incident response, and on-call playbooks. Read these before you need them.

    Runbooks

  • RFCs

    Engineering proposals. The canonical decisions that shape how this platform is built and shipped.

    RFCs

  • ADRs

    Architecture Decision Records. Lightweight records of why we chose what we chose.

    ADRs

Three services, always running

Service Port URL Purpose
ASP.NET Core Backend 5269 http://localhost:5269 REST API + Swagger UI
Mock Partner API 5000 http://localhost:5000 Simulates Meesho logistics API
PostgreSQL 16 5432 localhost:5432/dms-layered Primary database

RFC FLX-ENG-RFC-001 — Where we are heading

This platform is in the process of adopting trunk-based branching, signed immutable OCI artifacts, per-tenant signed manifests, and OpenTelemetry observability. See FLX-ENG-RFC-001 for the full engineering proposal and ADR-0001 for the branching decision.