KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

MERN-User-Management-System

★ 16 Open GitHub ↗

A revolutionary user management system, it boasts powerful functionalities, exceptional security features, and a user-friendly interface, specifically designed to enhance enterprise management efficiency.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center">
<img src="public/banner.png" alt="Logo" width="250" height="250" justify-items="center"/>
<h3 align="center">👩🏻‍💻 User Management System 🛡️</h3>
</p>

---

🎉 Welcome to the ultimate **User Management System** designed with security, efficiency, and user experience in mind. This system leverages the **MERN Stack** (MongoDB, Express.js, React.js, Node.js) and utilizes **JSON Web Tokens** (JWT) for secure **Authentication** and **Authorization**. Below is an overview of the key features that make this system a robust and reliable solution for managing user accounts and protecting sensitive data.

---
### 🎈 Key Features

##### 🛡️ Authentication & Authorization 🪪

> - **Signup Option**: Allow new users to create an account easily with a secure signup process.
> - **Login Option**: Enable users to log in to their accounts securely using their credentials.
> - **Logout Option**: Provide a straightforward way for users to log out of their accounts.
> - **Persistent Login**: Offer users the option to stay logged in for 7 days, enhancing convenience while maintaining security.
> - **Weekly Login Requirement**: For added security, users are required to log in at least once a week.
> - **Auto Logout**: Automatically log out users after 15 minutes of inactivity if the persistent login option is not selected.
> - **Abuse Detection**: Utilize reCAPTCHA v3 to detect and prevent abusive traffic or bots.
> - **Email Verification**: Ensure email authenticity with checks for one-time or fake emails, and require email verification for account activation.
> - **Two-Factor Authentication**: Add an extra layer of security with two-factor authentication.

---

##### 🖥️ Login Demo
![](https://raw.githubusercontent.com/JackWorld99/MERN-User-Management-System/master/public/login.gif)

---

##### 💻 Sign in with Google Demo
![](https://raw.githubusercontent.com/JackWorld99/MERN-User-Management-System/master/public/google.gif)

---

##### 🖥️ Sign up Demo
![](https://raw.githubusercontent.com/JackWorld99/MERN-User-Management-System/master/public/signup.gif)

---

##### 🛡️ Password and Account Security

> - **Forgot Password Handling**: Users can reset their passwords securely using an OTP (One-Time Password), ensuring both ease of use and security.
> - **Account Protection**: Limit daily OTP requests and login attempts. Immediate account suspension occurs upon detecting suspicious activity to prevent unauthorized access.
> - **Password Encryption**: Use bcrypt to encrypt and safeguard user passwords.
> - **Secure Data Transmission**: Employ JWT to securely transmit information between parties.

![](https://raw.githubusercontent.com/JackWorld99/MERN-User-Management-System/master/public/reset-password.gif)

##### 🪪 Admin Controls and User Roles 👩🏻‍💻

> - **Immediate User Suspension**: Admins can instantly suspend users to protect company data and system integrity in urgent situations.
> - **Role-Based Authorization**: Assign roles as User or Admin, with appropriate permissions for each.
> - **Status Bar**: Display the current user and their assigned role, providing a clear overview of their status.

![](https://raw.githubusercontent.com/JackWorld99/MERN-User-Management-System/master/public/status.gif)

---

#### 👩🏻‍💻 User Management ⌨️

> - **Root User Privileges**: The root user has maximum privileges within the system.
> - **User Settings Access**: Only the root user and admins can access user settings.
> - **Admin Privileges**: Admins cannot delete or change each other's profiles.
> - **User Creation**: Root user and admins can create new users.
> - **User Management**: Root user and admins can change a user's name, email, password, and roles.
> - **User Search**: Provides a feature for searching user names to find out user details.
> - **Account Deactivation**: Provide a permission feature that restricts user access as soon as possible if needed.
> - **Account Deletion**: Provide a way to remove user access by deleting accounts.
> - **User Activity Monitoring**: Root and admin users can view if a user is online and the last time they were online in real-time.

---

#### 📝 Task Management 🧾

> - **Task Assignment**: Tasks are assigned to specific users.
> - **Task Viewing**: Users can only view their assigned tasks.
> - **Task Management**: The root user can view, edit, and delete all tasks.
> - **Task Creator Privileges**: Task creators can view, edit, update, and delete tasks they created.
> - **Task Deletion**: Tasks can only be deleted by the admin or root user who created them.
> - **Task Status**: Tasks can have statuses of PENDING, EXPIRED, or COMPLETED.
> - **Task Details**: The status bar shows the task creator, created, and edited date-time details.
> - **Task Assignment Viewing**: Admin and root users can view who has been assigned to a task via the list.

![](https://raw.githubusercontent.com/JackWorld99/MERN-User-Management-System/master/public/tasks.gif)

---

#### 📓 Note Management ✏️

> - **Markdown Support**: Users can create, view, edit, and delete their notes with markdown support.
> - **Note Management**: Root user and admins have permission to view, edit, and delete user notes if needed.
> - **Note Search**: Provides search features for titles/tags to view the contents of notes.
> - **Note Tagging**: Tags are provided for tagging notes.

---

### 🪛 Getting Started

The quickest way to get started as shown below:

#### 🌐 Frontend Environment Variables Setup (.env)
Create a .env file in the ***frontend*** directory of your React project and define the following environment variables:

```
REACT_APP_SERVER_URL=     # The base URL of your backend API, e.g., http://localhost:5000
REACT_APP_SOCKET_URL=     # WebSocket server URL, e.g., ws://localhost:5000
REACT_APP_BASE_URL=       # Base URL of the frontend application, e.g., http://localhost:3000
REACT_APP_SITE_KEY=       # reCAPTCHA v2 or v3 Site Key (used on the client side)
```

> ⚠️ Note: All environment variables in React must begin with REACT_APP_ to be accessible in the app.

#### 🔧 Backend Environment Variables Setup (.env)
Create a .env file in the ***backend*** directory of the project and add the following environment variables:

```
# Server Configuration
PORT=              # Port for the backend server, e.g., 5000
REACT_PORT=        # Port for the frontend React app, e.g., 3000
SERVER_URL=        # Full backend URL, e.g., http://localhost:5000
CLIENT_URL=        # Full frontend URL, e.g., http://localhost:3000

# Database & Cache
DATABASE_URL=      # Database connection string, e.g., mongodb://localhost:27017/<database>
REDIS_URL=         # Redis host, e.g., 127.0.0.1
REDIS_PORT=        # Redis port, e.g., 6379
REDIS_PASSWORD=    # Redis password (leave blank if not set)

# Token & Security Secrets
ACCESS_TOKEN_SECRET=       # Secret for generating access tokens
REFRESH_TOKEN_SECRET=      # Secret for generating refresh tokens
SESSION_TOKEN_SECRET=      # Secret for session tokens
OTP_TOKEN_SECRET=          # Secret used for generating OTP codes

# Third-Party Services
GOOGLE_CLIENT_ID=          # Google OAuth Client ID
GOOGLE_CLIENT_SECRET=      # Google OAuth Client Secret
RECAPTCHA_SECRET_KEY=      # Google reCAPTCHA secret key

# Admin Credentials (for initial setup)
ADMIN_EMAIL=               # Default admin email
ADMIN_PASS=                # Default admin password
```

> ⚠️ Note: Never commit your .env file to version control. Be sure to include it in your .gitignore file to keep sensitive information secure.

##### Server Side

```bash
cd Backend
npm i && npm run dev
```

##### Client Side

```bash
cd Frontend
npm i && npm run start
```

---

MERN-User-Management-System

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README