#4390 - CAS Manual Intervention: Add CASInvoiceStatusUpdatedBy Column (#4467)

### As a part of this PR, the following have been completed:

- Added the migration for the `CASInvoiceStatusUpdatedBy` column.

**Rollback Screenshot:**

<img width="815" alt="image"
src="https://github.com/user-attachments/assets/43a2d311-ab3e-43b1-9c65-0124a6e0dff7"
/>

Author: sh16011993

sources/packages/backend/apps/db-migrations/src/migrations/1741646122852-AddCASInvoiceStatusUpdatedByColumn.ts

@@ -0,0 +1,24 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+import { getSQLFileData } from "../utilities/sqlLoader";
+
+export class AddCASInvoiceStatusUpdatedByColumn1741646122852
+  implements MigrationInterface
+{
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(
+      getSQLFileData(
+        "Add-cas-invoice-status-updated-by-column.sql",
+        "CASInvoices",
+      ),
+    );
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(
+      getSQLFileData(
+        "Rollback-add-cas-invoice-status-updated-by-column.sql",
+        "CASInvoices",
+      ),
+    );
+  }
+}

sources/packages/backend/apps/db-migrations/src/sql/CASInvoices/Add-cas-invoice-status-updated-by-column.sql

@@ -0,0 +1,20 @@
+ALTER TABLE
+  sims.cas_invoices
+ADD
+  COLUMN invoice_status_updated_by INT REFERENCES sims.users(id);
+
+COMMENT ON COLUMN sims.cas_invoices.invoice_status_updated_by IS 'User who updated the invoice status.';
+
+-- Update the existing records with the creator.
+UPDATE
+  sims.cas_invoices
+SET
+  invoice_status_updated_by = creator;
+
+-- Update the column to NOT NULL.
+ALTER TABLE
+  sims.cas_invoices
+ALTER COLUMN
+  invoice_status_updated_by
+SET
+  NOT NULL;

sources/packages/backend/apps/db-migrations/src/sql/CASInvoices/Rollback-add-cas-invoice-status-updated-by-column.sql

@@ -0,0 +1,2 @@
+ALTER TABLE
+  sims.cas_invoices DROP COLUMN invoice_status_updated_by;

sources/packages/backend/apps/queue-consumers/src/services/cas-invoice-batch/cas-invoice-batch.service.ts

@@ -133,6 +133,7 @@ export class CASInvoiceBatchService {
   ): CASInvoice[] {
     const casInvoices: CASInvoice[] = [];
     const invoicesSummary = new ProcessSummary();
+    const systemUser = this.systemUsersService.systemUser;
     parentProcessSummary.children(invoicesSummary);
     // Start processing the invoices for each pending receipt.
     for (const receipt of pendingReceipts) {
@@ -152,7 +153,8 @@ export class CASInvoiceBatchService {
       }`;
       newInvoice.invoiceStatus = CASInvoiceStatus.Pending;
       newInvoice.invoiceStatusUpdatedOn = referenceDate;
-      newInvoice.creator = this.systemUsersService.systemUser;
+      newInvoice.creator = systemUser;
+      newInvoice.invoiceStatusUpdatedBy = systemUser;
       newInvoice.createdAt = referenceDate;
       newInvoice.updatedAt = referenceDate;
       // Create invoice details.

sources/packages/backend/libs/sims-db/src/entities/cas-invoice.model.ts

@@ -14,6 +14,7 @@ import {
   CASSupplier,
   CASInvoiceStatus,
   CASInvoiceDetail,
+  User,
 } from ".";
 
 /**
@@ -79,6 +80,15 @@ export class CASInvoice extends RecordDataModel {
     type: "timestamptz",
   })
   invoiceStatusUpdatedOn: Date;
+  /**
+   * User that changed the status last time.
+   */
+  @ManyToOne(() => User, { nullable: false })
+  @JoinColumn({
+    name: "invoice_status_updated_by",
+    referencedColumnName: ColumnNames.ID,
+  })
+  invoiceStatusUpdatedBy: User;
   /**
    * Invoice details.
    */

sources/packages/backend/libs/test-utils/src/factories/cas-invoice.ts

@@ -35,6 +35,7 @@ export function createFakeCASInvoice(relations: {
   casInvoice.invoiceStatus = CASInvoiceStatus.Pending;
   casInvoice.invoiceStatusUpdatedOn = now;
   casInvoice.creator = relations.creator;
+  casInvoice.invoiceStatusUpdatedBy = relations.creator;
   return casInvoice;
 }