Jissin Mathew
2ea77bf9b6
<UserStory> SER1798: Update Job Status </UserStory>
<Changes>
1. Renamed Controller and ServiceManagementService methods from completeJob to updateJobStatus for clarity and flexibility.
2. Enhanced ServiceManagementService::updateJobStatus to support transitions:
- STARTED → INPROGRESS
- INPROGRESS → COMPLETED (with invoice generation and customer notification).
3. Added INPROGRESS state to ServiceJobStatus enum and updated string conversion utilities.
4. Introduced filterJobCards helper to generalize job filtering by status.
5. Updated TechnicianMenu to allow technicians to select job type (Started/Inprogress) and update status accordingly.
6. Improved job display to show current status and truncated service names for readability.
</Changes>
<Test>
Acceptance Criteria:
1. Technician can select a job with status STARTED and update it to INPROGRESS.
2. Technician can select a job with status INPROGRESS and update it to COMPLETED.
3. Completed bookings automatically generate invoices and send notifications to customers.
4. Job status updates are reflected in the technician’s job list and customer view.
Precondition:
1. Technician is logged into the system.
2. Assigned job cards exist with valid statuses (STARTED or INPROGRESS).
3. Datastore and payment service are available.
Steps:
1. Navigate to Technician menu and choose "Update Job Status".
- Verify that the system prompts for job type selection (Started/Inprogress).
2. Select a job card from the filtered list.
- Verify that the job card details are displayed with status.
3. Confirm update.
- Verify that the job status changes correctly.
4. For jobs updated to COMPLETED:
- Verify that the booking status is updated, invoice is generated, and notification is sent.
</Test>
<Review>
Sreeja Reghukumar, please review
</Review>
#1798
74 lines
3.7 KiB
C++
74 lines
3.7 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 updateJobStatus(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();
|
|
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();
|
|
}; |