---
# System prepended metadata

title: HR Handover

---

# Handover Documentation for HR System

**Project Overview:**

This handover document provides comprehensive instructions for setting up and running an HR System. The system consists of a Laravel-based backend with no Blade components and an Angular front end. The document covers the necessary applications and configurations to run the HR System locally.

**Prerequisites:**

Before you can run the HR System locally, ensure you have the following prerequisites installed on your system:

1. **PHP**: Make sure you have PHP installed, as the project utilizes a Laravel backend.

2. **Composer**: Laravel projects require Composer for package management. Install Composer from https://getcomposer.org.

3. **Node.js and npm**: Node.js and npm are required for managing Angular dependencies. Install them from https://nodejs.org.

4. **Angular CLI**: You need Angular CLI to work with the Angular front end. Install it globally using the following command:

   ```bash
   npm install -g @angular/cli
   ```

5. **Database**: Configure your database system. The Laravel backend will specify the database and connection details in its configuration.

**Getting Started:**

1. Clone the project repository to your local machine.

2. In the project root directory, navigate to the Laravel backend folder and run:

   ```bash
   composer install
   ```

   This will install the PHP dependencies for the backend.

3. In the project root directory, navigate to the Angular front end folder and run:

   ```bash
   npm install
   ```

   This will install the necessary Angular dependencies.

4. **Database Setup**: Configure the database connection settings in the Laravel backend. This information can be found in the backend's `.env` file.

5. **Angular Configuration**: If the Angular application requires any environment-specific configurations (e.g., API endpoints), you should set them in the Angular `environment.ts` or `environment.prod.ts` files.

**Running the HR System:**

**Laravel Backend:**

1. Start the Laravel development server by running the following command from the Laravel backend folder:

   ```bash
   php artisan serve
   ```

   This will start the Laravel server, and you can access the backend at `http://localhost:8000` or the appropriate port specified.

**Angular Front End:**

1. Navigate to the Angular front end folder.

2. Start the Angular development server by running the following command:

   ```bash
   ng serve
   ```

   This will launch the Angular development server, and you can access the front end at `http://localhost:4200`.

**Development Workflow:**

Developers can work on the HR System using Angular for the front end and Laravel for the backend. The separation of the backend and front end allows for flexibility and scalability in development.