feat(warehouses): persist saved signature image on handover sign

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>

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;`,
+    );
+  }
+}

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;
 }

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,
         },
       );
   }