External Services and Background Workers

External Services and Background Workers

External Services and Background Workers

NMS Prime is a modular Laravel monolith, not a microservice framework. It integrates with separate infrastructure services through explicit adapters, jobs, and system services.

Patterns

  • Queued jobs for retryable/long-running work

  • Laravel scheduler for recurring commands

  • Reverb for realtime events

  • Module services for vendor/external APIs

  • Systemd/Supervisor for installed workers and optional services

  • Workflow/n8n as an optional external orchestration component

Guidelines

  • Keep endpoints and credentials in configuration

  • Define timeouts, retries, idempotency, and error handling

  • Test contracts with fixtures/fakes

  • Do not put customer-specific integration logic into shared platform bases