From 4abcc909af5ca89ce308e4049c302e8b87db2903 Mon Sep 17 00:00:00 2001
From: Hagernesh <hagernesh@example.com>
Date: Thu, 23 Jul 2026 07:31:03 +0000
Subject: [PATCH] feat(warehouses): persist saved signature image on handover
 sign
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Store the signer's saved-signature URL on booking_handovers (new
signature_image_url column) when a handover is signed — per-truck or
booking-level — so signed handover documents can render the actual
signature, matching the contract-signing flow.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 .../2800000000001-AddSignatureToHandover.ts   | 22 +++++++++++++++++++
 .../entities/booking-handover.entity.ts       |  4 ++++
 .../modules/warehouses/handover.service.ts    |  4 ++++
 3 files changed, 30 insertions(+)
 create mode 100644 apps/edr-freight-api/src/migrations/2800000000001-AddSignatureToHandover.ts

diff --git a/apps/edr-freight-api/src/migrations/2800000000001-AddSignatureToHandover.ts b/apps/edr-freight-api/src/migrations/2800000000001-AddSignatureToHandover.ts
new file mode 100644
index 000000000..679846484
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/2800000000001-AddSignatureToHandover.ts
@@ -0,0 +1,22 @@
+import { MigrationInterface, QueryRunner } from 'typeorm';
+
+/**
+ * Persist the signer's saved-signature image on the handover record, so the
+ * signed handover document can render the actual signature (not just the
+ * typed name) — parity with the booking-contract signing flow.
+ */
+export class AddSignatureToHandover2800000000001 implements MigrationInterface {
+  name = 'AddSignatureToHandover2800000000001';
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(
+      `ALTER TABLE freight.booking_handovers ADD COLUMN IF NOT EXISTS signature_image_url text;`,
+    );
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(
+      `ALTER TABLE freight.booking_handovers DROP COLUMN IF EXISTS signature_image_url;`,
+    );
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/warehouses/entities/booking-handover.entity.ts b/apps/edr-freight-api/src/modules/warehouses/entities/booking-handover.entity.ts
index c90fb5a16..85f66b74f 100644
--- a/apps/edr-freight-api/src/modules/warehouses/entities/booking-handover.entity.ts
+++ b/apps/edr-freight-api/src/modules/warehouses/entities/booking-handover.entity.ts
@@ -52,4 +52,8 @@ export class BookingHandover extends BaseEntity {
   /** EDR last-mile: when the goods were delivered to the customer. */
   @Column({ name: 'delivered_at', type: 'timestamptz', nullable: true })
   deliveredAt?: Date | null;
+
+  /** URL to the signer's saved signature image, if available at sign time. */
+  @Column({ name: 'signature_image_url', type: 'text', nullable: true })
+  signatureImageUrl?: string | null;
 }
diff --git a/apps/edr-freight-api/src/modules/warehouses/handover.service.ts b/apps/edr-freight-api/src/modules/warehouses/handover.service.ts
index 81f83a57a..d7bb881cd 100644
--- a/apps/edr-freight-api/src/modules/warehouses/handover.service.ts
+++ b/apps/edr-freight-api/src/modules/warehouses/handover.service.ts
@@ -287,6 +287,7 @@ export class HandoverService {
     handoverId: string,
     userId?: string | null,
     signerName?: string | null,
+    signatureImageUrl?: string | null,
   ): Promise<BookingHandover> {
     const repo = this.dataSource.getRepository(BookingHandover);
     const handover = await repo.findOne({ where: { id: handoverId } });
@@ -297,6 +298,7 @@ export class HandoverService {
     handover.signedAt = new Date();
     handover.signedByUserId = userId ?? null;
     handover.signerName = signerName?.trim() || null;
+    handover.signatureImageUrl = signatureImageUrl ?? null;
     return repo.save(handover);
   }
 
@@ -305,6 +307,7 @@ export class HandoverService {
     bookingId: string,
     userId?: string | null,
     signerName?: string | null,
+    signatureImageUrl?: string | null,
   ): Promise<void> {
     await this.dataSource
       .getRepository(BookingHandover)
@@ -314,6 +317,7 @@ export class HandoverService {
           signedAt: new Date(),
           signedByUserId: userId ?? null,
           signerName: signerName?.trim() || null,
+          signatureImageUrl: signatureImageUrl ?? null,
         },
       );
   }