IPERAMUNA.COM

Case Studies

Explore real-world examples of our technical expertise and successful project deliveries.

SLPA CMS 2.0: Architecting a National-Scale Maritime Logistics Ecosystem

Executive Summary: The Digital Backbone of Sri Lanka Port Authority

As the lead architect of the Sri Lanka Port Authorities Cargo Management System (CMS 2.0) since 2018, I have overseen the digitisation of the nation's local cargo operations. This platform serves as a mission-critical bridge between 2,500+ professional users, Sri Lanka Customs, the Navis N4 terminal operating system, and the Lanka Pay payment aggregator.

In 2025 alone, the system successfully managed the processing of $169,880,935.00 in revenue through 1,323,437 paid invoices, tracking the movement of over 3.9 million containers.

1. Architectural Philosophy: The Modern Monolith

While the industry often moves toward micro-services by default, CMS 2.0 proves that a well-structured monolith, when paired with high-performance execution runtimes, offers superior reliability and reduced operational complexity for national infrastructure.

The Stack

  • Backend: Modern Laravel (evolved from version 8 in 2018 to version 12 in 2026).
  • Frontend: Decoupled Angular application utilizing Lazy Loading for highly optimized, modular user experiences.
  • Runtime: FrankenPHP (Classic Mode) with Caddy, running on statically built binaries.
  • Persistence: Active-Passive MySQL cluster with dedicated Read Replicas.
  • Caching: Hypercacheio, a custom-built solution optimized for high-read cargo lookup patterns.

Strategic Polyglot Optimization

To handle heavy-lift, long-running Excel report generation for port audits, I implemented a specialized Go-lang microservice compiled to a single binary. This allows the core Laravel API to remain responsive while offloading CPU-intensive tasks to a language designed for high-concurrency data processing.

2. Infrastructure & Zero-Downtime Engineering

Operating on-premise at SLPA Data Centers required a customized approach to high availability and deployment.

High Availability (HA)

  • Active-Active App Servers: Ensuring constant availability even during server maintenance.
  • Disaster Recovery (DR): A dedicated DR site with real-time replication to protect national trade data.
  • Linux System Units: Robust lifecycle management for both FrankenPHP binaries and background Queue Workers.

Deployment Strategy

We utilize a Blue-Green deployment mechanism via Nginx upstream switching. This custom-built CI/CD pipeline ensures that updates to the core logistics engine never result in a single minute of downtime—critical for a 24/7 port operation.

3. Integration Ecosystem: orchestrating National Logistics

The system acts as a central hub, synchronizing data across disparate national platforms to eliminate manual bottlenecks.

  • Navis N4 integration: Real-time container lifecycle tracking and terminal status updates.
  • Sri Lanka Customs: Automated capturing of 566,862 E-Manifests and 1,641,406 E-releases, significantly reducing cargo clearing times.
  • Fintech Integration: Real-time payment verification for 1.3M+ annual invoices via the Lanka Pay aggregator.

4. Impact and Performance Metrics (2025)

The system’s architectural maturity is validated by its massive annual throughput:

Metric 2025 Performance Data
Total Revenue Handled $169,880,935.00
Paid Invoices processed 1,323,437
Import FCL Containers 2,162,509
Export Containers 1,761,115
E-releases Captured 1,641,406
Professional Users 2,576+

5. Evolution: Zero Technical Debt

A cornerstone of my architectural leadership has been the continuous modernization of the codebase. By maintaining a strict "Zero Tech Debt" policy, we have successfully migrated through five major Laravel versions (v8 to v12) without major rewrites, ensuring the system remains as modern today as it was at its inception.

Authored by Indunil Peramuna, Lead Architect