Skip to content
Asmar.
§ CS-05 — Ghasi SMS Gateway

Ghasi SMS Gateway

Specs complete · pre-build

Lightweight SMS messaging gateway. Bounded-context companion to the Ghasi suite — one job, done well, integrable from anywhere in the platform.

Period
2025 — present
Domain
Communications Infrastructure
Stack
  • NestJS
  • Postgres
  • Provider adapters
  • Outbox
The brief

Most platforms accumulate three or four bespoke SMS integrations — one for OTPs, one for marketing, one for transactional alerts. Each carries its own retry semantics, rate-limit handling, and provider failover.

The Gateway consolidates them: a single send port, multiple provider adapters behind it, queue-backed retries, and idempotency keys at the edge.

Architecture at a glance

Anonymized to remove proprietary details. The pattern is real; the specifics aren't the part that matters here. Hover any layer label for context.

Decisions & tradeoffs
  1. 01

    Provider adapters behind a single SendPort.

    CostAn adapter to write per provider.

    WinSwitching providers is a config change, not a code change.

  2. 02

    Idempotency keys mandatory at the edge.

    CostClients must send a key.

    WinRetries are safe; double-sends are structurally impossible.

Outcome & scope
  • Specs: 60 epics, 156 features, 193 user stories.
  • Designed to drop into any of the Ghasi platforms as a shared utility service.
  • Implementation phase pending.
My role

Founder, lead architect, spec author.

What I'd do differently

Implementation phase pending; will publish a fuller case study post-V1.

← All case studies

Designing something similar?

Explore other work

CS-01

Ghasi AI Intake OS

Domain-agnostic, multi-tenant, AI-first intake operating system for government and regulated industries. One engine, two surfaces, many domain packs.

GovTech / Regulated B2B + B2C

CS-02

Ghasi eHealth

Enterprise eHealth platform — clinical, diagnostics, pharmacy, imaging, RCM, patient engagement. FHIR R4-first, multi-tenant, event-backed. Designed for national-scale rollout.

Healthcare / Public Sector

CS-03

Ghasi edTech

Multi-tenant, multilingual (LTR + RTL), AI-first, offline-first learning platform: marketplace + LMS + authoring suite + compliance engine. 18 bounded contexts. SCORM/xAPI. WebGPU local inference.

EdTech / Compliance

CS-04

Ghasi Melmastoon

Multi-tenant property management system for hospitality. 21 services planned, sharing a common pattern with the rest of the Ghasi suite — same DDD posture, same outbox discipline, different domain.

Hospitality / PMS

CS-07

Microservices → BFF Decomposition

Decomposing a 15-service distributed estate plus three databases on on-prem infrastructure into a Backend-for-Frontend architecture — one BFF per experience, talking to a shared data platform and shared services behind a single identity provider.

FinTech / Wealth Management

CS-08

User Manuals & Training Portal

A secured, searchable, filterable user manual and training portal — leveraging GCP Cloud Storage for content, Articulate Rise 360 for training modules, SharePoint lists for metadata, a .NET API in front, and a React frontend over a protected sub-domain.

FinTech / Wealth Management