Rabbinatix
Sign inGet started
Store

Chat and real-time messaging

FreeSystem map
@rabbinatix/realtime-chat-architecture by Rabbinatixupdated Oct 13, 2026

People message each other in conversations: messages are saved, pushed live over a socket gateway and sent as push notifications to whoever is away.

7 systems and 11 APIs. Every API is declared on both sides, so every contract starts healthy. Rename or change anything once it is on your map.

As the map's Connections view shows it: traffic flows from the system that calls to the system it calls.

9 connections · 11 APIs

  • Web Chat → Chat API
    • POST/api/v1/auth/registerCreate an account
    • POST/api/v1/auth/loginLog in with email and password
    • POST/api/v1/auth/logoutLog out
    • GET/api/v1/conversationsMy conversations
    • GET/api/v1/conversations/{id}/messagesMessages, a page at a time
    • POST/api/v1/conversations/{id}/messagesSend a message
  • Mobile App → Chat API
    • POST/api/v1/auth/registerCreate an account
    • POST/api/v1/auth/loginLog in with email and password
    • POST/api/v1/auth/logoutLog out
    • GET/api/v1/conversationsMy conversations
    • GET/api/v1/conversations/{id}/messagesMessages, a page at a time
    • POST/api/v1/conversations/{id}/messagesSend a message
  • Web Chat → Realtime Gateway
    • GET/wsOpen the live connection (a WebSocket)
  • Mobile App → Realtime Gateway
    • GET/wsOpen the live connection (a WebSocket)
  • Chat API → Message Bus
    • POST/topics/messages/publishAnnounce a new message
  • Realtime Gateway → Message Bus
    • GET/subscriptions/{name}/pullTake the next new messages
  • Push Worker → Message Bus
    • GET/subscriptions/{name}/pullTake the next new messages
  • Push Worker → Chat API
    • GET/internal/v1/conversations/{id}/offline-membersWho in a conversation is away
  • Push Worker → Push Service
    • POST/v1/messages:sendSend a phone notification

Systems (7)

Web Chat
Chat in the browser.
Mobile App
Chat on the phone.
Chat API
Conversations, members and message history.
Realtime Gateway
Keeps a live connection to every open app and fans out new messages.
Message Bus
Carries new messages to the gateway and the push worker.
Push Worker
Notifies people who are not online.
Push Service
Phone notifications, like Firebase Cloud Messaging or APNs.

A system you already have under the same name is used, not copied. Outside APIs don't count towards your plan.

Versions