Add file and function header documentation across Services and Main files

Refactor authentication: replace tuple with DTO, namespace config

Trenser.Zenvy/Trenser.Zenvy/Trenser.Zenvy.cpp

@@ -1,4 +1,12 @@
+/*
+ * File: Trenser.Zenvy.cpp
+ * Description: Zenvy Main
+ * Author: Trenser
+ * Created: 30-Mar-2026
+ */
+
 #include "UserInterface.h"
+
 int main()
 {
 	UserInterface userInterFace;

Trenser.Zenvy/Trenser.Zenvy/controllers/ZenvyController.cpp

@@ -1,7 +1,7 @@
 #include "ZenvyController.h"
 
 //Authentication
-AuthenticationContext ZenvyController::login(const std::string& email, const std::string& password)
+AuthenticationDTO ZenvyController::login(const std::string& email, const std::string& password)
 {
 	return m_authenticationManagementService->login(email, password);
 }

Trenser.Zenvy/Trenser.Zenvy/controllers/ZenvyController.h

@@ -13,8 +13,6 @@
 #include "TicketManagementService.h"
 #include "Enums.h"
 
-using AuthenticationContext = std::tuple<Enums::LoginStatus, Enums::EmployeeType, Enums::EmployeeDesignation>;
-
 class ZenvyController
 {
 private:
@@ -42,7 +40,7 @@ public:
 		m_ticketManagementService(std::make_shared<TicketManagementService>()) {};
 		
 		//Authentication
-		AuthenticationContext login(const std::string& email, const std::string& password);
+		AuthenticationDTO login(const std::string& email, const std::string& password);
 		void logout();
 		void changePassword(const std::string&);
 };

Trenser.Zenvy/Trenser.Zenvy/services/ApplicationConfig.cpp

@@ -1 +1,8 @@
+/*
+ * File: ApplicationConfig.cpp
+ * Description: Global Application Config
+ * Author: Trenser
+ * Created: 06-Apr-2026
+ */
+
 #include "ApplicationConfig.h"

Trenser.Zenvy/Trenser.Zenvy/services/ApplicationConfig.h

@@ -1,6 +1,16 @@
+/*
+ * File: ApplicationConfig.h
+ * Description: Global Application Config
+ * Author: Trenser
+ * Created: 06-Apr-2026
+ */
+
 #pragma once
 
 namespace Config
 {
-	constexpr const char* DEFAULT_PASSWORD = "password";
+	namespace Authentication
+	{
+		constexpr const char* DEFAULT_PASSWORD = "password";
+	}
 }

Trenser.Zenvy/Trenser.Zenvy/services/AttendanceManagementService.cpp

@@ -1 +1,8 @@
+/*
+ * File: AttendanceManagementService.cpp
+ * Description: Handles Attendance related operations
+ * Author: Trenser
+ * Created: 30-Apr-2026
+ */
+
 #include "AttendanceManagementService.h"

Trenser.Zenvy/Trenser.Zenvy/services/AttendanceManagementService.h

@@ -1,3 +1,10 @@
+/*
+ * File: AttendanceManagementService.h
+ * Description: Handles Attendance related operations
+ * Author: Trenser
+ * Created: 30-Apr-2026
+ */
+
 #pragma once
 class AttendanceManagementService
 {

Trenser.Zenvy/Trenser.Zenvy/services/AuthenticationManagementService.cpp

@@ -1,65 +1,103 @@
+/*
+ * File: AuthenticationManagementService.cpp
+ * Description: Handles authentication related operations
+ * Author: Trenser
+ * Created: 30-Mar-2026
+ */
+
 #include <stdexcept>
 #include "AuthenticationManagementService.h"
 #include "ApplicationConfig.h"
 
-std::tuple<Enums::LoginStatus, Enums::EmployeeType, Enums::EmployeeDesignation> AuthenticationManagementService::login(const std::string& email, const std::string& password)
+/*
+ * Function: login
+ * Description: Authenticates a user using email and password, determines login status,
+ *              employee type, and designation, and sets the authenticated employee
+ *              in the data store.
+ * Parameters:
+ *    email - employee email address
+ *    password - employee password
+ * Returns:
+ *    AuthenticationDTO containing login status, employee type, and employee designation
+ */
+AuthenticationDTO AuthenticationManagementService::login(const std::string& email, const std::string& password)
 {
-	employeeMap& employees = m_dataStore.getEmployees();
+    employeeMap& employees = m_dataStore.getEmployees();
-	Enums::LoginStatus loginStatus = Enums::LoginStatus::USER_NOT_FOUND;
+    Enums::LoginStatus loginStatus = Enums::LoginStatus::USER_NOT_FOUND;
-	Enums::EmployeeType employeeType = Enums::EmployeeType::INVALID;
+    Enums::EmployeeType employeeType = Enums::EmployeeType::INVALID;
-	Enums::EmployeeDesignation employeeDesignation = Enums::EmployeeDesignation::INVALID;
+    Enums::EmployeeDesignation employeeDesignation = Enums::EmployeeDesignation::INVALID;
-	for (const auto& employee : employees)
+    for (const auto& employee : employees)
-	{
+    {
-		if (employee.second->getEmployeeEmail() == email)
+        if (employee.second->getEmployeeEmail() == email)
-		{
+        {
-			if (employee.second->getEmployeePassword() == password)
+            if (employee.second->getEmployeePassword() == password)
-			{
+            {
-				if (password == Config::DEFAULT_PASSWORD)
+                if (password == Config::Authentication::DEFAULT_PASSWORD)
-				{
+                {
-					loginStatus = Enums::LoginStatus::FIRST_LOGIN;
+                    loginStatus = Enums::LoginStatus::FIRST_LOGIN;
-				}
+                }
-				else
+                else
-				{
+                {
-					loginStatus = Enums::LoginStatus::SUCCESS;
+                    loginStatus = Enums::LoginStatus::SUCCESS;
-				}
+                }
-				employeeType = employee.second->getEmployeeType();
+                employeeType = employee.second->getEmployeeType();
-				if (employeeType == Enums::EmployeeType::GENERAL)
+                if (employeeType == Enums::EmployeeType::GENERAL)
-				{
+                {
-					std::shared_ptr<GeneralEmployee> generalEmployee = std::dynamic_pointer_cast<GeneralEmployee>(employee.second);
+                    std::shared_ptr<GeneralEmployee> generalEmployee = std::dynamic_pointer_cast<GeneralEmployee>(employee.second);
-					if (generalEmployee)
+                    if (generalEmployee)
-					{
+                    {
-						employeeDesignation = generalEmployee->getDesignation();
+                        employeeDesignation = generalEmployee->getDesignation();
-					}
+                    }
-					else
+                    else
-					{
+                    {
-						throw std::runtime_error("Invalid Employee Type");
+                        throw std::runtime_error("Invalid Employee Type");
-					}
+                    }
-				}
+                }
-				m_dataStore.setAuthenticatedEmployee(employee.second);
+                m_dataStore.setAuthenticatedEmployee(employee.second);
-			}
+            }
-			else
+            else
-			{
+            {
-				loginStatus = Enums::LoginStatus::INVALID_PASSWORD;
+                loginStatus = Enums::LoginStatus::INVALID_PASSWORD;
-			}
+            }
-			break;
+            break;
-		}
+        }
-	}
+    }
-	return std::make_tuple(loginStatus, employeeType, employeeDesignation);
+    return std::make_tuple(loginStatus, employeeType, employeeDesignation);
 }
 
+/*
+ * Function: changePassword
+ * Description: Updates the password of the currently authenticated user.
+ * Parameters:
+ *    password - new password to be set
+ * Returns:
+ *    None
+ * Throws:
+ *    runtime_error if no authenticated user is found
+ */
 void AuthenticationManagementService::changePassword(const std::string& password)
 {
-	std::shared_ptr<Employee> authenticatedUser = m_dataStore.getAuthenticatedUser();
+    std::shared_ptr<Employee> authenticatedUser = m_dataStore.getAuthenticatedUser();
-	if (authenticatedUser)
+    if (authenticatedUser)
-	{
+    {
-		authenticatedUser->setEmployeePassword(password);
+        authenticatedUser->setEmployeePassword(password);
-	}
+    }
-	else
+    else
-	{
+    {
-		throw std::runtime_error("User not found");
+        throw std::runtime_error("User not found");
-	}
+    }
 }
 
+/*
+ * Function: logout
+ * Description: Logs out the currently authenticated user by clearing authentication data.
+ * Parameters:
+ *    None
+ * Returns:
+ *    None
+ * Throws:
+ *    runtime_error if no user is currently logged in
+ */
 void AuthenticationManagementService::logout() {
 	if (m_dataStore.getAuthenticatedUser()) {
 		m_dataStore.getAuthenticatedUser() = nullptr;

Trenser.Zenvy/Trenser.Zenvy/services/AuthenticationManagementService.h

@@ -1,19 +1,28 @@
+/*
+ * File: AuthenticationManagementService.h
+ * Description: Handles authentication related operations
+ * Author: Trenser
+ * Created: 30-Mar-2026
+ */
+
 #pragma once
 #include <string>
 #include <map>
+#include <tuple>
 #include <utility>
 #include <stdexcept>
 #include "DataStore.h"
 #include "Enums.h"
 
+using AuthenticationDTO = std::tuple<Enums::LoginStatus, Enums::EmployeeType, Enums::EmployeeDesignation>;
+
 class AuthenticationManagementService
 {
 private:
 	DataStore& m_dataStore;
 public:
 	AuthenticationManagementService() : m_dataStore(DataStore::getInstance()) {};
-	std::tuple<Enums::LoginStatus, Enums::EmployeeType, Enums::EmployeeDesignation> login(const std::string& username, const std::string& password);
+	AuthenticationDTO login(const std::string& username, const std::string& password);
 	void logout();
 	void changePassword(const std::string&);
 };
-

Trenser.Zenvy/Trenser.Zenvy/services/BookingManagementService.cpp

@@ -1 +1,8 @@
+/*
+ * File: BookingManagementService.cpp
+ * Description: Handle operations related to booking meetings
+ * Author: Trenser
+ * Created: 30-Mar-2026
+ */
+
 #include "BookingManagementService.h"

Trenser.Zenvy/Trenser.Zenvy/services/BookingManagementService.h

@@ -1,3 +1,10 @@
+/*
+ * File: BookingManagementService.h
+ * Description: Handle operations related to booking meetings
+ * Author: Trenser
+ * Created: 30-Mar-2026
+ */
+
 #pragma once
 class BookingManagementService
 {

Trenser.Zenvy/Trenser.Zenvy/services/EmployeeManagememtService.cpp

@@ -1 +1,8 @@
+/*
+ * File: EmployeeManagementService.cpp
+ * Description: Handle operations related to employees
+ * Author: Trenser
+ * Created: 30-Mar-2026
+ */
+
 #include "EmployeeManagememtService.h"

Trenser.Zenvy/Trenser.Zenvy/services/EmployeeManagememtService.h

@@ -1,3 +1,10 @@
+/*
+ * File: EmployeeManagementService.h
+ * Description: Handle operations related to employees
+ * Author: Trenser
+ * Created: 30-Mar-2026
+ */
+
 #pragma once
 class EmployeeManagememtService
 {

Trenser.Zenvy/Trenser.Zenvy/services/LeaveManagementService.cpp

@@ -1 +1,8 @@
+/*
+ * File: LeaveManagementService.cpp
+ * Description: Handle operations related to leaves
+ * Author: Trenser
+ * Created: 30-Mar-2026
+ */
+
 #include "LeaveManagementService.h"

Trenser.Zenvy/Trenser.Zenvy/services/LeaveManagementService.h

@@ -1,3 +1,10 @@
+/*
+ * File: LeaveManagementService.h
+ * Description: Handle operations related to leaves
+ * Author: Trenser
+ * Created: 30-Mar-2026
+ */
+
 #pragma once
 class LeaveManagementService
 {

Trenser.Zenvy/Trenser.Zenvy/services/LogService.cpp

@@ -1,3 +1,10 @@
+/*
+ * File: Log.cpp
+ * Description: Handle operations related to logging
+ * Author: Trenser
+ * Created: 01-Apr-2026
+ */
+
 #include "LogService.h"
 #include "Log.h"
 #include "Factory.h"

Trenser.Zenvy/Trenser.Zenvy/services/LogService.h

@@ -1,3 +1,10 @@
+/*
+ * File: Log.h
+ * Description: Handle operations related to logging
+ * Author: Trenser
+ * Created: 01-Apr-2026
+ */
+
 #pragma once
 #include "Log.h"
 

Trenser.Zenvy/Trenser.Zenvy/services/NotificationManagementService.cpp

@@ -1 +1,8 @@
+/*
+ * File: NotificationManagementService.cpp
+ * Description: Handle operations related to notifications
+ * Author: Trenser
+ * Created: 30-Mar-2026
+ */
+
 #include "NotificationManagementService.h"

Trenser.Zenvy/Trenser.Zenvy/services/NotificationManagementService.h

@@ -1,5 +1,11 @@
+/*
+ * File: NotificationManagementService.h
+ * Description: Handle operations related to notifications
+ * Author: Trenser
+ * Created: 30-Mar-2026
+ */
+
 #pragma once
 class NotificationManagementService
 {
 };
-

Trenser.Zenvy/Trenser.Zenvy/services/PayslipManagementService.cpp

@@ -1 +1,8 @@
+/*
+ * File: PayslipManagementService.cpp
+ * Description: Handle operations related to employee payslips
+ * Author: Trenser
+ * Created: 30-Mar-2026
+ */
+
 #include "PayslipManagementService.h"

Trenser.Zenvy/Trenser.Zenvy/services/PayslipManagementService.h

@@ -1,3 +1,10 @@
+/*
+ * File: PayslipManagementService.h
+ * Description: Handle operations related to employee payslips
+ * Author: Trenser
+ * Created: 30-Mar-2026
+ */
+
 #pragma once
 class PayslipManagementService
 {

Trenser.Zenvy/Trenser.Zenvy/services/TalentAcquisitionManagementService.cpp

@@ -1 +1,8 @@
+/*
+ * File: TalentAcquisitionManagementService.cpp
+ * Description: Handle operations related to Talent Acquisition
+ * Author: Trenser
+ * Created: 30-Mar-2026
+ */
+
 #include "TalentAcquisitionManagementService.h"

Trenser.Zenvy/Trenser.Zenvy/services/TalentAcquisitionManagementService.h

@@ -1,5 +1,11 @@
+/*
+ * File: TalentAcquisitionManagementService.h
+ * Description: Handle operations related to Talent Acquisition
+ * Author: Trenser
+ * Created: 30-Mar-2026
+ */
+
 #pragma once
 class TalentAcquisitionManagementService
 {
 };
-

Trenser.Zenvy/Trenser.Zenvy/services/TeamManagementService.cpp

@@ -1 +1,8 @@
+/*
+ * File: TeamManagementService.cpp
+ * Description: Handle operations related to Team Management
+ * Author: Trenser
+ * Created: 30-Mar-2026
+ */
+
 #include "TeamManagementService.h"

Trenser.Zenvy/Trenser.Zenvy/services/TeamManagementService.h

@@ -1,3 +1,10 @@
+/*
+ * File: TeamManagementService.h
+ * Description: Handle operations related to Team Management
+ * Author: Trenser
+ * Created: 30-Mar-2026
+ */
+
 #pragma once
 class TeamManagementService
 {

Trenser.Zenvy/Trenser.Zenvy/services/TicketManagementService.cpp

@@ -1 +1,8 @@
+/*
+ * File: TicketManagementService.h
+ * Description: Handle operations related to Ticket Management
+ * Author: Trenser
+ * Created: 30-Mar-2026
+ */
+
 #include "TicketManagementService.h"

Trenser.Zenvy/Trenser.Zenvy/services/TicketManagementService.h

@@ -1,3 +1,10 @@
+/*
+ * File: TicketManagementService.h
+ * Description: Handle operations related to Ticket Management
+ * Author: Trenser
+ * Created: 30-Mar-2026
+ */
+
 #pragma once
 class TicketManagementService
 {

Trenser.Zenvy/Trenser.Zenvy/utilities/Validator.cpp

@@ -33,7 +33,7 @@ bool util::isEmailValid(const std::string& email) {
 
 bool util::isPasswordValid(const std::string& password)
 {
-	if (password == Config::DEFAULT_PASSWORD)
+	if (password == Config::Authentication::DEFAULT_PASSWORD)
 	{
 		return false;
 	}

Trenser.Zenvy/Trenser.Zenvy/views/UserInterface.cpp

@@ -65,7 +65,7 @@ void UserInterface::login()
     util::read(email);
     std::cout << "Enter password: ";
     util::read(password);
-    AuthenticationContext authenticationContext = m_controller->login(email, password);
+    AuthenticationDTO authenticationContext = m_controller->login(email, password);
     Enums::LoginStatus loginStatus = std::get<0>(authenticationContext);
     Enums::EmployeeType employeeType = std::get<1>(authenticationContext);
     Enums::EmployeeDesignation employeeDesignation = std::get<2>(authenticationContext);