Skip to content

C4 Model — Level 3: Component

Microservice Ecosystem Overview

High-level view of all five services and their inter-service communication (Internal HTTP + BullMQ events). For detailed internals, see the per-service diagrams below.

uml diagram

API Gateway (Port 3000)

Authentication, request proxying, WebSocket gateway, health aggregation, rate limiting, observability.

uml diagram

Order Service (Port 3001)

Core domain service: Shopify integration (OAuth, webhooks, catalog), order lifecycle, print jobs, SimplyPrint, shipments, Sendcloud, orchestration, fulfillment, cancellation, inventory tracking, stock replenishment, users, analytics, event/audit logs, notifications.

uml diagram

Print job management, SimplyPrint integration (webhooks, files, reconciliation), product mappings, parts library.

uml diagram

Shipping Service (Port 3003)

Shipment management, Sendcloud integration (labels, webhooks, reconciliation), retry queue, order data adapter.

uml diagram

GridFlock Service (Port 3004)

Parametric baseplate generation (JSCAD), full pipeline orchestration (STL → slice → SimplyPrint upload → product mapping), BullMQ job processing, plate-level preview cache with dynamic border assembly.

uml diagram

Web Application (React 19 PWA)

Progressive Web App: dashboard with analytics, order management with shipping, product mappings, activity/audit logs, admin user management, integrations settings, push notifications, offline support.

uml diagram

Sources