Emgage Employee Tracking Project

A full-stack application for real-time employee tracking, geofencing, and automated attendance reporting.

Prerequisites

• Java 17+ (for Spring Boot backend)
• Node.js v18+ (for React/Vite frontend)
• PostgreSQL running locally

---

1. Database Setup

1. Ensure your local PostgreSQL server is running.
2. The application automatically connects to a database and runs migrations/generates tables via Hibernate.
3. You can configure database credentials in: backend/src/main/resources/application.properties

---

2. Running the Backend (Spring Boot)

The backend provides the REST APIs and WebSocket STOMP broker.

1. Open a new terminal.
2. Navigate to the backend directory:

   cd backend

3. Run the application using the Maven wrapper:

   ./mvnw spring-boot:run

(The backend server will start on http://localhost:8080)

---

3. Running the Frontend (React + Vite)

The frontend provides the Admin Dashboard and the Employee views.

1. Open a new terminal.
2. Navigate to the frontend directory:

   cd frontend

3. Install the dependencies (only required once):

   npm install

4. Start the development server:

   npm run dev

(The frontend application will typically start on http://localhost:5173)

---

Default Accounts

Upon the first run, the backend DataSeeder automatically generates two default accounts so you can log in immediately:

Admin Account:

• Email: admin@example.com
• Password: password

Employee Account:

• Email: employee@example.com
• Password: password