/
Platform Architecture

Platform Architecture

Platform Architecture

This section explains the architecture of the NMS Prime platform and the shared foundations used by all applications.

Refreshed as part of Developer Documentation Chunk 1 against the dev-next codebase. Domain-specific implementation notes belong under Application Internals.

Start here

  1. Orchestration Layer — platform overview and base package role

  2. Architecture Guidelines — design principles for contributors

  3. Directory Structure — repository layout

  4. Database — PostgreSQL-first data access and migrations

Topics in this section

  • Orchestration Layer

  • Architecture Guidelines

  • Directory Structure

  • Database and migrations

  • Address mapping

  • Clustering and failover architecture

Architectural snapshot

NMS Prime is a modular Laravel monolith:

  • Core application code lives under app/, database/, resources/, and routes/

  • Domain applications live under modules/<Module>/ and are managed with nwidart/laravel-modules

  • Shared CRUD behavior is provided by BaseModel, BaseController, BaseViewController, BaseRoute, and BaseMigration

  • New interactive UI is Livewire-first; the admin shell still uses Vue 3 components and Bootstrap 4 surfaces

  • Primary runtime database is PostgreSQL; additional named connections exist for CCC and selected integrations