Overview
NexLog OS runs on Fastify (API), MongoDB (canonical persistence) and Angular (operations panel). It is multi-tenant, with tenants and granular roles, and event-driven: every operation generates businessEvents with correlationId and causationId, recorded in the eventLedger.
On top of this core sit the unified MDM, attribute-based authorization (ABAC), Zero Trust architecture, observability and the specialized interfaces, all headless on the same API.
Technical stack
| Component | Role | Description |
|---|---|---|
| Fastify | API | High-performance Node.js framework: low per-request overhead, typed plugins and robust hooks. |
| MongoDB | Canonical persistence | camelCase collections, per-tenant indexes and typed aggregations; TTL for businessEvents and a multi-region replica set. |
| Angular | Operations panel | Unified Planning Console, with modules for WMS, TMS, OMS, YMS and Control Tower. |
| Event-driven | Core | businessEvents with correlationId and causationId; central eventLedger, replay, auditing and asynchronous integration. |
| Unified MDM | Master data | Product, Party, Asset, Location and Document Master shared, with no duplication between modules. |
| ABAC and Zero Trust | Security | Attribute-based authorization, federated identity and no trusted perimeter: every request is validated independently. |
Multi-tenancy and roles
Each customer is an isolated tenant (tenants) on the platform. Roles are values of the roles enum, in UPPER_SNAKE_CASE.
| Role | Scope | Typical use |
|---|---|---|
SUPER_ADMIN | Platform | CCX engineering, not visible to the customer. |
TENANT_OWNER | Tenant | Executive who owns the account; full control over the tenant. |
TENANT_ADMIN | Tenant | Administration of users, plans and integrations. |
MANAGER | Module | Operations manager: approval of exceptions and playbooks. |
OPERATOR | Module | WMS, TMS or YMS operator: task execution. |
VIEWER | Read | Read-only: analysts and auditors. |
Plans
From FREE to ENTERPRISE, plans define how many warehouses and which modules the tenant uses.
| Plan | Audience | Limits |
|---|---|---|
FREE | Trial and sandbox | 1 tenant, 1 warehouse, low volume. |
STARTER | E-commerce SMBs | 1 warehouse, essential modules (WMS and OMS). |
PRO | Mid-market | Multiple warehouses; WMS, TMS, OMS and YMS. |
ENTERPRISE | Large operations | Internal multi-tenancy and all modules. |
Event-driven core
businessEvents
Every state transition and every relevant operation is a typed canonical event. Names follow the dot.namespace pattern, for example orders.transition.approved.
correlationId and causationId
They track the full causal chain between events: order, wave, movement, shipping and invoice.
eventLedger
Immutable central ledger; the basis for auditing, replay, analytics and AI training.
Unified MDM
Product Master, Party Master, Asset Master, Location Master and Document Master, shared by all modules.
Security and continuity
ABAC
Attribute-based authorization: tenant, role, resource and context, granular enough to evaluate each request.
Zero Trust
No trusted perimeter: every call is authenticated, authorized and logged.
Fraud signals
Fraud signals built into orders, claims and billing, scored in real time.
Disaster recovery
Measurable RPO and RTO objectives, multi-region replication and continuous backup.
Observability
Structured logs, metrics, distributed tracing and per-tenant dashboards.
Specialized interfaces
Headless by design: all interfaces consume the same API.
| Interface | Description |
|---|---|
| App NexLog Driver | Mobile app for drivers: digital POD, tracking, geolocation and OCR. |
| Kiosk Portaria | Self-service gate check-in, with optional biometrics and a built-in LGPD consent form. |
| Planning Console | Unified Angular app for WMS, TMS, OMS, YMS and Control Tower. |
| Portal B2B/B2C | Dedicated customer portals: tracking, self-service and documents. |
API conventions
Contract conventions that apply to every module.
| Artifact | Convention | Example |
|---|---|---|
| REST endpoints | kebab-case | /api/v1/trade-declarations |
| Versioning | In the path | /api/v1/ |
| MongoDB collections | camelCase, plural | tradeDeclarations, carbonEntries |
| TS classes and interfaces | PascalCase, singular | TradeDeclaration, CarbonEntry |
| Enums | UPPER_SNAKE_CASE | INBOUND, DRY, SUPER_ADMIN |
| Events | dot.namespace | orders.transition.approved |
Why Fastify, MongoDB and Angular
Fastify for a high-performance API
Supply chain operations generate a high volume of requests: picking events, movements, tracking checkpoints and telemetry. Fastify delivers low overhead, typed validation through JSON Schema and robust hooks for observability.
CCX has a track record with Node.js in production, and Fastify lets NexLog OS scale horizontally without rewriting layers.
MongoDB as the canonical core
Supply chain is a domain whose schemas evolve fast: new SKU fields, new route attributes, new shipment metadata. With camelCase collections, MongoDB lets schemas evolve without downtime, runs complex aggregations for Control Tower without a separate DW and scales horizontally by tenant.
Compound indexes on tenantId and business keys support multi-tenancy, and automatic TTL handles retention of the event history.
Angular for the operations panel
The Planning Console is an Angular app, chosen for its strong typing, modular architecture, mature tooling for complex forms (WMS, TMS, playbook configuration) and components reusable across modules.
The specialized interfaces (App NexLog Driver, Kiosk Portaria, Portal B2B/B2C) are headless on the same API, following MACH principles.