Avinash Rajesh
931aa4c406
<User Story> Complete Payments - 1797</User Story> <Changes> 1. Added Controller::getAllInvoices - Retrieves all invoices from PaymentManagementService and returns them as a read-only map. 2. Implemented Controller::confirmPayment - Delegates payment confirmation for a given invoice ID to PaymentManagementService. 3. Introduced PaymentManagementService::getAllInvoice - Provides access to all invoices stored in the datastore. 4. Added PaymentManagementService::confirmPayment - Confirms payment for a specific invoice, updates payment date and status, and sends notification. 5. Extended util::PaymentStatus enum - Added PAID status and updated string conversion. 6. Integrated AdminMenu::confirmPayment - Validates invoice list, filters by status, allows selection, and confirms payment. 7. Updated CustomerMenu::completePayments - Uses parameterized status filtering for invoice selection. 8. Enhanced MenuHelper::selectInvoiceFromUserForPayment - Accepts requiredStatus parameter for flexible filtering. 9. Adjusted AdminMenu options - Added "Confirm Payment" before Logout. </Changes> <Test> Acceptance Criteria: 1. Admin selects "Confirm Payment" from menu. - Verify system prompts and displays invoices filtered by status. 2. Admin selects invoice with status = PAID. - Verify payment confirmation updates date, sets status, and sends notification. 3. Admin attempts confirmation with empty invoice list. - Verify error message: "No pending invoices available for confirmation." 4. Customer completes payment. - Verify selection uses util::PaymentStatus::PENDING and payment flow works correctly. 5. Invalid invoice ID entered. - Verify system throws runtime_error with "Payment failed: invalid invoice ID." Precondition: 1. Admin logged into system. 2. At least one invoice exists in datastore. 3. Notification system available. Steps: 1. Navigate to Admin menu → Confirm Payment. 2. Select invoice with PAID status. 3. Confirm payment and check notification. 4. Attempt with empty invoice list. 5. Attempt with invalid invoice ID. </Test> <Review> Sreeja Reghukumar </Review>
76 lines
3.8 KiB
C++
76 lines
3.8 KiB
C++
/*
|
|
File: Controller.h
|
|
Description: Header file declaring the Controller class, which manages
|
|
user authentication, inventory, services, bookings, job cards,
|
|
invoices, and notifications in the system.
|
|
Author: Trenser
|
|
Date:19-May-2026
|
|
*/
|
|
|
|
#pragma once
|
|
#include <string>
|
|
#include "AuthenticationManagementService.h"
|
|
#include "Enums.h"
|
|
#include "InventoryManagementService.h"
|
|
#include "Map.h"
|
|
#include "PaymentManagementService.h"
|
|
#include "ServiceManagementService.h"
|
|
#include "UserManagementService.h"
|
|
|
|
class Service;
|
|
class ComboPackage;
|
|
class InventoryItem;
|
|
class ServiceBooking;
|
|
class User;
|
|
class JobCard;
|
|
class Invoice;
|
|
class Notification;
|
|
|
|
class Controller
|
|
{
|
|
private:
|
|
AuthenticationManagementService m_authenticationManagementService;
|
|
UserManagementService m_userManagementService;
|
|
ServiceManagementService m_serviceManagementService;
|
|
InventoryManagementService m_inventoryManagementService;
|
|
PaymentManagementService m_paymentManagementService;
|
|
public:
|
|
bool login(const std::string& username, const std::string& password);
|
|
void logout();
|
|
void changePassword(const std::string& newPassword);
|
|
void createCustomer(const std::string& username, const std::string& name, const std::string& password, const std::string& email, const std::string& phone);
|
|
const User* getAuthenticatedUser();
|
|
void createTechnician(const std::string& username, const std::string& name, const std::string& password, const std::string& email, const std::string& phone);
|
|
void updateUserDetails(const std::string& email, const std::string& phone);
|
|
util::Map<std::string, const Service*> getServices();
|
|
util::Map<std::string, const ComboPackage*> getComboPackages();
|
|
void purchaseService(const util::Vector<std::string>& serviceIDs, const std::string& vehicleNumber, const std::string& vehicleBrand, const std::string& vehicleModel);
|
|
void purchaseComboPackage(const std::string& comboPackageID, const std::string& vehicleNumber, const std::string& vehicleBrand, const std::string& vehicleModel);
|
|
util::Map<std::string, const InventoryItem*> getInventoryItems();
|
|
const InventoryItem* getInventoryItem(const std::string& inventoryItemID);
|
|
void addInventoryItem(const std::string& partName, int quantity, double price);
|
|
void addInventoryItemStock(const std::string& selectedItemId, int quantity);
|
|
void removeInventoryItem(const std::string& inventoryItemID);
|
|
util::Map<std::string, const ServiceBooking*> getServiceBookings();
|
|
util::Map<std::string, const ServiceBooking*> getServiceBookingsByUser(const std::string userID);
|
|
util::Map<std::string, const User*> getUsers();
|
|
util::Map<std::string, const User*> getUsers(util::UserType userType);
|
|
void createJobCard(const std::string& bookingID, const std::string& technicianID, const std::string& serviceID);
|
|
void createService(const std::string& name, const util::Vector<std::string>& inventoryItemIDs, double laborCost);
|
|
void removeService(const std::string& serviceID);
|
|
util::Map<std::string, const JobCard*> getJobCardsByUser();
|
|
void completeJob(const std::string& jobID);
|
|
void removeUser(const std::string& userID);
|
|
void createComboPackage(const std::string& name, const util::Vector<std::string>& serviceIDs, double discountPercentage);
|
|
void removeComboPackage(const std::string& comboPackageID);
|
|
util::Map<std::string, const Invoice*> getInvoicesByUser();
|
|
util::Map<std::string, const Invoice*> getAllInvoices();
|
|
void confirmPayment(std::string invoiceID);
|
|
void completePayment(const std::string& invoiceID, util::PaymentMode paymentMode);
|
|
util::Vector<const Notification*> getNotifications();
|
|
void deleteNotification(const std::string& notificationID);
|
|
void configureNotifications(bool paymentNotifications, bool serviceNotifications);
|
|
void loadSystemData();
|
|
void saveSystemData();
|
|
void runSystemChecks();
|
|
}; |