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.
9 connections · 11 APIs
- Web Chat → Chat API
POST /api/v1/auth/registerCreate an accountPOST /api/v1/auth/loginLog in with email and passwordPOST /api/v1/auth/logoutLog outGET /api/v1/conversationsMy conversationsGET /api/v1/conversations/{id}/messagesMessages, a page at a timePOST /api/v1/conversations/{id}/messagesSend a message
- Mobile App → Chat API
POST /api/v1/auth/registerCreate an accountPOST /api/v1/auth/loginLog in with email and passwordPOST /api/v1/auth/logoutLog outGET /api/v1/conversationsMy conversationsGET /api/v1/conversations/{id}/messagesMessages, a page at a timePOST /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.
Also as a flow
Versions
