Human Resource Management System (HRMS)

• Installation Guide

🔧 System Requirements

PHP 8.2 or higher

Composer (Dependency Manager for PHP)

MySQL 5.7+ or MariaDB 10.3+

Node.js 16+ and npm

Git (Version Control System)

📥 Installation Steps

Step 1: Clone the Repository

git clone

cd hrms

Step 2: Install Backend Dependencies

composer install

Step 3: Install Frontend Dependencies

npm install

Step 4: Environment Configuration cp .env.example .env

Edit the .env file with your database credentials:

env DB_DATABASE=hrms DB_USERNAME=your_db_username DB_PASSWORD=your_db_password

Step 5: Generate Application Key php artisan key:generate

Step 6: Database Setup

php artisan migrate:fresh --seed This command will: Create all necessary database tables Populate the database with sample data Create default admin and test user accounts

Step 7: Build Frontend Assets npm run build

Step 8: Start the Application php artisan serve Visit http://localhost:8000 in your browser to access the HRMS.

📧 Email Configuration for 2FA To enable Two-Factor Authentication (2FA) via email, configure your email settings in the .env file:

env MAIL_MAILER=smtp MAIL_HOST=your_smtp_host MAIL_PORT=587 MAIL_USERNAME=[email protected] MAIL_PASSWORD=your_email_password MAIL_ENCRYPTION=tls MAIL_FROM_ADDRESS=[email protected] MAIL_FROM_NAME="HRMS System"

🔐 Default Login Credentials After installation, you can log in with these default accounts:

Admin Account:

Email: [email protected]

Password: password

Manager Account:

Email: [email protected]

Password: password

Employee Account:

Email: [email protected]

Password: password

📸 Application Screenshots Feature Preview