Message System Module

1. Conceptual Overview
 

The Message System is a centralized communication engine that enables seamless interaction between customers, internal team members, groups, and system modules. It is designed to handle high-volume messaging, real-time notifications, and multi-source message ingestion (email, internal chat, client portals) within a single unified experience.
 

This system is not just an inbox — it is a cross-module communication layer that connects:
 

  • Customers and administrators

  • Team members and project collaborators

  • Tasks, missions, projects, and articles

  • Email channels and in-app messaging

  • Real-time sockets and persistent storage
     

Every message is tracked, categorized, permission-controlled, and visually surfaced across the application.
 


2. Visual Entry Point & User Experience
 

The Message System is accessed primarily through the envelope icon located in the top navigation bar. This icon acts as the global message indicator and remains visible across all pages.
 

Visual Behavior
 

  • Displays a live unread message counter

  • Changes color/state when unread messages exist

  • Opens an interactive dropdown on click

  • Updates instantly without page reload
     

This ensures users never miss incoming communication, regardless of which module they are currently working in.
 


3. Message Dropdown – Instant Awareness Layer
 

Clicking the envelope icon opens a message preview dropdown, which serves as an attention layer rather than a full inbox.
 

What the Dropdown Shows
 

  • Most recent unread messages

  • Sender identity (customer or user)

  • Short message preview

  • Timestamp context

  • Quick navigation links
     

Smart Controls
 

  • “Mark all as read” action

  • Individual message dismiss controls

  • Auto-scroll for long lists

  • Permission-based visibility
     

This design allows users to scan, decide, and act in seconds.
 


4. Message Types & Communication Channels
 

The system supports multiple message categories, each optimized for a different communication scenario.
 

Client Messages
 

These messages originate from customers through email, contact forms, or client portals. They are treated as incoming business communication and stored persistently for auditing and follow-up.
 

Internal Team Messages
 

Internal messages enable real-time collaboration between staff members. These messages support:
 

  • Task-based discussion

  • Mission-specific chat

  • Project collaboration

  • File and note sharing
     

Group Messages
 

Messages sent to predefined user groups. Used for:
 

  • Announcements

  • Operational alerts

  • Department-wide communication
     

Article & Contextual Messages
 

Messages linked directly to articles, records, or system objects, ensuring conversation remains tied to context.
 


5. Dual Storage Architecture (MySQL + MongoDB)
 

The Message System uses a hybrid persistence model to balance reliability and speed.
 

Relational Storage (MySQL)
 

Used for:
 

  • Client messages

  • Email-based communication

  • Auditable records

  • Reporting and filtering
     

This guarantees data integrity, traceability, and long-term storage.
 

Document Storage (MongoDB)
 

Used for:
 

  • Internal real-time chats

  • Group conversations

  • Mission and project discussions
     

This enables:
 

  • High-frequency message writes

  • Fast retrieval

  • Scalable conversation threads
     


6. Message Creation Lifecycle
 

Every message follows a predictable lifecycle:
 

  1. Message is created (email, chat, client input)

  2. Stored in appropriate data store

  3. Linked to user, customer, or context

  4. Notification event is triggered

  5. Real-time socket emits update

  6. UI updates unread count instantly

  7. Message appears in dropdown and inbox
     

This guarantees zero message loss and instant visibility.
 


7. Read, Unread & Attention Management
 

The system carefully tracks message attention state.
 

Read Logic
 

  • Messages are unread by default

  • Marked read when opened or dismissed

  • Bulk “mark all read” supported

  • Read status persists across sessions
     

Why This Matters
 

  • Prevents missed messages

  • Enables accurate notification counts

  • Supports reporting and accountability

  • Improves workflow efficiency
     


8. Real-Time Socket Integration
 

The Message System integrates with WebSocket services to deliver real-time updates.
 

When a New Message Arrives
 

  • Notification sound plays (configurable)

  • Unread badge count updates

  • Dropdown list refreshes instantly

  • Optional auto-open behavior triggers
     

All of this happens without page refresh, creating a modern chat-like experience.
 


9. Permissions & Notification Controls
 

Message visibility and notifications are fully role-controlled.
 

Administrators can define:
 

  • Who receives client message alerts

  • Who receives group notifications

  • Who receives article-related messages

  • Whether auto-popup notifications appear
     

This prevents noise while ensuring critical messages reach the right users.
 


10. Message Pages & Deep Integration
 

Beyond the dropdown, messages are deeply integrated into:
 

Dedicated Message Pages
 

  • Full inbox view

  • Search and filtering

  • Threaded conversation display

  • Reply and forward actions
     

Customer Profiles
 

  • Message history per customer

  • Contextual replies

  • Relationship tracking
     

Projects, Tasks & Missions
 

  • Embedded discussion threads

  • Context-aware messaging

  • Team collaboration
     


11. Email & External Channel Integration
 

The system seamlessly bridges email and in-app messaging.
 

Incoming Emails
 

  • Converted into messages automatically

  • Attachments preserved

  • HTML content stored

  • Original email archived
     

Outgoing Emails
 

  • Logged as messages

  • Linked to customer records

  • Trackable and auditable
     

This creates a single communication history, regardless of channel.
 


12. Message Threads & Context Preservation
 

Messages support parent-child relationships, enabling threaded conversations.
 

Benefits:
 

  • Clear conversation flow

  • Easier follow-ups

  • Context never lost

  • Improved customer experience
     

Threads ensure long conversations remain organized and readable.
 


13. System Stability & Scalability
 

The Message System is built for:
 

  • High message volumes

  • Multi-user organizations

  • Real-time collaboration

  • Long-term data retention
     

Its modular architecture allows new message types, channels, and integrations to be added without disrupting existing workflows.
 


14. Final Conceptual Summary
 

The Message System is a full-scale communication hub that:
 

  • Unifies client, internal, and system messages

  • Combines real-time speed with reliable storage

  • Integrates deeply with customers, projects, and tasks

  • Provides fine-grained notification control

  • Ensures no message is ever missed
     

It transforms communication from a side feature into a core operational backbone of the platform.

 

information_img

מוצרים

מודולים

מאפיינים

מחירון

עלינו

צרו קשר

עוד

BIZ1 CRM
באינטרנט
איש קשר Biz1.co.il