https://github.com/yasminmuntasern/say-hello

💬 Real-Time Chat Application | A seamless communication platform enabling real-time private and group messaging with features like user authentication, profile management .It offers a user-friendly interface for chat organization, group creation, and efficient interaction in a fast and secure environment.
https://github.com/yasminmuntasern/say-hello

api asp-net-core dotnet fluentvalidation react react-hooks react-query react-router realtime-chat singlr vite

Last synced: 3 months ago
JSON representation

Host: GitHub
URL: https://github.com/yasminmuntasern/say-hello
Owner: YasminMuntaserN
Created: 2024-12-03T14:13:06.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2025-01-25T06:42:39.000Z (over 1 year ago)
Last Synced: 2025-07-13T11:48:12.198Z (11 months ago)
Topics: api, asp-net-core, dotnet, fluentvalidation, react, react-hooks, react-query, react-router, realtime-chat, singlr, vite
Language: C#
Homepage: https://youtu.be/WRg_YS79C2s
Size: 26.4 MB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# Real-Time Chat Application

## Overview
The **Real-Time Chat Application** is a cutting-edge, desktop-style web application designed to provide seamless and secure communication. Powered by a robust **.NET 8** backend and a **React Vite** frontend, the application leverages modern technologies to deliver a fast, reliable, and feature-rich user experience.
This application supports real-time messaging for private and group conversations, enhanced by advanced features such as email-based authentication, user management, and instant notifications.

---

## Key Features

### **Authentication and Account Management**
- **Email-Based Registration:**
- Users register with their email, verify their accounts through a secure email link, and gain full access to the application.
- **Password Recovery:**
- Includes a "Forgot Password" feature that sends a secure email link for resetting passwords.
- **User Profile Management:**
- Edit profile details and update passwords.
- Block or archive other users for better organization.

### **Real-Time Messaging**
- **Private Chats:**
- Instantaneous one-on-one communication with real-time updates.
- **Group Chats:**
- Dynamic group messaging where all participants receive messages instantly.

### **Search and Interaction**
- **User Search:**
- Find other users by name or email to initiate chats.
- **Interactive Features:**
- Create groups for collaboration.
- Block or archive chats for streamlined user experience.

## Security Features

### **Authentication System**
- **JWT-Based Authentication:**
- Secure access tokens with configurable expiration
- Refresh token mechanism for seamless session management
- Protection against token theft and replay attacks

### **Authorization Framework**
- **Role-Based Access Control (RBAC):**
- Predefined roles: Admin, GroupMember, User
- Each role has specific permissions and access levels
- Hierarchical permission structure

- **Permission System:**
- **Admin Permissions:**
- Full system access
- User management
- Group management
- Message management
- System configuration

- **GroupMember Permissions:**
- Send messages
- Manage group members
- Block users
- Archive chats
- View chat history

- **User Permissions:**
- Basic messaging
- Profile management
- Chat archiving
- User blocking

### **Security Measures**
- **Token Management:**
- Access tokens expire after 15 minutes
- Refresh tokens valid for 7 days
- Automatic token refresh mechanism
- Secure token storage and transmission

- **Session Security:**
- Automatic session termination on inactivity
- Concurrent session handling
- Secure session state management

- **API Security:**
- Protected endpoints with JWT authentication
- CORS policy implementation
- Rate limiting for API calls
- Request validation and sanitization
---

## Technical Architecture

### **Backend**
- **Framework:** ASP.NET Core 8
- - **Authentication & Authorization:**
- **JWT (JSON Web Tokens):** Secure token-based authentication
- **Refresh Token System:** Enhanced security with token rotation
- **Role-Based Access Control:** Granular permissions management
- **Permission-Based Authorization:** Fine-grained access control
- **Database:** SQL Server, managed with Entity Framework Core
- **Real-Time Communication:**
- Implemented using SignalR for two-way communication between server and clients.
- **Validation and Mapping:**
- **FluentValidation:** Ensures robust data validation for DTOs.
- **Mapster:** Simplifies mapping between DTOs and entities.
- **Email Services:**
- Built-in email functionality for account verification and password recovery.

### **Frontend**
- **Framework:** React with Vite for fast builds and optimized performance.
- **Styling:** Tailwind CSS for sleek and modern UI.
- **Libraries and Tools:**
- **React Query:** Efficient state management and seamless data fetching.
- **React Router:** Handles navigation and routing between pages.
- **React Hook Form:** Simplifies form validation and data handling.
- **React Hot Toast:** Displays elegant toast notifications.
- **SignalR Client:** Connects the React application to the backend for real-time updates.

---

## How SignalR Powers Real-Time Features
**The SignalR library plays a critical role in enabling real-time communication for the chat application:**
- **Persistent Connection:**
- SignalR establishes a continuous connection between the server and clients, ensuring real-time delivery of messages.
- **Message Flow:**
- When a user sends a message, it is transmitted to the SignalR Hub on the server.
- The hub processes the message and instantly broadcasts it to the intended recipient(s).
- All participants, whether in private or group chats, receive the message in real time.
- **Group Chat Synchronization:**
- SignalR manages group communication, ensuring every group member receives messages simultaneously, maintaining consistent state across all devices.

**By utilizing WebSockets, SignalR guarantees efficient and seamless communication, even under varying network conditions.**

## Project Workflow

### **Registration and Verification**
- A user creates an account, triggering a verification email with a secure link.

- Upon verification, the user gains access to their dashboard.

---

### **Real-Time Chat**
- Users can search for other registered users and initiate chats.

- Group creation enables collaborative conversations in real time.

---

### **Message Delivery**
- All messages are stored in the SQL Server database for retrieval and archival.
- SignalR ensures instantaneous delivery and updates for all connected users.

---

### **Account Management**
- Users can block or archive conversations.
- Profiles can be edited to update information or reset passwords.