From f1452ba67e98100d5eaa53e6224447493b8d4839 Mon Sep 17 00:00:00 2001
From: Abubeker Yasin <dev.abubeker@gmail.com>
Date: Thu, 9 Jul 2026 09:38:34 +0300
Subject: [PATCH 01/25] feat: ( forget password ) add  phone number

---
 .../backoffice/src/app/login/page.tsx         | 38 +++++++++----------
 .../backoffice/src/lib/api/auth.ts            |  6 ++-
 .../portal/src/app/forgot-password/page.tsx   | 22 +++++------
 .../portal/src/lib/api/auth.ts                |  6 ++-
 4 files changed, 38 insertions(+), 34 deletions(-)

diff --git a/apps/edr-passenger-web/backoffice/src/app/login/page.tsx b/apps/edr-passenger-web/backoffice/src/app/login/page.tsx
index f104db3da..c0d84cae8 100644
--- a/apps/edr-passenger-web/backoffice/src/app/login/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/login/page.tsx
@@ -29,12 +29,12 @@ export default function LoginPage() {
   const [emailFocused, setEmailFocused]       = useState(false);
   const [passwordFocused, setPasswordFocused] = useState(false);
 
-  const [view, setView]                   = useState<'login' | 'forgot'>('login');
-  const [forgotEmail, setForgotEmail]     = useState('');
-  const [forgotLoading, setForgotLoading] = useState(false);
-  const [forgotError, setForgotError]     = useState('');
-  const [forgotSent, setForgotSent]       = useState(false);
-  const [forgotFocused, setForgotFocused] = useState(false);
+  const [view, setView]                       = useState<'login' | 'forgot'>('login');
+  const [forgotIdentifier, setForgotIdentifier] = useState('');
+  const [forgotLoading, setForgotLoading]     = useState(false);
+  const [forgotError, setForgotError]         = useState('');
+  const [forgotSent, setForgotSent]           = useState(false);
+  const [forgotFocused, setForgotFocused]     = useState(false);
 
   const router         = useRouter();
   const { login }      = useAuthStore();
@@ -66,13 +66,13 @@ export default function LoginPage() {
     setForgotLoading(true);
     setForgotError('');
     try {
-      await iamAuthApi.forgotPassword(forgotEmail);
+      await iamAuthApi.forgotPassword(forgotIdentifier.trim());
       setForgotSent(true);
     } catch (err: any) {
       const msg = err.response?.data?.message || err.message || '';
       setForgotError(
         msg === 'user_not_found'
-          ? 'No account found with that email address.'
+          ? 'No account found with that email or phone number.'
           : msg || 'Failed to send the reset link. Please try again.'
       );
     } finally {
@@ -209,7 +209,7 @@ export default function LoginPage() {
                 <div className="flex justify-end mt-2">
                   <button
                     type="button"
-                    onClick={() => { setView('forgot'); setForgotEmail(email); setError(''); }}
+                    onClick={() => { setView('forgot'); setForgotIdentifier(email); setError(''); }}
                     className="text-xs font-medium text-[rgb(20,113,76)] hover:underline"
                   >
                     Forgot password?
@@ -260,7 +260,7 @@ export default function LoginPage() {
                 Reset your password
               </h2>
               <p className="text-sm text-gray-500 dark:text-gray-400 mt-1">
-                Enter your email address and we&apos;ll send a reset link to the phone number on your account.
+                Enter your email or phone number and we&apos;ll send a reset link to the phone number on your account.
               </p>
             </div>
 
@@ -295,10 +295,10 @@ export default function LoginPage() {
                 )}
 
                 <form onSubmit={handleForgotSubmit} className="space-y-4 animate-fade-up" style={{ animationDelay: '80ms' }}>
-                  {/* Email field */}
+                  {/* Email or phone field */}
                   <div>
                     <label className="block text-xs font-semibold text-gray-600 dark:text-gray-400 uppercase tracking-wider mb-2">
-                      Email address
+                      Email or phone number
                     </label>
                     <div className={`relative rounded-xl transition-all duration-200 ${
                       forgotFocused
@@ -306,15 +306,15 @@ export default function LoginPage() {
                         : 'ring-1 ring-gray-200 dark:ring-gray-800'
                     }`}>
                       <input
-                        type="email"
-                        value={forgotEmail}
-                        onChange={(e) => { setForgotEmail(e.target.value); setForgotError(''); }}
+                        type="text"
+                        value={forgotIdentifier}
+                        onChange={(e) => { setForgotIdentifier(e.target.value); setForgotError(''); }}
                         onFocus={() => setForgotFocused(true)}
                         onBlur={() => setForgotFocused(false)}
                         className="w-full px-4 py-3 rounded-xl bg-white dark:bg-gray-900 text-gray-900 dark:text-white placeholder:text-gray-400 dark:placeholder:text-gray-600 text-sm focus:outline-none"
-                        placeholder="name@edr.com"
+                        placeholder="name@edr.com or +251..."
                         required
-                        autoComplete="email"
+                        autoComplete="username"
                       />
                     </div>
                   </div>
@@ -322,9 +322,9 @@ export default function LoginPage() {
                   {/* Submit */}
                   <button
                     type="submit"
-                    disabled={forgotLoading || !forgotEmail}
+                    disabled={forgotLoading || !forgotIdentifier.trim()}
                     className="group w-full mt-2 flex items-center justify-center gap-2 py-3 px-4 rounded-xl font-semibold text-sm text-white transition-all duration-200 disabled:opacity-50 disabled:cursor-not-allowed"
-                    style={{ background: forgotLoading || !forgotEmail
+                    style={{ background: forgotLoading || !forgotIdentifier.trim()
                       ? 'rgb(20,113,76)'
                       : `linear-gradient(135deg, rgb(20,113,76) 0%, rgb(16,143,96) 100%)`
                     }}
diff --git a/apps/edr-passenger-web/backoffice/src/lib/api/auth.ts b/apps/edr-passenger-web/backoffice/src/lib/api/auth.ts
index 1fe1eccbb..babb99ff1 100644
--- a/apps/edr-passenger-web/backoffice/src/lib/api/auth.ts
+++ b/apps/edr-passenger-web/backoffice/src/lib/api/auth.ts
@@ -4,8 +4,10 @@ const API_URL = process.env.NEXT_PUBLIC_API_URL || 'http://localhost:4000';
 
 
 export const iamAuthApi = {
-  forgotPassword: (email: string) =>
-    axios.post(`${API_URL}/v1/auth/forgot-password`, { email }),
+  // `identifier` can be an email address or a phone number — the IAM accepts
+  // either in the `email` field of the forgot-password body.
+  forgotPassword: (identifier: string) =>
+    axios.post(`${API_URL}/v1/auth/forgot-password`, { email: identifier }),
 
   resetPassword: (data: {
     userId: string;
diff --git a/apps/edr-passenger-web/portal/src/app/forgot-password/page.tsx b/apps/edr-passenger-web/portal/src/app/forgot-password/page.tsx
index 254b65eb8..34b41c202 100644
--- a/apps/edr-passenger-web/portal/src/app/forgot-password/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/forgot-password/page.tsx
@@ -6,7 +6,7 @@ import { Train, MailCheck, ArrowLeft } from 'lucide-react';
 import { iamAuthApi } from '@/lib/api/auth';
 
 export default function ForgotPasswordPage() {
-  const [email, setEmail] = useState('');
+  const [identifier, setIdentifier] = useState('');
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState('');
   const [sent, setSent] = useState(false);
@@ -16,13 +16,13 @@ export default function ForgotPasswordPage() {
     setLoading(true);
     setError('');
     try {
-      await iamAuthApi.forgotPassword(email);
+      await iamAuthApi.forgotPassword(identifier.trim());
       setSent(true);
     } catch (err: any) {
       const msg = err.response?.data?.message || err.message || '';
       setError(
         msg === 'user_not_found'
-          ? 'No account found with that email address.'
+          ? 'No account found with that email or phone number.'
           : msg || 'Failed to send the reset link. Please try again.'
       );
     } finally {
@@ -41,7 +41,7 @@ export default function ForgotPasswordPage() {
           </div>
           <h1 className="text-3xl font-bold text-gray-900 dark:text-gray-100">Reset your password</h1>
           <p className="text-gray-600 dark:text-gray-400 mt-2">
-            Enter your email and we&apos;ll send a reset link to the phone number on your account.
+            Enter your email or phone number and we&apos;ll send a reset link to the phone number on your account.
           </p>
         </div>
 
@@ -69,19 +69,19 @@ export default function ForgotPasswordPage() {
                 )}
 
                 <div>
-                  <label className="block text-sm font-medium mb-1 text-gray-700 dark:text-gray-300">Email</label>
+                  <label className="block text-sm font-medium mb-1 text-gray-700 dark:text-gray-300">Email or phone number</label>
                   <input
-                    type="email"
-                    value={email}
-                    onChange={(e) => { setEmail(e.target.value); setError(''); }}
+                    type="text"
+                    value={identifier}
+                    onChange={(e) => { setIdentifier(e.target.value); setError(''); }}
                     className="input-field"
-                    placeholder="your@email.com"
-                    autoComplete="email"
+                    placeholder="your@email.com or +251..."
+                    autoComplete="username"
                     required
                   />
                 </div>
 
-                <button type="submit" className="btn-primary w-full" disabled={loading || !email}>
+                <button type="submit" className="btn-primary w-full" disabled={loading || !identifier.trim()}>
                   {loading ? 'Sending...' : 'Send reset link'}
                 </button>
               </form>
diff --git a/apps/edr-passenger-web/portal/src/lib/api/auth.ts b/apps/edr-passenger-web/portal/src/lib/api/auth.ts
index 14e9a16a1..b37361238 100644
--- a/apps/edr-passenger-web/portal/src/lib/api/auth.ts
+++ b/apps/edr-passenger-web/portal/src/lib/api/auth.ts
@@ -8,8 +8,10 @@ const API_URL = process.env.NEXT_PUBLIC_API_URL || 'http://localhost:4000';
 // current password is wrong on change-password, and OTP failures must surface
 // as inline errors, not a logout.
 export const iamAuthApi = {
-  forgotPassword: (email: string) =>
-    axios.post(`${API_URL}/v1/auth/forgot-password`, { email }),
+  // `identifier` can be an email address or a phone number — the IAM accepts
+  // either in the `email` field of the forgot-password body.
+  forgotPassword: (identifier: string) =>
+    axios.post(`${API_URL}/v1/auth/forgot-password`, { email: identifier }),
 
   // Re-sends the registration verification code for a still-pending account.
   resendRegistrationCode: (data: { email: string; phoneNumber: string }) =>

From aa656eed7ed3934b8e31317f5e0c3462b197fac9 Mon Sep 17 00:00:00 2001
From: Nathnael <nathnael@example.com>
Date: Thu, 9 Jul 2026 06:40:45 +0000
Subject: [PATCH 02/25] fix: profile id and licence to registration

---
 .../companies/company-profile.repository.ts   | 22 ++++-
 .../entities/company-profile.entity.ts        |  2 +-
 .../src/seed/file-upload-settings.seeder.ts   | 83 ++++++++++---------
 .../pages/bookings/resubmit/resubmitDocs.ts   |  2 +-
 .../src/pages/settings/NationalitySelect.tsx  |  2 +-
 5 files changed, 68 insertions(+), 43 deletions(-)

diff --git a/apps/edr-freight-api/src/modules/companies/company-profile.repository.ts b/apps/edr-freight-api/src/modules/companies/company-profile.repository.ts
index 15aec5ac6..9bf14cd61 100644
--- a/apps/edr-freight-api/src/modules/companies/company-profile.repository.ts
+++ b/apps/edr-freight-api/src/modules/companies/company-profile.repository.ts
@@ -1,4 +1,4 @@
-import { Injectable } from "@nestjs/common";
+import { Injectable, InternalServerErrorException } from "@nestjs/common";
 import { InjectRepository } from "@nestjs/typeorm";
 import { Repository } from "typeorm";
 import { BaseRepository } from "@edr/api-common";
@@ -20,6 +20,11 @@ const PREFIX_MAP: Record<ProfileType, string> = {
   [ProfileType.transporter]: "TR",
 };
 
+const SERIES_LETTERS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+
+/** Numbers per series letter: A00001..A99999, then B00001. */
+const SERIES_SIZE = 99_999;
+
 @Injectable()
 export class CompanyProfileRepository extends BaseRepository<CompanyProfile> {
   constructor(
@@ -38,9 +43,20 @@ export class CompanyProfileRepository extends BaseRepository<CompanyProfile> {
     const result = await this.repository.query(
       `SELECT nextval('${seqName}') AS next_id`,
     );
-    const nextId = result[0].next_id as number;
+    const nextId = Number(result[0].next_id);
+    const offset = nextId - 1;
+    const seriesIndex = Math.floor(offset / SERIES_SIZE);
+
+    if (seriesIndex >= SERIES_LETTERS.length) {
+      throw new InternalServerErrorException(
+        `Company profile reference series exhausted for type "${type}"`,
+      );
+    }
+
+    const letter = SERIES_LETTERS[seriesIndex];
+    const number = (offset % SERIES_SIZE) + 1;
     const prefix = PREFIX_MAP[type];
-    return `${prefix}-${String(nextId).padStart(5, "0")}`;
+    return `${prefix}-${letter}${String(number).padStart(5, "0")}`;
   }
 
   async findByCompanyId(companyId: string): Promise<CompanyProfile[]> {
diff --git a/apps/edr-freight-api/src/modules/companies/entities/company-profile.entity.ts b/apps/edr-freight-api/src/modules/companies/entities/company-profile.entity.ts
index 72696766f..2266b0c65 100644
--- a/apps/edr-freight-api/src/modules/companies/entities/company-profile.entity.ts
+++ b/apps/edr-freight-api/src/modules/companies/entities/company-profile.entity.ts
@@ -60,7 +60,7 @@ export class CompanyProfile extends BaseEntity {
   type!: ProfileType;
 
   /**
-   * Official profile reference (e.g. "EX-00001"). Minted only when the profile
+   * Official profile reference (e.g. "EX-A00001"). Minted only when the profile
    * is approved (status → Active); pending/unapproved profiles carry NULL.
    * The unique index tolerates this because Postgres treats NULLs as distinct.
    * API responses surface it as "" when absent — see ResponseCompanyProfileDto.
diff --git a/apps/edr-freight-api/src/seed/file-upload-settings.seeder.ts b/apps/edr-freight-api/src/seed/file-upload-settings.seeder.ts
index 1aef33801..99dae5974 100644
--- a/apps/edr-freight-api/src/seed/file-upload-settings.seeder.ts
+++ b/apps/edr-freight-api/src/seed/file-upload-settings.seeder.ts
@@ -33,8 +33,9 @@ const ETHIOPIAN_ONBOARDING_FIELDS: OnboardingField[] = [
   },
   {
     fileKey: "commercial_license",
-    fileLabel: "Commercial License",
-    helpText: "Verified against the government trade system during registration.",
+    fileLabel: "Commercial Registration",
+    helpText:
+      "Verified against the government trade system during registration.",
     isRequired: true,
     isMultiple: false,
     maxFiles: 1,
@@ -108,7 +109,8 @@ const LEGACY_ONBOARDING_FIELDS: OnboardingField[] = [
   {
     fileKey: "business_license",
     fileLabel: "Business License / Trade License",
-    helpText: "Verified against the government trade system during registration.",
+    helpText:
+      "Verified against the government trade system during registration.",
     isRequired: true,
     isMultiple: false,
     maxFiles: 1,
@@ -489,9 +491,14 @@ const SELF_CLEARANCE_SETTINGS: OnboardingDocumentSetting[] = [
 const CONTRACT_INTAKE_ENTITY = "contract_intake";
 
 const CONTRACT_INTAKE_FIELDS: OnboardingField[] = [
-  clearanceField("commercial_framework", "Commercial Framework / Agreement", 1, {
-    required: false,
-  }),
+  clearanceField(
+    "commercial_framework",
+    "Commercial Framework / Agreement",
+    1,
+    {
+      required: false,
+    },
+  ),
   clearanceField("onboarding_attachment", "Onboarding Attachment", 2, {
     required: false,
   }),
@@ -542,7 +549,7 @@ const DRIVER_DOCUMENT_SETTINGS: OnboardingDocumentSetting[] = [
 export class FileUploadSettingsSeeder {
   private readonly logger = new Logger(FileUploadSettingsSeeder.name);
 
-  constructor(private readonly dataSource: DataSource) {}
+  constructor(private readonly dataSource: DataSource) { }
 
   async run() {
     await this.dataSource.transaction(async (manager) => {
@@ -552,35 +559,35 @@ export class FileUploadSettingsSeeder {
       const allSettings: Array<
         OnboardingDocumentSetting & { description: string }
       > = [
-        ...COMPANY_ONBOARDING_DOCUMENTS.map((s) => ({
-          ...s,
-          description: COMPANY_ONBOARDING_DESCRIPTION,
-        })),
-        ...CLEARANCE_DOCUMENT_SETTINGS.map((s) => ({
-          ...s,
-          description: CLEARANCE_DESCRIPTION,
-        })),
-        ...CONTRACT_CLEARANCE_SETTINGS.map((s) => ({
-          ...s,
-          description:
-            "Pre-booking clearance documents collected on the contract (Path B), by operation and freight type.",
-        })),
-        ...SELF_CLEARANCE_SETTINGS.map((s) => ({
-          ...s,
-          description:
-            "Customer self-clearance documents (Path A, no EDR customs service), reviewed by Operations.",
-        })),
-        ...CONTRACT_INTAKE_SETTINGS.map((s) => ({
-          ...s,
-          description:
-            "Commercial/framework documents attached at contract submission.",
-        })),
-        ...DRIVER_DOCUMENT_SETTINGS.map((s) => ({
-          ...s,
-          description:
-            "Documents uploaded against a driver profile (license, ID, contracts, etc.).",
-        })),
-      ];
+          ...COMPANY_ONBOARDING_DOCUMENTS.map((s) => ({
+            ...s,
+            description: COMPANY_ONBOARDING_DESCRIPTION,
+          })),
+          ...CLEARANCE_DOCUMENT_SETTINGS.map((s) => ({
+            ...s,
+            description: CLEARANCE_DESCRIPTION,
+          })),
+          ...CONTRACT_CLEARANCE_SETTINGS.map((s) => ({
+            ...s,
+            description:
+              "Pre-booking clearance documents collected on the contract (Path B), by operation and freight type.",
+          })),
+          ...SELF_CLEARANCE_SETTINGS.map((s) => ({
+            ...s,
+            description:
+              "Customer self-clearance documents (Path A, no EDR customs service), reviewed by Operations.",
+          })),
+          ...CONTRACT_INTAKE_SETTINGS.map((s) => ({
+            ...s,
+            description:
+              "Commercial/framework documents attached at contract submission.",
+          })),
+          ...DRIVER_DOCUMENT_SETTINGS.map((s) => ({
+            ...s,
+            description:
+              "Documents uploaded against a driver profile (license, ID, contracts, etc.).",
+          })),
+        ];
 
       for (const documentSetting of allSettings) {
         await settingRepository.upsert(
@@ -601,7 +608,9 @@ export class FileUploadSettingsSeeder {
         });
 
         if (!setting) {
-          throw new Error(`file_upload_setting_seed_failed:${documentSetting.code}`);
+          throw new Error(
+            `file_upload_setting_seed_failed:${documentSetting.code}`,
+          );
         }
 
         await fieldRepository.delete({ settingId: setting.id });
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/resubmit/resubmitDocs.ts b/apps/edr-freight-web/portal/src/pages/bookings/resubmit/resubmitDocs.ts
index d8b660413..0a2f1a30f 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/resubmit/resubmitDocs.ts
+++ b/apps/edr-freight-web/portal/src/pages/bookings/resubmit/resubmitDocs.ts
@@ -10,7 +10,7 @@ const LABEL_BY_CODE = new Map<string, string>([
   ...REQUIRED_DOC_FIELDS.map((d) => [d.key, d.label] as const),
   // Company onboarding document codes (see file-upload-settings seeder).
   ["tin_certificate", "TIN Certificate"],
-  ["commercial_license", "Commercial License"],
+  ["commercial_license", "Commercial Registration"],
   ["business_license", "Business License / Trade License"],
   ["investment_license", "Investment License"],
   ["national_id", "National ID"],
diff --git a/apps/edr-freight-web/portal/src/pages/settings/NationalitySelect.tsx b/apps/edr-freight-web/portal/src/pages/settings/NationalitySelect.tsx
index 5b779847a..2115ec083 100644
--- a/apps/edr-freight-web/portal/src/pages/settings/NationalitySelect.tsx
+++ b/apps/edr-freight-web/portal/src/pages/settings/NationalitySelect.tsx
@@ -26,7 +26,7 @@ export default function NationalitySelect({
     <SimpleGrid cols={{ base: 1, sm: 2 }} spacing="md">
       <RoleCard
         label="Ethiopian Company"
-        description="Registered in Ethiopia. You'll provide a TIN certificate, commercial license and national ID."
+        description="Registered in Ethiopia. You'll provide a TIN certificate, commercial registration and national ID."
         icon={<MapPin size={22} />}
         selected={value === "ethiopian"}
         onClick={() => onChange("ethiopian")}

From 66edeb84bf1c0f14bbbcee69894618767dedb302 Mon Sep 17 00:00:00 2001
From: Nathnael <nathnael@example.com>
Date: Thu, 9 Jul 2026 07:02:02 +0000
Subject: [PATCH 03/25] style: update the chat widget

---
 .../src/features/support/SupportWidget.tsx    | 26 ++++++++++++++++---
 1 file changed, 22 insertions(+), 4 deletions(-)

diff --git a/apps/edr-passenger-web/portal/src/features/support/SupportWidget.tsx b/apps/edr-passenger-web/portal/src/features/support/SupportWidget.tsx
index 2b46a97b6..96ecc7276 100644
--- a/apps/edr-passenger-web/portal/src/features/support/SupportWidget.tsx
+++ b/apps/edr-passenger-web/portal/src/features/support/SupportWidget.tsx
@@ -1,6 +1,6 @@
 'use client';
 
-import { Headset, MessageCircle } from 'lucide-react';
+import { Headset } from 'lucide-react';
 import { useState } from 'react';
 
 import { SupportPanel } from './SupportPanel';
@@ -8,6 +8,7 @@ import { useUnreadCount } from './useSupport';
 import { useSupportSocket } from './useSupportSocket';
 
 const GREEN = 'rgb(20 113 76)';
+const GRADIENT = `linear-gradient(135deg, ${GREEN}, rgb(30 140 96))`;
 
 /**
  * Floating support launcher for the portal. One device-scoped thread — opens
@@ -28,10 +29,27 @@ export function SupportWidget() {
         <button
           onClick={() => setOpen(true)}
           aria-label="Open support chat"
-          className="relative flex h-14 w-14 items-center justify-center rounded-full text-white shadow-lg transition hover:scale-105"
-          style={{ background: GREEN, boxShadow: '0 8px 24px rgba(20,113,76,0.4)' }}
+          className="group relative flex items-center gap-2.5 rounded-full p-2 pr-2 text-white transition-transform duration-150 hover:-translate-y-0.5 focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-[3px] focus-visible:outline-primary active:translate-y-0 motion-reduce:transition-none motion-reduce:hover:translate-y-0 sm:pr-5"
+          style={{ background: GRADIENT, boxShadow: '0 10px 28px rgba(20,113,76,0.4)' }}
         >
-          {unread > 0 ? <Headset size={26} /> : <MessageCircle size={26} />}
+          {/* Faint breathing ring; the unread badge is loud enough on its own. */}
+          {unread === 0 && (
+            <span className="pointer-events-none absolute -inset-1 animate-pulse rounded-full ring-2 ring-primary/50 motion-reduce:animate-none" />
+          )}
+
+          <span className="relative grid h-[42px] w-[42px] shrink-0 place-items-center rounded-full bg-white/20">
+            <Headset size={22} />
+          </span>
+
+          <span className="relative hidden text-left leading-tight sm:block">
+            <span className="block whitespace-nowrap text-sm font-semibold">
+              👋 Need help?
+            </span>
+            <span className="block whitespace-nowrap text-[11px] opacity-85">
+              Chat with our team
+            </span>
+          </span>
+
           {unread > 0 && (
             <span className="absolute -right-1 -top-1 flex h-5 min-w-5 items-center justify-center rounded-full border-2 border-white bg-red-500 px-1 text-xs font-bold text-white">
               {unread > 9 ? '9+' : unread}

From d1652c1b96d0d12af405ecefb3ce61b8eedcc33d Mon Sep 17 00:00:00 2001
From: Nathnael <nathnael@example.com>
Date: Thu, 9 Jul 2026 07:04:31 +0000
Subject: [PATCH 04/25] fix: sidebar scrollbar

---
 .../backoffice/src/components/layout/FreightSidebar.tsx      | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/apps/edr-freight-web/backoffice/src/components/layout/FreightSidebar.tsx b/apps/edr-freight-web/backoffice/src/components/layout/FreightSidebar.tsx
index 391a8157d..698b0fc2c 100644
--- a/apps/edr-freight-web/backoffice/src/components/layout/FreightSidebar.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/layout/FreightSidebar.tsx
@@ -250,7 +250,10 @@ const FreightSidebar = ({
       <AppShell.Section
         grow
         component={ScrollArea}
-        type="never"
+        type="hover"
+        scrollbars="y"
+        scrollbarSize={6}
+        scrollHideDelay={500}
         px="sm"
         pb="md"
       >

From cd4df2f810b63cbf9d73fc217a6e074eadf34b8b Mon Sep 17 00:00:00 2001
From: Abubeker Yasin <dev.abubeker@gmail.com>
Date: Thu, 9 Jul 2026 10:32:19 +0300
Subject: [PATCH 05/25] Update webhooks.controller.ts

---
 .../modules/webhooks/webhooks.controller.ts    | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/apps/edr-payment-api/src/modules/webhooks/webhooks.controller.ts b/apps/edr-payment-api/src/modules/webhooks/webhooks.controller.ts
index 66232dfcc..f1e4fa6b0 100644
--- a/apps/edr-payment-api/src/modules/webhooks/webhooks.controller.ts
+++ b/apps/edr-payment-api/src/modules/webhooks/webhooks.controller.ts
@@ -51,8 +51,22 @@ export class WebhooksController {
   @ApiOperation({
     summary: "Telebirr payment notification callback (Ethiopia)",
   })
-  async receiveTelebirr(@Body() payload: TelebirrWebhookPayload) {
-    this.logger.log("Telebirr webhook called");
+  async receiveTelebirr(
+    @Body() payload: TelebirrWebhookPayload,
+    @Headers() headers: Record<string, string>,
+    @Req() req: { method?: string; rawBody?: Buffer },
+  ) {
+    this.logger.log(
+      `Telebirr webhook hit: method=${req.method ?? "n/a"} ` +
+        `merchOrderId=${payload?.merch_order_id ?? "n/a"} ` +
+        `paymentOrderId=${payload?.payment_order_id ?? "n/a"} ` +
+        `tradeStatus=${payload?.trade_status ?? "n/a"}`,
+    );
+    this.logger.log(`Telebirr webhook headers: ${JSON.stringify(headers)}`);
+    this.logger.log(`Telebirr webhook payload: ${JSON.stringify(payload)}`);
+    this.logger.log(
+      `Telebirr webhook raw body: ${req.rawBody?.toString("utf8") ?? "(none)"}`,
+    );
     try {
       await this.telebirr.handle(payload);
     } catch (err) {

From 554756a116d19d825b339c50a4a50f01a7fa6a40 Mon Sep 17 00:00:00 2001
From: Stephanos A <steph.et@outlook.com>
Date: Thu, 9 Jul 2026 11:00:56 +0300
Subject: [PATCH 06/25] Luggage processing,, schedule times and tariff related
 updates

---
 .../src/modules/agents/agents.controller.ts   |   8 +-
 .../src/modules/agents/agents.service.ts      |   7 +
 .../excess-baggage.controller.ts              |  41 +++---
 .../excess-baggage/excess-baggage.dto.ts      |   3 +-
 .../excess-baggage/excess-baggage.service.ts  |   2 +-
 .../src/modules/search/search.service.ts      | 106 +++++++++-----
 .../backoffice/src/app/agents/page.tsx        |  34 ++++-
 .../src/app/excess-baggage/page.tsx           | 131 +++++++++++++++++-
 .../backoffice/src/app/schedules/page.tsx     |   9 +-
 .../backoffice/src/app/tariff-rates/page.tsx  |  17 +--
 .../backoffice/src/app/tickets/page.tsx       |  21 +--
 .../backoffice/src/lib/api/index.ts           |   1 +
 .../backoffice/src/lib/utils.ts               |   6 +-
 .../src/app/booking/passengers/page.tsx       |  46 +++++-
 .../portal/src/app/booking/results/page.tsx   | 129 +++++------------
 15 files changed, 365 insertions(+), 196 deletions(-)

diff --git a/apps/edr-passenger-api/src/modules/agents/agents.controller.ts b/apps/edr-passenger-api/src/modules/agents/agents.controller.ts
index d8be18e74..1f7fcd288 100644
--- a/apps/edr-passenger-api/src/modules/agents/agents.controller.ts
+++ b/apps/edr-passenger-api/src/modules/agents/agents.controller.ts
@@ -1,4 +1,4 @@
-import { Body, Controller, Get, Param, Patch, Post, Query, Request, UseGuards } from '@nestjs/common';
+import { Body, Controller, Delete, Get, Param, Patch, Post, Query, Request, UseGuards } from '@nestjs/common';
 import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
 import { AgentsService } from './agents.service';
 import { CreateAgentDto, CreateAgentBookingDto, OpenShiftDto, CloseShiftDto } from './agents.dto';
@@ -34,6 +34,12 @@ export class AgentsController {
   updateAgent(@Param('id') id: string, @Body() dto: Partial<CreateAgentDto> & { active?: boolean }) {
     return this.service.updateAgent(id, dto);
   }
+
+  @Delete(':id')
+  @ApiOperation({ summary: 'Delete agent profile' })
+  deleteAgent(@Param('id') id: string) {
+    return this.service.deleteAgent(id);
+  }
   @Post('bookings')
   @ApiOperation({ summary: 'Create agent booking with cash payment' })
   createBooking(@Body() dto: CreateAgentBookingDto) {
diff --git a/apps/edr-passenger-api/src/modules/agents/agents.service.ts b/apps/edr-passenger-api/src/modules/agents/agents.service.ts
index cd17da441..4ba7afcf1 100644
--- a/apps/edr-passenger-api/src/modules/agents/agents.service.ts
+++ b/apps/edr-passenger-api/src/modules/agents/agents.service.ts
@@ -210,4 +210,11 @@ export class AgentsService {
       },
     });
   }
+
+  async deleteAgent(id: string) {
+    const agent = await this.prisma.agent.findUnique({ where: { id } });
+    if (!agent) throw new NotFoundException('Agent not found');
+    await this.prisma.agent.delete({ where: { id } });
+    return { deleted: true };
+  }
 }
diff --git a/apps/edr-passenger-api/src/modules/excess-baggage/excess-baggage.controller.ts b/apps/edr-passenger-api/src/modules/excess-baggage/excess-baggage.controller.ts
index 8d01e7113..551cc8881 100644
--- a/apps/edr-passenger-api/src/modules/excess-baggage/excess-baggage.controller.ts
+++ b/apps/edr-passenger-api/src/modules/excess-baggage/excess-baggage.controller.ts
@@ -1,4 +1,4 @@
-import { Body, Controller, Delete, Get, Param, Patch, Post, Query, UseGuards } from '@nestjs/common';
+import { Body, Controller, Delete, Get, Param, Patch, Post, Query, Request, UseGuards } from '@nestjs/common';
 import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
 import { IsInt, IsPositive, IsString } from 'class-validator';
 import { ExcessBaggageService } from './excess-baggage.service';
@@ -26,7 +26,8 @@ export class ExcessBaggageAgentController {
 
   @Post()
   @ApiOperation({ summary: 'Log excess baggage charge and optionally collect cash' })
-  logCharge(@Body() dto: LogExcessBaggageDto) {
+  logCharge(@Request() req: any, @Body() dto: LogExcessBaggageDto) {
+    dto.agentId = req.user?.id ?? req.user?.sub ?? dto.agentId;
     return this.service.logCharge(dto);
   }
 
@@ -50,24 +51,6 @@ export class ExcessBaggageAgentController {
     });
   }
 
-  @Get(':id')
-  @ApiOperation({ summary: 'Get a single charge by ID (agent polling)' })
-  getCharge(@Param('id') id: string) {
-    return this.service.getCharge(id);
-  }
-
-  @Post(':id/resend')
-  @ApiOperation({ summary: 'Resend payment link (extends expiry by 30 min)' })
-  resendLink(@Param('id') id: string) {
-    return this.service.resendLink(id);
-  }
-
-  @Patch(':id/waive')
-  @ApiOperation({ summary: 'Waive a charge (supervisor only)' })
-  waiveCharge(@Param('id') id: string, @Body() dto: WaiveChargeDto) {
-    return this.service.waiveCharge(id, dto);
-  }
-
   @Get('allowances')
   @ApiOperation({ summary: 'List all baggage allowance rules' })
   getAllowances() {
@@ -92,6 +75,24 @@ export class ExcessBaggageAgentController {
     return this.service.deleteAllowance(id);
   }
 
+  @Get(':id')
+  @ApiOperation({ summary: 'Get a single charge by ID (agent polling)' })
+  getCharge(@Param('id') id: string) {
+    return this.service.getCharge(id);
+  }
+
+  @Post(':id/resend')
+  @ApiOperation({ summary: 'Resend payment link (extends expiry by 30 min)' })
+  resendLink(@Param('id') id: string) {
+    return this.service.resendLink(id);
+  }
+
+  @Patch(':id/waive')
+  @ApiOperation({ summary: 'Waive a charge (supervisor only)' })
+  waiveCharge(@Param('id') id: string, @Body() dto: WaiveChargeDto) {
+    return this.service.waiveCharge(id, dto);
+  }
+
   @Delete(':id')
   @ApiOperation({ summary: 'Delete excess baggage charge (admin only)' })
   deleteCharge(@Param('id') id: string) {
diff --git a/apps/edr-passenger-api/src/modules/excess-baggage/excess-baggage.dto.ts b/apps/edr-passenger-api/src/modules/excess-baggage/excess-baggage.dto.ts
index 58bf2bf84..4379ae28d 100644
--- a/apps/edr-passenger-api/src/modules/excess-baggage/excess-baggage.dto.ts
+++ b/apps/edr-passenger-api/src/modules/excess-baggage/excess-baggage.dto.ts
@@ -3,7 +3,8 @@ import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 
 export class LogExcessBaggageDto {
   @ApiProperty({ example: 'booking-uuid' }) @IsString() bookingId: string;
-  @ApiProperty({ example: 'agent-uuid' }) @IsString() agentId: string;
+  @ApiPropertyOptional({ example: 'agent-uuid', description: 'Injected from IAM token; optional override' })
+  @IsOptional() @IsString() agentId?: string;
   @ApiProperty({ example: 7, description: 'Excess weight in kg above the free allowance' })
   @IsInt() @IsPositive() excessWeightKg: number;
   @ApiPropertyOptional({ description: 'Collect cash now instead of sending a payment link' })
diff --git a/apps/edr-passenger-api/src/modules/excess-baggage/excess-baggage.service.ts b/apps/edr-passenger-api/src/modules/excess-baggage/excess-baggage.service.ts
index 24e09b87c..30ab0fd5e 100644
--- a/apps/edr-passenger-api/src/modules/excess-baggage/excess-baggage.service.ts
+++ b/apps/edr-passenger-api/src/modules/excess-baggage/excess-baggage.service.ts
@@ -75,7 +75,7 @@ export class ExcessBaggageService {
     const charge = await this.prisma.excessBaggageCharge.create({
       data: {
         bookingId: dto.bookingId,
-        agentId: dto.agentId,
+        agentId: dto.agentId ?? '',
         excessWeightKg: dto.excessWeightKg,
         feePerKgMinor,
         totalMinor,
diff --git a/apps/edr-passenger-api/src/modules/search/search.service.ts b/apps/edr-passenger-api/src/modules/search/search.service.ts
index 4de0f0d21..a28be295e 100644
--- a/apps/edr-passenger-api/src/modules/search/search.service.ts
+++ b/apps/edr-passenger-api/src/modules/search/search.service.ts
@@ -154,43 +154,54 @@ export class SearchService {
   ) {
     const [y, m, d] = dateStr.split('-').map(Number);
     const requestedDate = new Date(y, m - 1, d, 0, 0, 0, 0);
-
-    const now = new Date();
-    const daysBefore = Math.min(7, Math.floor(requestedDate.getTime() / 86_400_000));
-    const daysAfter = 14 - daysBefore;
-
-    const windowStart = new Date(requestedDate);
-    windowStart.setDate(windowStart.getDate() - daysBefore);
-    if (windowStart < now) windowStart.setTime(now.getTime());
-
-    const windowEnd = new Date(requestedDate);
-    windowEnd.setDate(windowEnd.getDate() + daysAfter + 1);
-
-    const totalPassengers = adultCount + (childCount ?? 0);
-
     const requestedNextDay = new Date(y, m - 1, d + 1, 0, 0, 0, 0);
+    const now = new Date();
+    const totalPassengers = adultCount + (childCount ?? 0);
+    const NEEDED = 3;
 
-    const schedules = await this.prisma.trainSchedule.findMany({
-      where: {
-        status: 'SCHEDULED',
-        isPackageOnly: false,
-        OR: [
-          { departureAt: { gte: windowStart, lt: requestedDate } },
-          { departureAt: { gte: requestedNextDay < now ? now : requestedNextDay, lt: windowEnd } },
-        ],
-        stopTimes: { some: { stationId: originStationId } },
-        coachAssignments: { some: {} },
-      },
-      include: SCHEDULE_INCLUDE,
-      orderBy: { departureAt: 'asc' },
-    });
+    const baseWhere = {
+      status: 'SCHEDULED',
+      isPackageOnly: false,
+      stopTimes: { some: { stationId: originStationId } },
+      coachAssignments: { some: {} },
+    } as const;
 
-    const results = await Promise.all(
-      schedules.map(schedule =>
-        this.buildScheduleResult(schedule as any, originStationId, destinationStationId, totalPassengers, nationality)
-      )
-    );
-    return results.filter((r): r is NonNullable<typeof r> => !!r && r.hasAvailability);
+    // Fetch candidates before and after in parallel; take more than needed to
+    // account for routes that don't serve the destination or have no availability.
+    const FETCH_LIMIT = NEEDED * 5;
+
+    const [beforeCandidates, afterCandidates] = await Promise.all([
+      this.prisma.trainSchedule.findMany({
+        where: { ...baseWhere, departureAt: { gte: now < requestedDate ? now : new Date(0), lt: requestedDate } },
+        include: SCHEDULE_INCLUDE,
+        orderBy: { departureAt: 'desc' },
+        take: FETCH_LIMIT,
+      }),
+      this.prisma.trainSchedule.findMany({
+        where: { ...baseWhere, departureAt: { gte: requestedNextDay > now ? requestedNextDay : now } },
+        include: SCHEDULE_INCLUDE,
+        orderBy: { departureAt: 'asc' },
+        take: FETCH_LIMIT,
+      }),
+    ]);
+
+    const pickN = async (candidates: typeof beforeCandidates, limit: number) => {
+      const out: NonNullable<Awaited<ReturnType<typeof this.buildScheduleResult>>>[] = [];
+      for (const schedule of candidates) {
+        if (out.length >= limit) break;
+        const r = await this.buildScheduleResult(schedule as any, originStationId, destinationStationId, totalPassengers, nationality);
+        if (r?.hasAvailability) out.push(r);
+      }
+      return out;
+    };
+
+    const [before, after] = await Promise.all([
+      pickN(beforeCandidates, NEEDED),
+      pickN(afterCandidates, NEEDED),
+    ]);
+
+    // before was fetched desc (closest first); reverse so result is chronological
+    return [...before.reverse(), ...after];
   }
 
   private async searchSchedules(
@@ -415,7 +426,7 @@ export class SearchService {
       }
     }
 
-    const coachTypes   = this.buildCoachTypeDetails(schedule, faresByClass);
+    const coachTypes   = this.buildCoachTypeDetails(schedule, faresByClass, nationality);
     const legDepartureAt = originStop.plannedDepartureAt ?? schedule.departureAt;
     const legArrivalAt   = destStop.plannedArrivalAt   ?? schedule.arrivalAt;
 
@@ -638,6 +649,10 @@ export class SearchService {
   ): Promise<Array<{ seatClassName: string; baseFareMinor: number; displayCurrency: Currency; displayAmountMinor: number }>> {
     const displayCurrency = resolveCurrencyFromNationality(nationality);
 
+    const nationalityUpper = (nationality ?? '').toUpperCase();
+    const nationalityType = (nationalityUpper === 'ETHIOPIAN' || nationalityUpper === 'DJIBOUTIAN')
+      ? 'LOCAL' : 'INTERNATIONAL';
+
     // Collect seat class IDs from the schedule include for the ID set,
     // but fetch fresh records from DB so updated baseFareMinor is always current
     const seatClassIdSet = new Set<string>();
@@ -647,7 +662,14 @@ export class SearchService {
       }
     }
     const freshSeatClasses = await this.prisma.seatClass.findMany({
-      where: { id: { in: Array.from(seatClassIdSet) }, isActive: true },
+      where: {
+        id: { in: Array.from(seatClassIdSet) },
+        isActive: true,
+        OR: [
+          { nationalityType: null },
+          { nationalityType: nationalityType },
+        ],
+      },
     });
     const seatClassMap = new Map(freshSeatClasses.map(sc => [sc.id, sc]));
     const seatClasses = freshSeatClasses.sort((a, b) => a.baseFareMinor - b.baseFareMinor);
@@ -725,6 +747,7 @@ export class SearchService {
   private buildCoachTypeDetails(
     schedule: ScheduleWithIncludes,
     faresByClass: Array<{ seatClassName: string; baseFareMinor: number; displayCurrency: Currency; displayAmountMinor: number }>,
+    nationality?: string,
   ): Array<{
     coachTypeId: string;
     coachTypeName: string;
@@ -749,8 +772,16 @@ export class SearchService {
         });
       }
 
+      const nationalityUpper = (nationality ?? '').toUpperCase();
+      const resolvedNationalityType = (nationalityUpper === 'ETHIOPIAN' || nationalityUpper === 'DJIBOUTIAN')
+        ? 'LOCAL' : 'INTERNATIONAL';
+
       const entry = coachTypeMap.get(coachType.id)!;
-      coachType.seatClasses?.forEach((sc: any) => entry.classNames.add(sc.name));
+      coachType.seatClasses?.forEach((sc: any) => {
+        // Exclude classes that belong to the wrong nationality type
+        if (sc.nationalityType && sc.nationalityType !== resolvedNationalityType) return;
+        if (faresByClass.some(f => f.seatClassName === sc.name)) entry.classNames.add(sc.name);
+      });
     }
 
     const result = [];
@@ -769,6 +800,7 @@ export class SearchService {
         .filter((c): c is { name: string; baseFareMinor: number; displayCurrency: Currency; displayAmountMinor: number } => c !== null)
         .sort((a, b) => a.baseFareMinor - b.baseFareMinor);
 
+      if (classes.length === 0) continue;
       result.push({
         coachTypeId: coachType.id,
         coachTypeName: coachType.name,
diff --git a/apps/edr-passenger-web/backoffice/src/app/agents/page.tsx b/apps/edr-passenger-web/backoffice/src/app/agents/page.tsx
index 39e02dc3c..9efd7ab19 100644
--- a/apps/edr-passenger-web/backoffice/src/app/agents/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/agents/page.tsx
@@ -2,11 +2,12 @@
 
 import { useState } from 'react';
 import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
-import { Plus, Edit, Eye } from 'lucide-react';
+import { Plus, Edit, Eye, Trash2 } from 'lucide-react';
 import DataTable from '@/components/ui/DataTable';
 import ActionButton from '@/components/ui/ActionButton';
 import Badge from '@/components/ui/Badge';
 import Modal from '@/components/ui/Modal';
+import ConfirmDialog from '@/components/ui/ConfirmDialog';
 import { agentsApi, apiClient } from '@/lib/api';
 import { formatCurrency, formatDateTime } from '@/lib/utils';
 import { useAuthStore } from '@/lib/auth-store';
@@ -48,6 +49,19 @@ export default function AgentsPage() {
   const [editingAgent, setEditingAgent] = useState<any>(null);
   const [editError, setEditError] = useState<string | null>(null);
 
+  const [deleteConfirm, setDeleteConfirm] = useState<{ isOpen: boolean; agent: any | null }>({ isOpen: false, agent: null });
+  const [deleteError, setDeleteError] = useState<string | null>(null);
+
+  const deleteMutation = useMutation({
+    mutationFn: (id: string) => agentsApi.delete(id),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ['agents'] });
+      setDeleteConfirm({ isOpen: false, agent: null });
+      setDeleteError(null);
+    },
+    onError: (e: any) => setDeleteError(e?.response?.data?.message || e?.message || 'Failed to delete agent'),
+  });
+
   const editMutation = useMutation({
     mutationFn: ({ id, ...data }: any) => apiClient.patch(`/agents/${id}`, data),
     onSuccess: () => {
@@ -122,6 +136,12 @@ export default function AgentsPage() {
       variant: 'secondary' as const,
       icon: Eye,
     },
+    {
+      label: 'Delete',
+      onClick: (agent: any) => { setDeleteError(null); setDeleteConfirm({ isOpen: true, agent }); },
+      variant: 'danger' as const,
+      icon: Trash2,
+    },
   ];
 
   return (
@@ -169,6 +189,18 @@ export default function AgentsPage() {
         emptyMessage="No agents found"
       />
 
+      <ConfirmDialog
+        isOpen={deleteConfirm.isOpen}
+        onClose={() => { setDeleteConfirm({ isOpen: false, agent: null }); setDeleteError(null); }}
+        onConfirm={async () => { if (deleteConfirm.agent) await deleteMutation.mutateAsync(deleteConfirm.agent.id); }}
+        title="Delete Agent"
+        message={`Are you sure you want to delete agent ${deleteConfirm.agent?.agentCode}? This action cannot be undone.`}
+        confirmText="Delete"
+        isDanger
+        isLoading={deleteMutation.isPending}
+        error={deleteError ?? undefined}
+      />
+
       {/* Agent Details Modal */}
       <Modal isOpen={!!selected} onClose={() => setSelected(null)} title="Agent Details" size="xl">
         {selected && (() => {
diff --git a/apps/edr-passenger-web/backoffice/src/app/excess-baggage/page.tsx b/apps/edr-passenger-web/backoffice/src/app/excess-baggage/page.tsx
index 7b5db209a..3c13e952b 100644
--- a/apps/edr-passenger-web/backoffice/src/app/excess-baggage/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/excess-baggage/page.tsx
@@ -2,13 +2,14 @@
 
 import { useState } from 'react';
 import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
-import { RefreshCw, Send, Trash2 } from 'lucide-react';
+import { Plus, RefreshCw, Send, Trash2 } from 'lucide-react';
 import DataTable from '@/components/ui/DataTable';
 import Badge from '@/components/ui/Badge';
 import ActionButton from '@/components/ui/ActionButton';
 import Modal from '@/components/ui/Modal';
 import { excessBaggageApi } from '@/lib/api';
 import { formatDateTime, formatCurrency } from '@/lib/utils';
+import { useAuthStore } from '@/lib/auth-store';
 
 const STATUS_VARIANT: Record<string, any> = {
   PENDING: 'PENDING',
@@ -22,9 +23,16 @@ export default function ExcessBaggagePage() {
   const queryClient = useQueryClient();
   const [filters, setFilters] = useState({ status: '', bookingRef: '', dateFrom: '', dateTo: '', page: '1' });
   const [showExtraFilters, setShowExtraFilters] = useState(false);
+  const user = useAuthStore((s) => s.user);
   const [waiveModal, setWaiveModal] = useState<any>(null);
   const [waiveReason, setWaiveReason] = useState('');
   const [waiveError, setWaiveError] = useState<string | null>(null);
+  const [logModal, setLogModal] = useState(false);
+  const [logForm, setLogForm] = useState({ bookingId: '', excessWeightKg: '', collectCash: false });
+  const [logError, setLogError] = useState<string | null>(null);
+  const [resendModal, setResendModal] = useState<any>(null);
+  const [resendSuccess, setResendSuccess] = useState(false);
+  const [resendError, setResendError] = useState<string | null>(null);
 
   const { data, isLoading } = useQuery({
     queryKey: ['excess-baggage', filters],
@@ -37,6 +45,17 @@ export default function ExcessBaggagePage() {
     }),
   });
 
+  const logMutation = useMutation({
+    mutationFn: (data: any) => excessBaggageApi.logCharge(data),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ['excess-baggage'] });
+      setLogModal(false);
+      setLogForm({ bookingId: '', excessWeightKg: '', collectCash: false });
+      setLogError(null);
+    },
+    onError: (e: any) => setLogError(e?.response?.data?.message || e?.message || 'Failed to log charge'),
+  });
+
   const waiveMutation = useMutation({
     mutationFn: ({ id, reason }: { id: string; reason: string }) =>
       excessBaggageApi.waive(id, { waivedBy: 'supervisor', waivedReason: reason }),
@@ -51,7 +70,12 @@ export default function ExcessBaggagePage() {
 
   const resendMutation = useMutation({
     mutationFn: (id: string) => excessBaggageApi.resendLink(id),
-    onSuccess: () => queryClient.invalidateQueries({ queryKey: ['excess-baggage'] }),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ['excess-baggage'] });
+      setResendSuccess(true);
+      setResendError(null);
+    },
+    onError: (e: any) => setResendError(e?.response?.data?.message || e?.message || 'Failed to resend link'),
   });
 
   const deleteMutation = useMutation({
@@ -115,7 +139,7 @@ export default function ExcessBaggagePage() {
       label: 'Resend Link',
       icon: Send,
       variant: 'secondary' as const,
-      onClick: (c: any) => resendMutation.mutate(c.id),
+      onClick: (c: any) => { setResendModal(c); setResendSuccess(false); setResendError(null); },
       show: (c: any) => c.status === 'PENDING',
     },
     {
@@ -145,6 +169,9 @@ export default function ExcessBaggagePage() {
           <h1 className="text-2xl font-bold text-foreground">Excess Lugagge</h1>
           <p className="text-muted-foreground">Track and manage excess luggage charges at boarding</p>
         </div>
+        <ActionButton icon={Plus} onClick={() => { setLogModal(true); setLogError(null); setLogForm({ bookingId: '', excessWeightKg: '', collectCash: false }); }}>
+          Log Excess Luggage
+        </ActionButton>
       </div>
 
       <div className="card">
@@ -194,6 +221,104 @@ export default function ExcessBaggagePage() {
         emptyMessage="No excess baggage charges found"
       />
 
+      {/* Log Excess Luggage Modal */}
+      <Modal isOpen={logModal} onClose={() => setLogModal(false)} title="Log Excess Luggage" size="sm">
+        <div className="space-y-4">
+          {user && (
+            <div className="text-sm text-muted-foreground">
+              Logging as agent: <span className="font-semibold text-foreground">{user.fullName}</span>
+            </div>
+          )}
+          <div>
+            <label className="label">Booking ID</label>
+            <input
+              className="input"
+              placeholder="Booking UUID"
+              value={logForm.bookingId}
+              onChange={(e) => setLogForm({ ...logForm, bookingId: e.target.value })}
+            />
+          </div>
+          <div>
+            <label className="label">Excess Weight (kg)</label>
+            <input
+              type="number"
+              min="1"
+              className="input"
+              placeholder="e.g. 5"
+              value={logForm.excessWeightKg}
+              onChange={(e) => setLogForm({ ...logForm, excessWeightKg: e.target.value })}
+            />
+          </div>
+          <label className="flex items-center gap-2 text-sm cursor-pointer">
+            <input
+              type="checkbox"
+              checked={logForm.collectCash}
+              onChange={(e) => setLogForm({ ...logForm, collectCash: e.target.checked })}
+            />
+            Collect cash now (no payment link sent)
+          </label>
+          {!logForm.collectCash && (
+            <p className="text-xs text-muted-foreground">
+              A payment link will be sent to the passenger's email and phone on file.
+            </p>
+          )}
+          {logError && <p className="text-sm text-red-600 dark:text-red-400">{logError}</p>}
+          <div className="flex justify-end gap-2 pt-2">
+            <ActionButton variant="secondary" onClick={() => setLogModal(false)}>Cancel</ActionButton>
+            <ActionButton
+              loading={logMutation.isPending}
+              onClick={() => {
+                if (!logForm.bookingId.trim() || !logForm.excessWeightKg) {
+                  setLogError('Booking ID and excess weight are required');
+                  return;
+                }
+                logMutation.mutate({
+                  bookingId: logForm.bookingId.trim(),
+                  excessWeightKg: parseInt(logForm.excessWeightKg),
+                  collectCash: logForm.collectCash,
+                });
+              }}
+            >
+              {logForm.collectCash ? 'Log & Collect Cash' : 'Log & Send Payment Link'}
+            </ActionButton>
+          </div>
+        </div>
+      </Modal>
+
+      {/* Resend Link Modal */}
+      <Modal isOpen={!!resendModal} onClose={() => setResendModal(null)} title="Resend Payment Link" size="sm">
+        {resendModal && (
+          <div className="space-y-4">
+            {resendSuccess ? (
+              <div className="rounded-lg bg-green-50 dark:bg-green-900/20 p-4 text-sm text-green-800 dark:text-green-200">
+                ✓ Payment link resent successfully. Expiry extended by 20 minutes.
+              </div>
+            ) : (
+              <>
+                <p className="text-sm text-muted-foreground">
+                  Resend payment link for booking{' '}
+                  <span className="font-mono font-semibold text-foreground">{resendModal.booking?.bookingRef}</span>?
+                </p>
+                <div className="text-sm space-y-1">
+                  {resendModal.contactPhone && <div className="text-muted-foreground">📱 {resendModal.contactPhone}</div>}
+                  {resendModal.contactEmail && <div className="text-muted-foreground">✉ {resendModal.contactEmail}</div>}
+                </div>
+                <p className="text-xs text-muted-foreground">Amount: <span className="font-semibold">{formatCurrency(resendModal.totalMinor, resendModal.currency)}</span>. Expiry will be extended by 20 minutes.</p>
+                {resendError && <p className="text-sm text-red-600 dark:text-red-400">{resendError}</p>}
+              </>
+            )}
+            <div className="flex justify-end gap-2 pt-2">
+              <ActionButton variant="secondary" onClick={() => setResendModal(null)}>Close</ActionButton>
+              {!resendSuccess && (
+                <ActionButton icon={Send} loading={resendMutation.isPending} onClick={() => resendMutation.mutate(resendModal.id)}>
+                  Resend
+                </ActionButton>
+              )}
+            </div>
+          </div>
+        )}
+      </Modal>
+
       {/* Waive Modal */}
       <Modal
         isOpen={!!waiveModal}
diff --git a/apps/edr-passenger-web/backoffice/src/app/schedules/page.tsx b/apps/edr-passenger-web/backoffice/src/app/schedules/page.tsx
index a90add7f1..4ef9b97ed 100644
--- a/apps/edr-passenger-web/backoffice/src/app/schedules/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/schedules/page.tsx
@@ -9,6 +9,7 @@ import Modal from '@/components/ui/Modal';
 import ConfirmDialog from '@/components/ui/ConfirmDialog';
 import { apiClient } from '@/lib/api-client';
 import { routeCoachTemplatesApi } from '@/lib/api';
+import { formatDateTime } from '@/lib/utils';
 
 interface Schedule {
   id: string;
@@ -440,7 +441,7 @@ export default function SchedulesPage() {
       label: 'Departure',
       sortable: true,
       render: (schedule: Schedule) => (
-        <span className="font-mono text-sm">{new Date(schedule.departureAt).toLocaleString()}</span>
+        <span className="font-mono text-sm">{formatDateTime(schedule.departureAt)}</span>
       ),
     },
     {
@@ -448,7 +449,7 @@ export default function SchedulesPage() {
       label: 'Arrival',
       sortable: true,
       render: (schedule: Schedule) => (
-        <span className="font-mono text-sm">{new Date(schedule.arrivalAt).toLocaleString()}</span>
+        <span className="font-mono text-sm">{formatDateTime(schedule.arrivalAt)}</span>
       ),
     },
     {
@@ -641,7 +642,7 @@ export default function SchedulesPage() {
           }
         }}
         title="Cancel Schedule"
-        message={`Cancel the schedule departing ${cancelConfirm.item ? new Date(cancelConfirm.item.departureAt).toLocaleString() : ''}? Passengers with bookings will need to be notified separately.`}
+        message={`Cancel the schedule departing ${cancelConfirm.item ? formatDateTime(cancelConfirm.item.departureAt) : ''}? Passengers with bookings will need to be notified separately.`}
         confirmText="Cancel Schedule"
         isDanger={true}
         isLoading={cancelScheduleMutation.isPending}
@@ -656,7 +657,7 @@ export default function SchedulesPage() {
           deleteConfirm.isBulk
             ? `Are you sure you want to delete ${Array.isArray(deleteConfirm.item) ? deleteConfirm.item.length : 0} schedule(s)? This action cannot be undone.`
             : `Are you sure you want to delete this schedule departing on ${
-                deleteConfirm.item ? new Date(deleteConfirm.item.departureAt).toLocaleString() : ''
+                deleteConfirm.item ? formatDateTime(deleteConfirm.item.departureAt) : ''
               }?`
         }
         confirmText="Delete"
diff --git a/apps/edr-passenger-web/backoffice/src/app/tariff-rates/page.tsx b/apps/edr-passenger-web/backoffice/src/app/tariff-rates/page.tsx
index 653ffddc3..33f39d87e 100644
--- a/apps/edr-passenger-web/backoffice/src/app/tariff-rates/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/tariff-rates/page.tsx
@@ -169,7 +169,7 @@ export default function TariffRatesPage() {
       render: (c: any) => <span className="text-sm">{c.coachType?.name || c.coachTypeId}</span>,
     },
     {
-      key: 'bedPosition', label: 'Berth Position',
+      key: 'bedPosition', label: 'Bed Position',
       render: (c: any) => c.bedPosition
         ? <span className="font-mono text-sm">{c.bedPosition}</span>
         : <span className="text-muted-foreground text-xs">Standard</span>,
@@ -215,8 +215,9 @@ export default function TariffRatesPage() {
     },
   ];
 
-  const selectedCoachType = coachTypesArray.find((c: any) => c.id === selectedCoachTypeId);
-  const isBedCoach = selectedCoachType?.code === 'HBC' || selectedCoachType?.code === 'SBC';
+  const selectedCoachType = coachTypesArray.find((c: any) => c.id === selectedCoachTypeId)
+    ?? editingClass?.coachType;
+  const isBedCoach = selectedCoachType?.name?.toLowerCase().includes('bed') || selectedCoachType?.code?.toLowerCase().includes('bed');
 
   return (
     <div className="space-y-6">
@@ -224,7 +225,7 @@ export default function TariffRatesPage() {
         <div>
           <h1 className="text-2xl font-bold text-foreground">Tariff Rates</h1>
           <p className="text-muted-foreground">
-            Manage per-km fare rates by nationality, coach type, and berth position per the official EDR tariff policy
+            Manage per-km fare rates by nationality, coach type, and bed position per the official EDR tariff policy
           </p>
         </div>
         <ActionButton icon={Plus} onClick={() => { setEditingClass(null); setFormError(null); setShowModal(true); }}>
@@ -237,7 +238,7 @@ export default function TariffRatesPage() {
           <Search className="absolute left-3 top-1/2 -translate-y-1/2 h-4 w-4 text-muted-foreground" />
           <input
             type="text"
-            placeholder="Search by name, nationality, berth position..."
+            placeholder="Search by name, nationality, bed position..."
             className="input pl-10 w-full"
             value={search}
             onChange={(e) => setSearch(e.target.value)}
@@ -311,17 +312,17 @@ export default function TariffRatesPage() {
 
             {isBedCoach && (
               <div>
-                <label className="label">Berth Position *</label>
+                <label className="label">Bed Position *</label>
                 <select
                   className="input"
                   value={selectedBedPosition}
                   onChange={(e) => setSelectedBedPosition(e.target.value)}
                   required={isBedCoach}
                 >
-                  <option value="">Select berth position</option>
+                  <option value="">Select bed position</option>
                   {(selectedCoachType?.code === 'HBC'
                     ? BED_POSITIONS
-                    : (['UPPER', 'LOWER'] as const)
+                    : (['Upper','Middle',  'Lower'] as const)
                   ).map((pos) => (
                     <option key={pos} value={pos}>{pos}</option>
                   ))}
diff --git a/apps/edr-passenger-web/backoffice/src/app/tickets/page.tsx b/apps/edr-passenger-web/backoffice/src/app/tickets/page.tsx
index 275291415..e0c7122e3 100644
--- a/apps/edr-passenger-web/backoffice/src/app/tickets/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/tickets/page.tsx
@@ -38,13 +38,6 @@ export default function TicketsPage() {
   const [excessError, setExcessError] = useState<string | null>(null);
   const [excessResult, setExcessResult] = useState<any>(null);
 
-  const { data: agentData } = useQuery({
-    queryKey: ['agent-me'],
-    queryFn: () => apiClient.get<any>('/agents/me'),
-    enabled: !!user,
-    retry: false,
-  });
-
   const Field = ({ label, value, mono = false, truncate = false }: { label: string; value: string; mono?: boolean; truncate?: boolean }) => (
     <div className="bg-muted/40 rounded-lg p-3">
       <p className="text-xs text-muted-foreground mb-1">{label}</p>
@@ -133,11 +126,8 @@ export default function TicketsPage() {
   const handleExcessSubmit = async (e: React.FormEvent) => {
     e.preventDefault();
     if (!excessTicket) return;
-    const agentId = agentData?.id;
-    if (!agentId) { setExcessError('No agent profile found for your account'); return; }
     await excessMutation.mutateAsync({
       bookingId: excessTicket.booking?.id ?? excessTicket.bookingId,
-      agentId,
       excessWeightKg: parseInt(excessKg),
       collectCash: excessCollectCash,
     });
@@ -486,7 +476,7 @@ export default function TicketsPage() {
 
   const actions = [
     {
-      label: 'Baggage',
+      label: 'Luggage',
       onClick: openExcessModal,
       variant: 'secondary' as const,
       icon: Package,
@@ -912,14 +902,9 @@ export default function TicketsPage() {
             <div className="text-sm text-muted-foreground">
               Booking: <span className="font-semibold text-foreground">{excessTicket?.booking?.bookingRef}</span>
             </div>
-            {agentData && (
+            {user && (
               <div className="text-sm text-muted-foreground">
-                Agent: <span className="font-semibold text-foreground">{agentData.agentCode}</span>
-              </div>
-            )}
-            {!agentData && (
-              <div className="text-sm text-amber-600 dark:text-amber-400">
-                ⚠ No agent profile linked to your account.
+                Agent: <span className="font-semibold text-foreground">{user.fullName}</span>
               </div>
             )}
             <div>
diff --git a/apps/edr-passenger-web/backoffice/src/lib/api/index.ts b/apps/edr-passenger-web/backoffice/src/lib/api/index.ts
index 7824cef07..28ede1126 100644
--- a/apps/edr-passenger-web/backoffice/src/lib/api/index.ts
+++ b/apps/edr-passenger-web/backoffice/src/lib/api/index.ts
@@ -216,6 +216,7 @@ export const agentsApi = {
   getById: (id: string) => apiClient.get<any>(`/agents/${id}`),
   create: (data: any) => apiClient.post<any>('/agents', data),
   update: (id: string, data: any) => apiClient.patch<any>(`/agents/${id}`, data),
+  delete: (id: string) => apiClient.delete(`/agents/${id}`),
   getShifts: (agentId: string) => apiClient.get<any[]>(`/agents/${agentId}/shifts`),
   openShift: (agentId: string, data: any) => apiClient.post<any>(`/agents/${agentId}/shifts/open`, data),
   closeShift: (shiftId: string, data: any) => apiClient.post<any>(`/agents/shifts/${shiftId}/close`, data),
diff --git a/apps/edr-passenger-web/backoffice/src/lib/utils.ts b/apps/edr-passenger-web/backoffice/src/lib/utils.ts
index 7a8f8704f..40131d2c7 100644
--- a/apps/edr-passenger-web/backoffice/src/lib/utils.ts
+++ b/apps/edr-passenger-web/backoffice/src/lib/utils.ts
@@ -19,21 +19,21 @@ export const formatDateTime = (date?: string | Date | null): string => {
   if (!date) return 'N/A';
   const d = new Date(date);
   if (isNaN(d.getTime())) return 'N/A';
-  return format(d, 'MMM dd, yyyy HH:mm');
+  return format(d, 'MMM dd, yyyy h:mm a');
 };
 
 export const formatDateTimeShort = (date?: string | Date | null): string => {
   if (!date) return 'N/A';
   const d = new Date(date);
   if (isNaN(d.getTime())) return 'N/A';
-  return format(d, 'dd MMM yy HH:mm');
+  return format(d, 'dd MMM yy h:mm a');
 };
 
 export const formatDateTimeLocal = (date?: string | Date | null): string => {
   if (!date) return 'N/A';
   const d = new Date(date);
   if (isNaN(d.getTime())) return 'N/A';
-  return format(d, 'MMM dd, yyyy HH:mm');
+  return format(d, 'MMM dd, yyyy h:mm a');
 };
 
 export const getStatusColor = (status: string): string => {
diff --git a/apps/edr-passenger-web/portal/src/app/booking/passengers/page.tsx b/apps/edr-passenger-web/portal/src/app/booking/passengers/page.tsx
index 814a5009e..5e5c13b3e 100644
--- a/apps/edr-passenger-web/portal/src/app/booking/passengers/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/booking/passengers/page.tsx
@@ -13,6 +13,30 @@ import { gregorianToEthiopian, ethiopianToGregorian, ETHIOPIAN_MONTHS, getDaysIn
 
 const GC_MONTHS = ['January','February','March','April','May','June','July','August','September','October','November','December'];
 
+const COUNTRIES = [
+  'Afghanistan','Albania','Algeria','Andorra','Angola','Antigua and Barbuda','Argentina','Armenia','Australia','Austria',
+  'Azerbaijan','Bahamas','Bahrain','Bangladesh','Barbados','Belarus','Belgium','Belize','Benin','Bhutan',
+  'Bolivia','Bosnia and Herzegovina','Botswana','Brazil','Brunei','Bulgaria','Burkina Faso','Burundi','Cabo Verde','Cambodia',
+  'Cameroon','Canada','Central African Republic','Chad','Chile','China','Colombia','Comoros','Congo','Costa Rica',
+  'Croatia','Cuba','Cyprus','Czech Republic','Denmark','Dominica','Dominican Republic','Ecuador','Egypt',
+  'El Salvador','Equatorial Guinea','Eritrea','Estonia','Eswatini','Fiji','Finland','France','Gabon',
+  'Gambia','Georgia','Germany','Ghana','Greece','Grenada','Guatemala','Guinea','Guinea-Bissau','Guyana',
+  'Haiti','Honduras','Hungary','Iceland','India','Indonesia','Iran','Iraq','Ireland','Israel',
+  'Italy','Jamaica','Japan','Jordan','Kazakhstan','Kenya','Kiribati','Kuwait','Kyrgyzstan','Laos',
+  'Latvia','Lebanon','Lesotho','Liberia','Libya','Liechtenstein','Lithuania','Luxembourg','Madagascar','Malawi',
+  'Malaysia','Maldives','Mali','Malta','Marshall Islands','Mauritania','Mauritius','Mexico','Micronesia','Moldova',
+  'Monaco','Mongolia','Montenegro','Morocco','Mozambique','Myanmar','Namibia','Nauru','Nepal','Netherlands',
+  'New Zealand','Nicaragua','Niger','Nigeria','North Korea','North Macedonia','Norway','Oman','Pakistan','Palau',
+  'Palestine','Panama','Papua New Guinea','Paraguay','Peru','Philippines','Poland','Portugal','Qatar','Romania',
+  'Russia','Rwanda','Saint Kitts and Nevis','Saint Lucia','Saint Vincent and the Grenadines','Samoa','San Marino',
+  'Sao Tome and Principe','Saudi Arabia','Senegal','Serbia','Seychelles','Sierra Leone','Singapore','Slovakia',
+  'Slovenia','Solomon Islands','Somalia','South Africa','South Korea','South Sudan','Spain','Sri Lanka','Sudan',
+  'Suriname','Sweden','Switzerland','Syria','Taiwan','Tajikistan','Tanzania','Thailand','Timor-Leste','Togo',
+  'Tonga','Trinidad and Tobago','Tunisia','Turkey','Turkmenistan','Tuvalu','Uganda','Ukraine','United Arab Emirates',
+  'United Kingdom','United States','Uruguay','Uzbekistan','Vanuatu','Vatican City','Venezuela','Vietnam',
+  'Yemen','Zambia','Zimbabwe',
+] as const;
+
 function daysInGCMonth(y: number, m: number) {
   return new Date(y, m, 0).getDate();
 }
@@ -554,6 +578,12 @@ const passengerSchema = z.object({
     if (!data.passportCountry || data.passportCountry.trim().length === 0) {
       ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Issuing country is required', path: ['passportCountry'] });
     }
+    if (data.passportExpiryDate) {
+      const expiry = new Date(data.passportExpiryDate);
+      if (!isNaN(expiry.getTime()) && expiry <= new Date()) {
+        ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Passport expiry date must be in the future', path: ['passportExpiryDate'] });
+      }
+    }
   }
 });
 
@@ -1312,11 +1342,15 @@ export default function PassengersPage() {
 
                               <div>
                                 <label className="block text-sm font-medium mb-1 text-gray-700 dark:text-gray-300">Issuing Country *</label>
-                                <input
+                                <select
                                   {...register(`passengers.${index}.passportCountry`)}
                                   className={`input-field ${errors.passengers?.[index]?.passportCountry ? 'border-red-500' : ''}`}
-                                  placeholder="e.g., Djibouti"
-                                />
+                                >
+                                  <option value="">Select country</option>
+                                  {COUNTRIES.map((c) => (
+                                    <option key={c} value={c}>{c}</option>
+                                  ))}
+                                </select>
                                 {errors.passengers?.[index]?.passportCountry && (
                                   <p className="text-red-500 text-xs mt-1">{errors.passengers[index]?.passportCountry?.message}</p>
                                 )}
@@ -1336,8 +1370,12 @@ export default function PassengersPage() {
                                 <input
                                   type="date"
                                   {...register(`passengers.${index}.passportExpiryDate`)}
-                                  className="input-field"
+                                  className={`input-field ${errors.passengers?.[index]?.passportExpiryDate ? 'border-red-500' : ''}`}
+                                  min={new Date().toISOString().split('T')[0]}
                                 />
+                                {errors.passengers?.[index]?.passportExpiryDate && (
+                                  <p className="text-red-500 text-xs mt-1">{errors.passengers[index]?.passportExpiryDate?.message}</p>
+                                )}
                               </div>
                             </div>
                           </div>
diff --git a/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx b/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx
index 66f91dd60..8639319de 100644
--- a/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx
@@ -197,11 +197,11 @@ export default function ResultsPage() {
   // Alternatives are surfaced whenever a leg returns no exact-date results.
   const alternativeOutbound: Schedule[] =
     !!results && outboundSchedules.length === 0
-      ? results?.alternativeOutbound || []
+      ? results?.alternativeOutbound || results?.outboundAlternatives || []
       : [];
   const alternativeInbound: Schedule[] =
     isRoundTrip && !!results && inboundSchedules.length === 0
-      ? results?.alternativeInbound || []
+      ? results?.alternativeInbound || results?.inboundAlternatives || []
       : [];
   const requestedDate: string =
     (results && results.requestedDate) || searchData.date;
@@ -927,28 +927,19 @@ export default function ResultsPage() {
       !!results &&
       outboundSchedules.length === 0 &&
       inboundSchedules.length === 0 &&
-      alternativeOutbound.length === 0 &&
-      alternativeInbound.length === 0;
+      (results?.alternativeOutbound || []).length === 0 &&
+      (results?.alternativeInbound || []).length === 0;
     if (isRoundTripNoResults) {
       return (
         <div className="min-h-screen bg-gray-50 dark:bg-gray-900 py-12">
           <div className="container mx-auto px-4">
-            <div className="max-w-2xl mx-auto">
-              <div className="card text-center">
-                <div className="w-20 h-20 bg-gray-100 dark:bg-gray-800 rounded-full flex items-center justify-center mx-auto mb-6">
-                  <Calendar className="w-10 h-10 text-gray-400 dark:text-gray-500" />
+            <div className="max-w-6xl mx-auto">
+              <div className="flex items-center justify-between gap-4 px-4 py-3 rounded-xl bg-red-50 dark:bg-red-900/20 border border-red-200 dark:border-red-800">
+                <div className="flex items-center gap-2.5 text-sm text-red-800 dark:text-red-300">
+                  <Calendar className="w-4 h-4 flex-shrink-0" />
+                  <span>No trains found for your selected dates or route.</span>
                 </div>
-                <h2 className="text-2xl font-bold mb-3 text-gray-900 dark:text-gray-100">
-                  No trains found
-                </h2>
-                <p className="text-gray-600 dark:text-gray-400 mb-8">
-                  We couldn&apos;t find any trains for your trip. Try adjusting
-                  your dates or route.
-                </p>
-                <button
-                  onClick={() => router.push(buildSearchUrl())}
-                  className="btn-primary"
-                >
+                <button onClick={() => router.push(buildSearchUrl())} className="text-sm font-semibold text-primary hover:underline flex-shrink-0">
                   Modify search
                 </button>
               </div>
@@ -969,24 +960,13 @@ export default function ResultsPage() {
           {renderClassModal()}
           <div className="container mx-auto px-4">
             <div className="max-w-6xl mx-auto">
-              <div className="card text-center mb-8 max-w-3xl mx-auto">
-                <div className="w-20 h-20 bg-amber-100 dark:bg-amber-900/30 rounded-full flex items-center justify-center mx-auto mb-6">
-                  <Calendar className="w-10 h-10 text-amber-500" />
+              <div className="flex items-center justify-between gap-4 px-4 py-3 rounded-xl bg-red-50 dark:bg-red-900/20 border border-red-200 dark:border-red-800 mb-8">
+                <div className="flex items-center gap-2.5 text-sm text-red-800 dark:text-red-300">
+                  <Calendar className="w-4 h-4 flex-shrink-0" />
+                  <span>No trains available on <span className="font-semibold">{requestedDateLabel}</span>.</span>
                 </div>
-                <h2 className="text-2xl font-bold mb-3 text-gray-900 dark:text-gray-100">
-                  No trains available
-                </h2>
-                <p className="text-gray-600 dark:text-gray-400 mb-8">
-                  No trains are available on{" "}
-                  <span className="font-semibold text-gray-900 dark:text-gray-100">
-                    {requestedDateLabel}
-                  </span>
-                </p>
-                <button
-                  onClick={() => router.push(buildSearchUrl())}
-                  className="btn-primary"
-                >
-                  Change travel date
+                <button onClick={() => router.push(buildSearchUrl())} className="text-sm font-semibold text-primary hover:underline flex-shrink-0">
+                  Change date
                 </button>
               </div>
 
@@ -1017,22 +997,13 @@ export default function ResultsPage() {
     return (
       <div className="min-h-screen bg-gray-50 dark:bg-gray-900 py-12">
         <div className="container mx-auto px-4">
-          <div className="max-w-2xl mx-auto">
-            <div className="card text-center">
-              <div className="w-20 h-20 bg-gray-100 dark:bg-gray-800 rounded-full flex items-center justify-center mx-auto mb-6">
-                <Calendar className="w-10 h-10 text-gray-400 dark:text-gray-500" />
+          <div className="max-w-6xl mx-auto">
+            <div className="flex items-center justify-between gap-4 px-4 py-3 rounded-xl bg-gray-100 dark:bg-gray-800 border border-gray-200 dark:border-gray-700">
+              <div className="flex items-center gap-2.5 text-sm text-gray-600 dark:text-gray-400">
+                <Calendar className="w-4 h-4 flex-shrink-0 text-gray-400" />
+                <span>No trains found matching your search. Try adjusting your dates or route.</span>
               </div>
-              <h2 className="text-2xl font-bold mb-3 text-gray-900 dark:text-gray-100">
-                No trains found
-              </h2>
-              <p className="text-gray-600 dark:text-gray-400 mb-8">
-                We couldn&apos;t find any trains matching your search criteria.{" "}
-                <br /> Try adjusting your dates or route.
-              </p>
-              <button
-                onClick={() => router.push(buildSearchUrl())}
-                className="btn-primary"
-              >
+              <button onClick={() => router.push(buildSearchUrl())} className="text-sm font-semibold text-primary hover:underline flex-shrink-0">
                 Modify search
               </button>
             </div>
@@ -1156,29 +1127,13 @@ export default function ResultsPage() {
                   {outboundSchedules.length === 0 &&
                     alternativeOutbound.length > 0 && (
                       <div className="mt-6">
-                        <div className="card text-center mb-6 max-w-3xl mx-auto">
-                          <div className="w-16 h-16 bg-amber-100 dark:bg-amber-900/30 rounded-full flex items-center justify-center mx-auto mb-4">
-                            <Calendar className="w-8 h-8 text-amber-500" />
+                        <div className="flex items-center justify-between gap-4 px-4 py-3 rounded-xl bg-red-50 dark:bg-red-900/20 border border-red-200 dark:border-red-800 mb-6">
+                          <div className="flex items-center gap-2.5 text-sm text-red-800 dark:text-red-300">
+                            <Calendar className="w-4 h-4 flex-shrink-0" />
+                            <span>No trains on <span className="font-semibold">{requestedDate ? format(new Date(`${requestedDate}T00:00:00`), "EEEE, MMMM d") : "your selected date"}</span>.</span>
                           </div>
-                          <h2 className="text-xl font-bold mb-2 text-gray-900 dark:text-gray-100">
-                            No trains available
-                          </h2>
-                          <p className="text-gray-600 dark:text-gray-400 mb-6">
-                            No trains are available on{" "}
-                            <span className="font-semibold text-gray-900 dark:text-gray-100">
-                              {requestedDate
-                                ? format(
-                                    new Date(`${requestedDate}T00:00:00`),
-                                    "EEEE, MMMM d, yyyy",
-                                  )
-                                : "your selected date"}
-                            </span>
-                          </p>
-                          <button
-                            onClick={() => router.push(buildSearchUrl())}
-                            className="btn-primary"
-                          >
-                            Change travel dates
+                          <button onClick={() => router.push(buildSearchUrl())} className="text-sm font-semibold text-primary hover:underline flex-shrink-0">
+                            Change dates
                           </button>
                         </div>
                         <div className="mb-3">
@@ -1256,29 +1211,13 @@ export default function ResultsPage() {
                   {inboundSchedules.length === 0 &&
                     alternativeInbound.length > 0 && (
                       <div className="mt-6">
-                        <div className="card text-center mb-6 max-w-3xl mx-auto">
-                          <div className="w-16 h-16 bg-amber-100 dark:bg-amber-900/30 rounded-full flex items-center justify-center mx-auto mb-4">
-                            <Calendar className="w-8 h-8 text-amber-500" />
+                        <div className="flex items-center justify-between gap-4 px-4 py-3 rounded-xl bg-red-50 dark:bg-red-900/20 border border-red-200 dark:border-red-800 mb-6">
+                          <div className="flex items-center gap-2.5 text-sm text-red-800 dark:text-red-300">
+                            <Calendar className="w-4 h-4 flex-shrink-0" />
+                            <span>No trains on <span className="font-semibold">{requestedReturnDate ? format(new Date(`${requestedReturnDate}T00:00:00`), "EEEE, MMMM d") : "your selected return date"}</span>.</span>
                           </div>
-                          <h2 className="text-xl font-bold mb-2 text-gray-900 dark:text-gray-100">
-                            No trains available
-                          </h2>
-                          <p className="text-gray-600 dark:text-gray-400 mb-6">
-                            No trains are available on{" "}
-                            <span className="font-semibold text-gray-900 dark:text-gray-100">
-                              {requestedReturnDate
-                                ? format(
-                                    new Date(`${requestedReturnDate}T00:00:00`),
-                                    "EEEE, MMMM d, yyyy",
-                                  )
-                                : "your selected return date"}
-                            </span>
-                          </p>
-                          <button
-                            onClick={() => router.push(buildSearchUrl())}
-                            className="btn-primary"
-                          >
-                            Change travel dates
+                          <button onClick={() => router.push(buildSearchUrl())} className="text-sm font-semibold text-primary hover:underline flex-shrink-0">
+                            Change dates
                           </button>
                         </div>
                         <div className="mb-3">

From 758c6082f3ab6353ceb73bded525d4897f634c12 Mon Sep 17 00:00:00 2001
From: Stephanos A <steph.et@outlook.com>
Date: Thu, 9 Jul 2026 11:15:42 +0300
Subject: [PATCH 07/25] Passenger portal build issue resolution

---
 .../portal/src/app/booking/results/page.tsx               | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx b/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx
index aa1bf4279..3ef1c8875 100644
--- a/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx
@@ -203,11 +203,6 @@ export default function ResultsPage() {
     isRoundTrip && !!results && inboundSchedules.length === 0
       ? results?.alternativeInbound || results?.inboundAlternatives || []
       : [];
-  const requestedDate: string =
-    (results && results.requestedDate) || searchData.date;
-  const requestedReturnDate: string =
-    (results && results.requestedReturnDate) || searchData.returnDate || "";
-
   const isOneWayNoOutbound =
     !isRoundTrip && !!results && outboundSchedules.length === 0;
   // Round-trip: show results view if either leg has exact results OR alternatives.
@@ -965,9 +960,6 @@ export default function ResultsPage() {
     }
 
     if (isOneWayNoOutbound) {
-      const requestedDateLabel = requestedDate
-        ? format(new Date(`${requestedDate}T00:00:00`), "EEEE, MMMM d, yyyy")
-        : "your selected date";
       const hasAlternatives = alternativeOutbound.length > 0;
 
       return (

From 5a8db998e513105838e73b63c2d53743c51c3810 Mon Sep 17 00:00:00 2001
From: Stephanos A <steph.et@outlook.com>
Date: Thu, 9 Jul 2026 11:23:14 +0300
Subject: [PATCH 08/25] Alternative schedules notification updates

---
 .../portal/src/app/booking/results/page.tsx   | 39 +++++++++++--------
 1 file changed, 22 insertions(+), 17 deletions(-)

diff --git a/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx b/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx
index 3ef1c8875..33609ba0e 100644
--- a/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx
@@ -944,10 +944,11 @@ export default function ResultsPage() {
       return (
         <div className="min-h-screen bg-gray-50 dark:bg-gray-900 py-12">
           <div className="container mx-auto px-4">
-            <div className="max-w-2xl mx-auto">
-              <div className="card text-center">
-                <div className="hidden sm:flex w-20 h-20 bg-gray-100 dark:bg-gray-800 rounded-full items-center justify-center mx-auto mb-6">
-                  <Calendar className="w-10 h-10 text-gray-400 dark:text-gray-500" />
+            <div className="max-w-6xl mx-auto">
+              <div className="flex items-center justify-between gap-4 px-4 py-3 rounded-xl bg-red-50 dark:bg-red-900/20 border border-red-200 dark:border-red-800">
+                <div className="flex items-center gap-2.5 text-sm text-red-800 dark:text-red-300">
+                  <Calendar className="w-4 h-4 flex-shrink-0" />
+                  <span>No trains found for your selected dates or route.</span>
                 </div>
                 <button onClick={() => router.push(buildSearchUrl())} className="text-sm font-semibold text-primary hover:underline flex-shrink-0">
                   Modify search
@@ -967,9 +968,10 @@ export default function ResultsPage() {
           {renderClassModal()}
           <div className="container mx-auto px-4">
             <div className="max-w-6xl mx-auto">
-              <div className="card text-center mb-8 max-w-3xl mx-auto">
-                <div className="hidden sm:flex w-20 h-20 bg-amber-100 dark:bg-amber-900/30 rounded-full items-center justify-center mx-auto mb-6">
-                  <Calendar className="w-10 h-10 text-amber-500" />
+              <div className="flex items-center justify-between gap-4 px-4 py-3 rounded-xl bg-red-50 dark:bg-red-900/20 border border-red-200 dark:border-red-800 mb-8">
+                <div className="flex items-center gap-2.5 text-sm text-red-800 dark:text-red-300">
+                  <Calendar className="w-4 h-4 flex-shrink-0" />
+                  <span>No trains available on <span className="font-semibold">{searchData.date ? format(new Date(`${searchData.date}T00:00:00`), "EEEE, MMMM d, yyyy") : "your selected date"}</span>.</span>
                 </div>
                 <button onClick={() => router.push(buildSearchUrl())} className="text-sm font-semibold text-primary hover:underline flex-shrink-0">
                   Change date
@@ -1003,10 +1005,11 @@ export default function ResultsPage() {
     return (
       <div className="min-h-screen bg-gray-50 dark:bg-gray-900 py-12">
         <div className="container mx-auto px-4">
-          <div className="max-w-2xl mx-auto">
-            <div className="card text-center">
-              <div className="hidden sm:flex w-20 h-20 bg-gray-100 dark:bg-gray-800 rounded-full items-center justify-center mx-auto mb-6">
-                <Calendar className="w-10 h-10 text-gray-400 dark:text-gray-500" />
+          <div className="max-w-6xl mx-auto">
+            <div className="flex items-center justify-between gap-4 px-4 py-3 rounded-xl bg-gray-100 dark:bg-gray-800 border border-gray-200 dark:border-gray-700">
+              <div className="flex items-center gap-2.5 text-sm text-gray-600 dark:text-gray-400">
+                <Calendar className="w-4 h-4 flex-shrink-0 text-gray-400" />
+                <span>No trains found matching your search. Try adjusting your dates or route.</span>
               </div>
               <button onClick={() => router.push(buildSearchUrl())} className="text-sm font-semibold text-primary hover:underline flex-shrink-0">
                 Modify search
@@ -1132,9 +1135,10 @@ export default function ResultsPage() {
                   {outboundSchedules.length === 0 &&
                     alternativeOutbound.length > 0 && (
                       <div className="mt-6">
-                        <div className="card text-center mb-6 max-w-3xl mx-auto">
-                          <div className="hidden sm:flex w-16 h-16 bg-amber-100 dark:bg-amber-900/30 rounded-full items-center justify-center mx-auto mb-4">
-                            <Calendar className="w-8 h-8 text-amber-500" />
+                        <div className="flex items-center justify-between gap-4 px-4 py-3 rounded-xl bg-red-50 dark:bg-red-900/20 border border-red-200 dark:border-red-800 mb-6">
+                          <div className="flex items-center gap-2.5 text-sm text-red-800 dark:text-red-300">
+                            <Calendar className="w-4 h-4 flex-shrink-0" />
+                            <span>No trains on <span className="font-semibold">{searchData.date ? format(new Date(`${searchData.date}T00:00:00`), "EEEE, MMMM d") : "your selected date"}</span>.</span>
                           </div>
                           <button onClick={() => router.push(buildSearchUrl())} className="text-sm font-semibold text-primary hover:underline flex-shrink-0">
                             Change dates
@@ -1215,9 +1219,10 @@ export default function ResultsPage() {
                   {inboundSchedules.length === 0 &&
                     alternativeInbound.length > 0 && (
                       <div className="mt-6">
-                        <div className="card text-center mb-6 max-w-3xl mx-auto">
-                          <div className="hidden sm:flex w-16 h-16 bg-amber-100 dark:bg-amber-900/30 rounded-full items-center justify-center mx-auto mb-4">
-                            <Calendar className="w-8 h-8 text-amber-500" />
+                        <div className="flex items-center justify-between gap-4 px-4 py-3 rounded-xl bg-red-50 dark:bg-red-900/20 border border-red-200 dark:border-red-800 mb-6">
+                          <div className="flex items-center gap-2.5 text-sm text-red-800 dark:text-red-300">
+                            <Calendar className="w-4 h-4 flex-shrink-0" />
+                            <span>No trains on <span className="font-semibold">{searchData.returnDate ? format(new Date(`${searchData.returnDate}T00:00:00`), "EEEE, MMMM d") : "your selected return date"}</span>.</span>
                           </div>
                           <button onClick={() => router.push(buildSearchUrl())} className="text-sm font-semibold text-primary hover:underline flex-shrink-0">
                             Change dates

From e04b513b8f0ebb129bf2615436ef2f21c9ba6f8a Mon Sep 17 00:00:00 2001
From: Nathnael <nathnael@example.com>
Date: Thu, 9 Jul 2026 08:50:08 +0000
Subject: [PATCH 09/25] feat: password reset flow

---
 .../modules/auth/customer-reset.controller.ts |  48 +++
 .../modules/auth/customer-reset.service.ts    |  59 ++++
 .../modules/auth/dto/forgot-password.dto.ts   |  35 ++
 .../auth/forgot-password.controller.ts        |  69 ++++
 .../modules/auth/forgot-password.service.ts   | 169 ++++++++++
 .../src/modules/auth/freight-auth.module.ts   |  26 +-
 .../contracts/contract-transition.service.ts  |   2 +-
 .../src/modules/otp/otp.service.ts            |  50 ++-
 .../src/seed/freight-permissions.registry.ts  |   2 +
 .../customers/ResetPasswordAction.tsx         | 105 ++++++
 .../src/components/customers/index.ts         |   4 +
 .../backoffice/src/constants/URLS.ts          |   2 +
 .../backoffice/src/lib/permissions.ts         |   1 +
 .../pages/customers/CustomerDetailPage.tsx    |   2 +
 .../backoffice/src/services/api.ts            |  12 +
 .../src/services/customers.service.ts         |  18 +
 .../backoffice/src/types/customer.ts          |   9 +
 apps/edr-freight-web/portal/src/App.tsx       |   2 +
 .../src/components/auth/OtpChannelStep.tsx    | 179 ++++++++++
 .../src/components/auth/PasswordChecklist.tsx |  41 +++
 .../portal/src/constants/URLS.ts              |   2 +
 .../portal/src/hooks/useResendCooldown.ts     |  24 ++
 .../src/pages/accounts/ForgotPasswordPage.tsx | 312 ++++++++++++++++++
 .../portal/src/pages/accounts/LoginPage.tsx   |  14 +-
 .../src/pages/accounts/SetPasswordPage.tsx    |  30 +-
 .../portal/src/pages/accounts/SignupPage.tsx  | 260 +++------------
 .../portal/src/services/api.ts                |  18 +
 .../portal/src/services/auth.service.ts       |  28 ++
 apps/edr-freight-web/portal/src/types/auth.ts |  19 ++
 .../portal/src/utils/identifier.ts            |  22 ++
 .../portal/src/utils/passwordSchema.ts        |  36 ++
 31 files changed, 1350 insertions(+), 250 deletions(-)
 create mode 100644 apps/edr-freight-api/src/modules/auth/customer-reset.controller.ts
 create mode 100644 apps/edr-freight-api/src/modules/auth/customer-reset.service.ts
 create mode 100644 apps/edr-freight-api/src/modules/auth/dto/forgot-password.dto.ts
 create mode 100644 apps/edr-freight-api/src/modules/auth/forgot-password.controller.ts
 create mode 100644 apps/edr-freight-api/src/modules/auth/forgot-password.service.ts
 create mode 100644 apps/edr-freight-web/backoffice/src/components/customers/ResetPasswordAction.tsx
 create mode 100644 apps/edr-freight-web/portal/src/components/auth/OtpChannelStep.tsx
 create mode 100644 apps/edr-freight-web/portal/src/components/auth/PasswordChecklist.tsx
 create mode 100644 apps/edr-freight-web/portal/src/hooks/useResendCooldown.ts
 create mode 100644 apps/edr-freight-web/portal/src/pages/accounts/ForgotPasswordPage.tsx
 create mode 100644 apps/edr-freight-web/portal/src/utils/identifier.ts
 create mode 100644 apps/edr-freight-web/portal/src/utils/passwordSchema.ts

diff --git a/apps/edr-freight-api/src/modules/auth/customer-reset.controller.ts b/apps/edr-freight-api/src/modules/auth/customer-reset.controller.ts
new file mode 100644
index 000000000..2bf9f82fd
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/auth/customer-reset.controller.ts
@@ -0,0 +1,48 @@
+import {
+  Body,
+  Controller,
+  NotFoundException,
+  Param,
+  ParseUUIDPipe,
+  Post,
+} from "@nestjs/common";
+import { ApiBearerAuth, ApiOperation, ApiTags } from "@nestjs/swagger";
+
+import { BookingStaff } from "../../common/booking-guards";
+import { FREIGHT_PERMS } from "../../seed/freight-permissions.registry";
+import { BackofficeResetPasswordDto } from "./dto/forgot-password.dto";
+import { CustomerResetService } from "./customer-reset.service";
+
+/**
+ * Staff-triggered password reset. The customer receives the code and sets their
+ * own password — staff never see or handle a credential.
+ */
+@ApiTags("backoffice")
+@Controller("backoffice/customers")
+@ApiBearerAuth()
+export class CustomerResetController {
+  constructor(private readonly customerResetService: CustomerResetService) {}
+
+  @Post(":companyId/reset-password")
+  @BookingStaff(FREIGHT_PERMS.customers.resetPassword)
+  @ApiOperation({
+    summary: "Send a password-reset code to a customer's primary contact",
+  })
+  async resetPassword(
+    @Param("companyId", ParseUUIDPipe) companyId: string,
+    @Body() dto: BackofficeResetPasswordDto,
+  ) {
+    const maskedTarget = await this.customerResetService.sendResetToCustomer(
+      companyId,
+      dto.channel,
+    );
+
+    if (!maskedTarget) {
+      throw new NotFoundException(
+        `No active primary contact with ${dto.channel === "email" ? "an email address" : "a phone number"} for this customer`,
+      );
+    }
+
+    return { channel: dto.channel, maskedTarget };
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/auth/customer-reset.service.ts b/apps/edr-freight-api/src/modules/auth/customer-reset.service.ts
new file mode 100644
index 000000000..4c8f67599
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/auth/customer-reset.service.ts
@@ -0,0 +1,59 @@
+import { Injectable, Logger } from "@nestjs/common";
+import { InjectRepository } from "@nestjs/typeorm";
+import { Repository } from "typeorm";
+
+import { ExternalProfile } from "../companies/entities/external-profile.entity";
+import { ResetChannel } from "./dto/forgot-password.dto";
+import { ForgotPasswordService } from "./forgot-password.service";
+
+@Injectable()
+export class CustomerResetService {
+  private readonly logger = new Logger(CustomerResetService.name);
+
+  constructor(
+    @InjectRepository(ExternalProfile)
+    private readonly externalProfileRepository: Repository<ExternalProfile>,
+    private readonly forgotPasswordService: ForgotPasswordService,
+  ) {}
+
+  /**
+   * Send a reset code to the company's primary contact. Returns the masked
+   * destination, or null when there is no eligible account for that channel.
+   *
+   * Unlike the public flow this reports failure honestly — the caller is an
+   * authenticated staff member, so there is nothing to enumerate.
+   */
+  async sendResetToCustomer(
+    companyId: string,
+    channel: ResetChannel,
+  ): Promise<string | null> {
+    const profile = await this.externalProfileRepository.findOne({
+      where: { companyId, isPrimaryContact: true },
+    });
+
+    if (!profile) {
+      this.logger.warn(`Company ${companyId} has no primary contact profile`);
+      return null;
+    }
+
+    // Resolve through the same active-account gate the public flow uses, so a
+    // suspended customer cannot be reactivated by a staff-triggered reset.
+    const user = await this.forgotPasswordService.resolveActiveUserById(
+      profile.userId,
+    );
+    if (!user) {
+      this.logger.warn(
+        `Primary contact ${profile.userId} of company ${companyId} is not an active account`,
+      );
+      return null;
+    }
+
+    const target = await this.forgotPasswordService.requestReset(user, channel);
+    if (!target) return null;
+
+    this.logger.log(
+      `Staff-triggered ${channel} reset sent to user ${user.id} (company ${companyId})`,
+    );
+    return this.forgotPasswordService.maskTarget(target);
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/auth/dto/forgot-password.dto.ts b/apps/edr-freight-api/src/modules/auth/dto/forgot-password.dto.ts
new file mode 100644
index 000000000..be2f9bdac
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/auth/dto/forgot-password.dto.ts
@@ -0,0 +1,35 @@
+import { ApiProperty } from "@nestjs/swagger";
+import { IsEnum, IsNotEmpty, IsString } from "class-validator";
+
+/** The channel the reset code is delivered over. */
+export enum ResetChannel {
+  Email = "email",
+  Phone = "phone",
+}
+
+export class ForgotPasswordRequestDto {
+  @ApiProperty({
+    description: "Email, username, or phone number of the account to reset",
+    example: "name@company.com",
+  })
+  @IsString()
+  @IsNotEmpty()
+  identifier!: string;
+
+  @ApiProperty({ enum: ResetChannel })
+  @IsEnum(ResetChannel)
+  channel!: ResetChannel;
+}
+
+export class ForgotPasswordVerifyDto extends ForgotPasswordRequestDto {
+  @ApiProperty({ description: "The 6-digit code sent to the chosen channel" })
+  @IsString()
+  @IsNotEmpty()
+  otp!: string;
+}
+
+export class BackofficeResetPasswordDto {
+  @ApiProperty({ enum: ResetChannel })
+  @IsEnum(ResetChannel)
+  channel!: ResetChannel;
+}
diff --git a/apps/edr-freight-api/src/modules/auth/forgot-password.controller.ts b/apps/edr-freight-api/src/modules/auth/forgot-password.controller.ts
new file mode 100644
index 000000000..da49982d2
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/auth/forgot-password.controller.ts
@@ -0,0 +1,69 @@
+import { Body, Controller, Logger, Post } from "@nestjs/common";
+import { ApiOperation, ApiTags } from "@nestjs/swagger";
+import { Public } from "@edr/api-common";
+
+import {
+  ForgotPasswordRequestDto,
+  ForgotPasswordVerifyDto,
+} from "./dto/forgot-password.dto";
+import { ForgotPasswordService, ResetTicket } from "./forgot-password.service";
+
+/**
+ * Freight-owned reset flow. IAM ships a `forgot-password` route, but it only
+ * ever SMSes a magic link (no email channel, and it needs `FE_BASE_URL`, which
+ * this API does not set). These routes drive freight's own email-or-phone OTP
+ * service instead, then hand back a ticket for IAM's public `set-password`.
+ */
+@ApiTags("auth")
+@Controller("auth")
+@Public()
+export class ForgotPasswordController {
+  private readonly logger = new Logger(ForgotPasswordController.name);
+
+  constructor(private readonly forgotPasswordService: ForgotPasswordService) {}
+
+  @Post("forgot-password/request")
+  @ApiOperation({
+    summary: "Send a password-reset code over email or SMS",
+    description:
+      "Always reports success. An unknown, inactive, or channel-less account is " +
+      "indistinguishable from a real one, so this cannot be used to enumerate accounts.",
+  })
+  async request(@Body() dto: ForgotPasswordRequestDto): Promise<{ success: true }> {
+    const user = await this.forgotPasswordService.resolveActiveUser(dto.identifier);
+
+    if (user) {
+      try {
+        await this.forgotPasswordService.requestReset(user, dto.channel);
+      } catch (error) {
+        // A delivery failure must not change the response shape either — log it
+        // and let the caller sit on the OTP screen.
+        this.logger.error(
+          `Reset code delivery failed for user ${user.id}: ${
+            error instanceof Error ? error.message : String(error)
+          }`,
+          error instanceof Error ? error.stack : undefined,
+        );
+      }
+    } else {
+      this.logger.log("Reset requested for an unknown or inactive account");
+    }
+
+    return { success: true };
+  }
+
+  @Post("forgot-password/verify")
+  @ApiOperation({
+    summary: "Exchange a valid reset code for a single-use set-password ticket",
+    description:
+      "The returned { userId, verificationCode } is the body for PATCH /api/auth/set-password, " +
+      "alongside the same identifier and the new password.",
+  })
+  verify(@Body() dto: ForgotPasswordVerifyDto): Promise<ResetTicket> {
+    return this.forgotPasswordService.verifyAndMintTicket(
+      dto.identifier,
+      dto.channel,
+      dto.otp,
+    );
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/auth/forgot-password.service.ts b/apps/edr-freight-api/src/modules/auth/forgot-password.service.ts
new file mode 100644
index 000000000..42dc723d5
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/auth/forgot-password.service.ts
@@ -0,0 +1,169 @@
+import { randomBytes } from "node:crypto";
+
+import { BadRequestException, Injectable, Logger } from "@nestjs/common";
+import { InjectDataSource, InjectRepository } from "@nestjs/typeorm";
+import { DataSource, Repository } from "typeorm";
+
+import { hashPassword } from "@tria-plc/api-common/utils/argon";
+import { EOtpType } from "@tria-plc/iamapi-common/enums/otp.enum";
+import { User } from "@tria-plc/iamapi-common/entities/iam/user/user.entity";
+import { UserVerification } from "@tria-plc/iamapi-common/entities/iam/user/user-verification.entity";
+
+import { OtpService, OtpTarget } from "../otp/otp.service";
+import { ResetChannel } from "./dto/forgot-password.dto";
+
+/**
+ * How long the reset ticket minted for `PATCH /api/auth/set-password` stays
+ * valid. The IAM `setPassword` handler enforces this via `expiresAt`.
+ */
+const RESET_TICKET_TTL_MS = 10 * 60 * 1000;
+
+/** How long the emailed/SMS'd OTP stays valid before it must be re-requested. */
+const RESET_OTP_TTL_MS = 10 * 60 * 1000;
+
+export interface ResetTicket {
+  userId: string;
+  verificationCode: string;
+}
+
+@Injectable()
+export class ForgotPasswordService {
+  private readonly logger = new Logger(ForgotPasswordService.name);
+
+  constructor(
+    @InjectRepository(User)
+    private readonly userRepository: Repository<User>,
+    @InjectDataSource()
+    private readonly dataSource: DataSource,
+    private readonly otpService: OtpService,
+  ) {}
+
+  /**
+   * Resolve an account that is actually eligible for a password reset.
+   *
+   * IAM's `set-password` handler flips `isActive: true` on the user as a side
+   * effect, so a reset on a deactivated account would silently resurrect it.
+   * Gating here — rather than at the set-password call — is what keeps that
+   * from being reachable. Mirrors IAM's own login lookup: match on any of
+   * email / username / phone, and require an active credential row.
+   */
+  async resolveActiveUser(identifier: string): Promise<User | null> {
+    const id = identifier.trim();
+    if (!id) return null;
+
+    return await this.activeUserQuery()
+      .andWhere(
+        "(LOWER(u.email) = LOWER(:id) OR u.username = :id OR u.phoneNumber = :id)",
+        { id },
+      )
+      .getOne();
+  }
+
+  /** Same eligibility gate as {@link resolveActiveUser}, keyed by IAM user id. */
+  async resolveActiveUserById(userId: string): Promise<User | null> {
+    if (!userId) return null;
+    return await this.activeUserQuery()
+      .andWhere("u.id = :userId", { userId })
+      .getOne();
+  }
+
+  /**
+   * Base query for accounts eligible to reset. `.where()` is claimed here so
+   * callers must use `.andWhere()` — TypeORM's `.where()` resets the clause,
+   * which would silently drop the `isActive` gate.
+   */
+  private activeUserQuery() {
+    return this.userRepository
+      .createQueryBuilder("u")
+      .innerJoin("u.userCredentials", "uc", "uc.isActive = true")
+      .where("u.isActive = true")
+      .orderBy("u.createdAt", "DESC");
+  }
+
+  /** The address the code goes to, taken from the account — never from input. */
+  private targetFor(user: User, channel: ResetChannel): OtpTarget | null {
+    if (channel === ResetChannel.Email) {
+      return user.email ? { email: user.email } : null;
+    }
+    return user.phoneNumber ? { phone: user.phoneNumber } : null;
+  }
+
+  /**
+   * Send a reset code to the account's own email/phone. Returns the target so
+   * authenticated (backoffice) callers can echo a masked version; unauthenticated
+   * callers must discard it.
+   *
+   * Note: `otp_verifications` keys rows by a unique phone/email, and `sendOtp`
+   * upserts. A reset request therefore overwrites any pending signup code for
+   * the same address — last code sent wins. That is the pre-existing behaviour
+   * between any two flows sharing this table.
+   */
+  async requestReset(
+    user: User,
+    channel: ResetChannel,
+  ): Promise<OtpTarget | null> {
+    const target = this.targetFor(user, channel);
+    if (!target) return null;
+
+    await this.otpService.sendOtp(target);
+    return target;
+  }
+
+  /**
+   * Prove possession of the OTP, then mint an IAM reset ticket the caller can
+   * spend on the public `PATCH /api/auth/set-password`.
+   *
+   * Minting a `UserVerification` row rather than writing `UserCredential`
+   * ourselves keeps IAM as the single owner of the password write path (old
+   * credential deactivation, argon hashing, changed-at bookkeeping).
+   */
+  async verifyAndMintTicket(
+    identifier: string,
+    channel: ResetChannel,
+    otp: string,
+  ): Promise<ResetTicket> {
+    const user = await this.resolveActiveUser(identifier);
+    const target = user && this.targetFor(user, channel);
+
+    if (!user?.id || !target) {
+      // Same shape as a wrong code: a caller probing for accounts learns nothing
+      // beyond what the request step already (deliberately) refuses to tell them.
+      throw new BadRequestException("Invalid verification code");
+    }
+
+    await this.otpService.verifyOtpForAction(target, otp, RESET_OTP_TTL_MS);
+
+    const code = randomBytes(24).toString("base64url");
+    const verificationCode = await hashPassword(code);
+    const userId = user.id;
+
+    await this.dataSource.transaction(async (manager) => {
+      const repo = manager.getRepository(UserVerification);
+      // Retire any outstanding codes so only the ticket we just minted can be
+      // spent — `findVerificationForPrimaryReset` reads the newest row.
+      await repo.update({ userId }, { isUsed: true });
+      await repo.insert({
+        userId,
+        otpType: EOtpType.RESET_PASSWORD,
+        verificationCode,
+        expiresAt: new Date(Date.now() + RESET_TICKET_TTL_MS),
+        isUsed: false,
+        attemptCount: 0,
+      });
+    });
+
+    this.logger.log(`Reset ticket minted for user ${userId}`);
+    return { userId, verificationCode: code };
+  }
+
+  /** `+251911234567` -> `+251•••••4567`; `ab@x.com` -> `a•@x.com`. */
+  maskTarget(target: OtpTarget): string {
+    if (target.email) {
+      const [local, domain] = target.email.split("@");
+      const head = local.slice(0, 1);
+      return `${head}${"•".repeat(Math.max(local.length - 1, 1))}@${domain}`;
+    }
+    const phone = target.phone ?? "";
+    return `${phone.slice(0, 4)}${"•".repeat(Math.max(phone.length - 8, 1))}${phone.slice(-4)}`;
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/auth/freight-auth.module.ts b/apps/edr-freight-api/src/modules/auth/freight-auth.module.ts
index 16fbeffda..6415cf4c1 100644
--- a/apps/edr-freight-api/src/modules/auth/freight-auth.module.ts
+++ b/apps/edr-freight-api/src/modules/auth/freight-auth.module.ts
@@ -2,15 +2,35 @@ import { Module } from '@nestjs/common';
 import { TypeOrmModule } from '@nestjs/typeorm';
 
 import { User } from '@tria-plc/iamapi-common/entities/iam/user/user.entity';
+import { UserVerification } from '@tria-plc/iamapi-common/entities/iam/user/user-verification.entity';
 
+import { ExternalProfile } from '../companies/entities/external-profile.entity';
+import { OtpModule } from '../otp/otp.module';
 import { CheckAvailabilityController } from './check-availability.controller';
 import { CheckAvailabilityService } from './check-availability.service';
+import { CustomerResetController } from './customer-reset.controller';
+import { CustomerResetService } from './customer-reset.service';
+import { ForgotPasswordController } from './forgot-password.controller';
+import { ForgotPasswordService } from './forgot-password.service';
 import { FreightMeController } from './freight-me.controller';
 import { FreightMeService } from './freight-me.service';
 
 @Module({
-  imports: [TypeOrmModule.forFeature([User])],
-  controllers: [FreightMeController, CheckAvailabilityController],
-  providers: [FreightMeService, CheckAvailabilityService],
+  imports: [
+    TypeOrmModule.forFeature([User, UserVerification, ExternalProfile]),
+    OtpModule,
+  ],
+  controllers: [
+    FreightMeController,
+    CheckAvailabilityController,
+    ForgotPasswordController,
+    CustomerResetController,
+  ],
+  providers: [
+    FreightMeService,
+    CheckAvailabilityService,
+    ForgotPasswordService,
+    CustomerResetService,
+  ],
 })
 export class FreightAuthModule {}
diff --git a/apps/edr-freight-api/src/modules/contracts/contract-transition.service.ts b/apps/edr-freight-api/src/modules/contracts/contract-transition.service.ts
index 9f12b937d..1634034bf 100644
--- a/apps/edr-freight-api/src/modules/contracts/contract-transition.service.ts
+++ b/apps/edr-freight-api/src/modules/contracts/contract-transition.service.ts
@@ -582,7 +582,7 @@ export class ContractTransitionService {
       if (!dto.otpPhone || !dto.otp) {
         throw new BadRequestException('OTP verification is required to sign the contract');
       }
-      await this.otpService.verifyOtpForAction(dto.otpPhone, dto.otp);
+      await this.otpService.verifyOtpForAction({ phone: dto.otpPhone }, dto.otp);
       await this.applySignature(contract, dto, options);
       await this.contractsRepository.update(contractId, {
         status: 'SIGNED_CUSTOMER',
diff --git a/apps/edr-freight-api/src/modules/otp/otp.service.ts b/apps/edr-freight-api/src/modules/otp/otp.service.ts
index e26ed35c9..b98b41d8d 100644
--- a/apps/edr-freight-api/src/modules/otp/otp.service.ts
+++ b/apps/edr-freight-api/src/modules/otp/otp.service.ts
@@ -50,6 +50,9 @@ export class OtpService {
         await this.otpRepository.createOtp(target, otp);
       }
 
+      // A freshly issued code gets a fresh guess budget.
+      this.actionAttempts.delete(this.targetKey(target));
+
       if (target.email) {
         // send email (queued to RabbitMQ via the shared Email service)
         await this.emailClient.sendEmail({
@@ -121,24 +124,44 @@ export class OtpService {
   // ---------------------------------------------------------------------------
 
   // Fresh, single-use challenge gating a sensitive action (e.g. applying a
-  // contract signature). Unlike verifyOtp above — which marks a phone verified
-  // and leaves the code in place — this enforces a short TTL and consumes the
-  // code on success so it can never be replayed.
+  // contract signature, resetting a forgotten password). Unlike verifyOtp above
+  // — which marks a target verified and leaves the code in place — this enforces
+  // a TTL and consumes the code on success so it can never be replayed.
   private readonly ACTION_OTP_TTL_MS = 5 * 60 * 1000;
 
-  async verifyOtpForAction(phone: string, otp: string) {
-    const otpData = await this.otpRepository.findByPhone(phone);
+  // Without a cap, a 6-digit code guarding a password reset is brute-forceable
+  // within its own TTL. `otp_verifications` has no attempt column, so the
+  // counter lives here and the code is burned once the budget is spent.
+  // Per-process: it resets on restart and is not shared across replicas — a
+  // persisted counter needs a migration on OtpVerification.
+  private readonly MAX_ACTION_ATTEMPTS = 5;
+  private readonly actionAttempts = new Map<string, number>();
+
+  private targetKey(target: OtpTarget): string {
+    return target.email ? `email:${target.email}` : `phone:${target.phone}`;
+  }
+
+  async verifyOtpForAction(
+    target: OtpTarget,
+    otp: string,
+    ttlMs: number = this.ACTION_OTP_TTL_MS,
+  ) {
+    const otpData = await this.otpRepository.findByTarget(target);
+    const key = this.targetKey(target);
 
     if (!otpData) {
       throw new BadRequestException(
-        "No verification code was requested for this phone",
+        target.email
+          ? "No verification code was requested for this email"
+          : "No verification code was requested for this phone",
       );
     }
 
     const ageMs = Date.now() - new Date(otpData.updatedAt).getTime();
 
-    if (ageMs > this.ACTION_OTP_TTL_MS) {
+    if (ageMs > ttlMs) {
       await this.otpRepository.deleteOtp(otpData);
+      this.actionAttempts.delete(key);
 
       throw new BadRequestException(
         "Verification code has expired. Request a new one.",
@@ -146,11 +169,24 @@ export class OtpService {
     }
 
     if (otpData.otp !== otp) {
+      const attempts = (this.actionAttempts.get(key) ?? 0) + 1;
+
+      if (attempts >= this.MAX_ACTION_ATTEMPTS) {
+        await this.otpRepository.deleteOtp(otpData);
+        this.actionAttempts.delete(key);
+
+        throw new BadRequestException(
+          "Too many incorrect attempts. Request a new code.",
+        );
+      }
+
+      this.actionAttempts.set(key, attempts);
       throw new BadRequestException("Invalid verification code");
     }
 
     // single-use: consume on success
     await this.otpRepository.deleteOtp(otpData);
+    this.actionAttempts.delete(key);
 
     return { success: true };
   }
diff --git a/apps/edr-freight-api/src/seed/freight-permissions.registry.ts b/apps/edr-freight-api/src/seed/freight-permissions.registry.ts
index d4d85e84c..62f531d5f 100644
--- a/apps/edr-freight-api/src/seed/freight-permissions.registry.ts
+++ b/apps/edr-freight-api/src/seed/freight-permissions.registry.ts
@@ -131,6 +131,7 @@ export const CUSTOMER_PERMISSIONS: FreightPermissionSeed[] = [
   perm('d1a00001-0001-4000-8000-000000000003', 'edr_freight_app:customers:update', 'Update customer'),
   perm('d1a00001-0001-4000-8000-000000000004', 'edr_freight_app:customers:deactivate', 'Deactivate customer'),
   perm('d1a00001-0001-4000-8000-000000000005', 'edr_freight_app:customers:verify', 'Verify customer (KYC/Fayda)'),
+  perm('d1a00001-0001-4000-8000-000000000006', 'edr_freight_app:customers:reset-password', 'Trigger customer password reset'),
 ];
 
 // D. Finance — payments + invoices
@@ -394,6 +395,7 @@ export const FREIGHT_PERMS = {
     update: 'edr_freight_app:customers:update',
     deactivate: 'edr_freight_app:customers:deactivate',
     verify: 'edr_freight_app:customers:verify',
+    resetPassword: 'edr_freight_app:customers:reset-password',
   },
   payments: {
     view: 'edr_freight_app:payments:view',
diff --git a/apps/edr-freight-web/backoffice/src/components/customers/ResetPasswordAction.tsx b/apps/edr-freight-web/backoffice/src/components/customers/ResetPasswordAction.tsx
new file mode 100644
index 000000000..bc505a21f
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/customers/ResetPasswordAction.tsx
@@ -0,0 +1,105 @@
+import { Button, Modal, Radio, Stack, Text } from "@mantine/core";
+import { useMutation } from "@tanstack/react-query";
+import { KeyRound } from "lucide-react";
+import { useState } from "react";
+
+import { useAuth } from "@/auth/useAuth";
+import { useToast } from "@/hooks/use-toast";
+import { FREIGHT_PERMS, hasPermission } from "@/lib/permissions";
+import { api } from "@/services/api";
+import type { Company, ResetChannel } from "@/types/customer";
+
+export interface ResetPasswordActionProps {
+  company: Pick<Company, "id" | "email" | "phone">;
+}
+
+/**
+ * Staff-triggered password reset. Sends a one-time code to the customer's
+ * primary contact; the customer picks their own new password. No credential is
+ * ever shown to or handled by staff.
+ */
+export default function ResetPasswordAction({ company }: ResetPasswordActionProps) {
+  const { user } = useAuth();
+  const { toast } = useToast();
+  const [opened, setOpened] = useState(false);
+  const [channel, setChannel] = useState<ResetChannel>("phone");
+
+  const { mutate, isPending } = useMutation(
+    api.customers.resetPassword.mutationOptions({
+      onSuccess: (result) => {
+        setOpened(false);
+        toast({
+          title: "Reset code sent",
+          description: `The customer can now reset their password using the code sent to ${result.maskedTarget}.`,
+        });
+      },
+      onError: (error) => {
+        toast({
+          title: "Could not send reset code",
+          description: error.message,
+          variant: "destructive",
+        });
+      },
+    }),
+  );
+
+  if (!hasPermission(user, FREIGHT_PERMS.customers.resetPassword)) return null;
+
+  return (
+    <>
+      <Button
+        variant="default"
+        leftSection={<KeyRound size={16} />}
+        onClick={() => setOpened(true)}
+      >
+        Reset password
+      </Button>
+
+      <Modal
+        opened={opened}
+        onClose={() => setOpened(false)}
+        title="Send a password-reset code"
+        centered
+      >
+        <Stack gap="md">
+          <Text size="sm" c="dimmed">
+            We&apos;ll send a one-time code to this customer&apos;s primary contact.
+            They choose their own new password — you will not see it.
+          </Text>
+
+          <Radio.Group
+            value={channel}
+            onChange={(v) => setChannel(v as ResetChannel)}
+            label="Send the code via"
+          >
+            <Stack gap="xs" mt="xs">
+              <Radio
+                value="phone"
+                label="SMS"
+                description={company.phone ?? "No phone on the company record"}
+              />
+              <Radio
+                value="email"
+                label="Email"
+                description={company.email ?? "No email on the company record"}
+              />
+            </Stack>
+          </Radio.Group>
+
+          <Text size="xs" c="dimmed">
+            The code goes to the primary contact&apos;s own email or phone, which
+            may differ from the company contact details shown above.
+          </Text>
+
+          <Button
+            color="edr-green"
+            loading={isPending}
+            onClick={() => mutate({ companyId: company.id, channel })}
+          >
+            Send reset code
+          </Button>
+        </Stack>
+      </Modal>
+    </>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/customers/index.ts b/apps/edr-freight-web/backoffice/src/components/customers/index.ts
index 2a87e3b0c..d42673d2b 100644
--- a/apps/edr-freight-web/backoffice/src/components/customers/index.ts
+++ b/apps/edr-freight-web/backoffice/src/components/customers/index.ts
@@ -13,5 +13,9 @@ export {
   ChangeRequestReview,
   ChangeRequestPendingBadge,
 } from "./ChangeRequestReview";
+export {
+  default as ResetPasswordAction,
+  type ResetPasswordActionProps,
+} from "./ResetPasswordAction";
 export { formatBytes, formatDate, formatMoney, humanize } from "./format";
 export { TableCard, type TableCardProps } from "./TableCard";
diff --git a/apps/edr-freight-web/backoffice/src/constants/URLS.ts b/apps/edr-freight-web/backoffice/src/constants/URLS.ts
index 77a3bc95e..c6f98c8a2 100644
--- a/apps/edr-freight-web/backoffice/src/constants/URLS.ts
+++ b/apps/edr-freight-web/backoffice/src/constants/URLS.ts
@@ -86,6 +86,8 @@ export const URL_CONSTANTS = {
       `/bookings/by-company/${id}/customer-view`,
     PAYMENTS_CUSTOMER_VIEW: (id: string) =>
       `/payments/by-company/${id}/customer-view`,
+    RESET_PASSWORD: (companyId: string) =>
+      `/backoffice/customers/${companyId}/reset-password`,
   },
 
   BILLING: {
diff --git a/apps/edr-freight-web/backoffice/src/lib/permissions.ts b/apps/edr-freight-web/backoffice/src/lib/permissions.ts
index c8bfa7c84..a7d8c16c1 100644
--- a/apps/edr-freight-web/backoffice/src/lib/permissions.ts
+++ b/apps/edr-freight-web/backoffice/src/lib/permissions.ts
@@ -62,6 +62,7 @@ export const FREIGHT_PERMS = {
     update: "edr_freight_app:customers:update",
     deactivate: "edr_freight_app:customers:deactivate",
     verify: "edr_freight_app:customers:verify",
+    resetPassword: "edr_freight_app:customers:reset-password",
   },
   payments: {
     view: "edr_freight_app:payments:view",
diff --git a/apps/edr-freight-web/backoffice/src/pages/customers/CustomerDetailPage.tsx b/apps/edr-freight-web/backoffice/src/pages/customers/CustomerDetailPage.tsx
index c68a4ca25..317f915fb 100644
--- a/apps/edr-freight-web/backoffice/src/pages/customers/CustomerDetailPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/customers/CustomerDetailPage.tsx
@@ -43,6 +43,7 @@ import {
   ProfileChips,
   ProfileStatusBadge,
   ProfileTypeBadge,
+  ResetPasswordAction,
   TableCard,
   formatBytes,
   formatDate,
@@ -573,6 +574,7 @@ export default function CustomerDetailPage() {
             <ChangeRequestPendingBadge companyId={company.id} />
           </Group>
         }
+        action={<ResetPasswordAction company={company} />}
       />
 
       <Tabs defaultValue="overview">
diff --git a/apps/edr-freight-web/backoffice/src/services/api.ts b/apps/edr-freight-web/backoffice/src/services/api.ts
index 7710e077f..4f04e3358 100644
--- a/apps/edr-freight-web/backoffice/src/services/api.ts
+++ b/apps/edr-freight-web/backoffice/src/services/api.ts
@@ -12,6 +12,8 @@ import type {
   CustomerPayment,
   PaginatedCompanies,
   ProfileStatus,
+  ResetChannel,
+  ResetPasswordResult,
 } from "@/types/customer";
 import {
   CreateDropdownOptionDto,
@@ -2261,6 +2263,16 @@ export const api = {
       ({ id }) => QUERY_KEYS.CUSTOMERS.payments(id),
     ),
 
+    resetPassword: endpoint<
+      { companyId: string; channel: ResetChannel },
+      ResetPasswordResult
+    >(
+      "customers",
+      "resetPassword",
+      ({ companyId, channel }) =>
+        customersService.resetPassword(companyId, channel),
+    ),
+
     setProfileStatus: endpoint<
       { profileId: string; status: ProfileStatus; note?: string },
       CompanyProfile
diff --git a/apps/edr-freight-web/backoffice/src/services/customers.service.ts b/apps/edr-freight-web/backoffice/src/services/customers.service.ts
index cafe0aece..0476d41bb 100644
--- a/apps/edr-freight-web/backoffice/src/services/customers.service.ts
+++ b/apps/edr-freight-web/backoffice/src/services/customers.service.ts
@@ -11,6 +11,8 @@ import type {
   CustomerPayment,
   PaginatedCompanies,
   ProfileStatus,
+  ResetChannel,
+  ResetPasswordResult,
 } from "@/types/customer";
 
 const cleanParams = (params: object) =>
@@ -81,6 +83,22 @@ export const customersService = {
       .then((r) => r.data);
   },
 
+  /**
+   * Send a password-reset code to the company's primary contact. Staff never
+   * receive a credential — the customer sets their own password from the code.
+   */
+  resetPassword(
+    companyId: string,
+    channel: ResetChannel,
+  ): Promise<ResetPasswordResult> {
+    return apiClient
+      .post<ResetPasswordResult>(
+        URL_CONSTANTS.COMPANIES.RESET_PASSWORD(companyId),
+        { channel },
+      )
+      .then((r) => r.data);
+  },
+
   setProfileStatus(
     profileId: string,
     status: ProfileStatus,
diff --git a/apps/edr-freight-web/backoffice/src/types/customer.ts b/apps/edr-freight-web/backoffice/src/types/customer.ts
index 8d76571d4..7328decf0 100644
--- a/apps/edr-freight-web/backoffice/src/types/customer.ts
+++ b/apps/edr-freight-web/backoffice/src/types/customer.ts
@@ -99,6 +99,15 @@ export interface CompanyChangeRequest {
   updatedAt: string;
 }
 
+/** The channel a customer's password-reset code is delivered over. */
+export type ResetChannel = "email" | "phone";
+
+export interface ResetPasswordResult {
+  channel: ResetChannel;
+  /** Where the code went, e.g. `+251•••4821` — safe to show to staff. */
+  maskedTarget: string;
+}
+
 /** Mirrors backend `Company` (+ its `companyProfiles`). */
 export interface Company {
   id: string;
diff --git a/apps/edr-freight-web/portal/src/App.tsx b/apps/edr-freight-web/portal/src/App.tsx
index 697c2f89c..e4c5685fd 100644
--- a/apps/edr-freight-web/portal/src/App.tsx
+++ b/apps/edr-freight-web/portal/src/App.tsx
@@ -32,6 +32,7 @@ import EDRFreightLandingPage from "./pages/EDRFreightLandingPage";
 import MyPortalPage from "./pages/MyPortalPage";
 import MySignaturePage from "./pages/MySignaturePage";
 import SettingsPage from "./pages/SettingsPage";
+import ForgotPasswordPage from "./pages/accounts/ForgotPasswordPage";
 import LoginPage from "./pages/accounts/LoginPage";
 import SetPasswordPage from "./pages/accounts/SetPasswordPage";
 import SignupPage from "./pages/accounts/SignupPage";
@@ -252,6 +253,7 @@ const App = () => {
       <Route element={<RedirectIfAuthed />}>
         <Route path="/login" element={<LoginPage />} />
         <Route path="/signup" element={<SignupPage />} />
+        <Route path="/forgot-password" element={<ForgotPasswordPage />} />
       </Route>
 
       {/* Signup-flow pages; reached while a session already exists */}
diff --git a/apps/edr-freight-web/portal/src/components/auth/OtpChannelStep.tsx b/apps/edr-freight-web/portal/src/components/auth/OtpChannelStep.tsx
new file mode 100644
index 000000000..b61bb2eab
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/components/auth/OtpChannelStep.tsx
@@ -0,0 +1,179 @@
+import { Alert, Button, PinInput, SegmentedControl, Stack, Text } from "@mantine/core";
+import {
+  AlertCircle,
+  ArrowLeft,
+  Mail,
+  RotateCw,
+  ShieldCheck,
+  Smartphone,
+} from "lucide-react";
+
+import { maskEmail, maskPhone } from "@/utils/identifier";
+
+export type OtpChannel = "phone" | "email";
+
+export const OTP_LENGTH = 6;
+
+export interface OtpChannelSelectProps {
+  value: OtpChannel;
+  onChange: (channel: OtpChannel) => void;
+  disabled?: boolean;
+  label?: string;
+}
+
+/** Phone/email toggle deciding where the verification code is sent. */
+export function OtpChannelSelect({
+  value,
+  onChange,
+  disabled,
+  label = "Send verification code via",
+}: OtpChannelSelectProps) {
+  return (
+    <div className="space-y-1.5">
+      <Text size="sm" fw={500} c="edr-text">
+        {label}
+      </Text>
+      <SegmentedControl
+        fullWidth
+        disabled={disabled}
+        value={value}
+        onChange={(v) => onChange(v as OtpChannel)}
+        data={[
+          {
+            value: "phone",
+            label: (
+              <span className="flex items-center justify-center gap-1.5">
+                <Smartphone size={14} /> Phone
+              </span>
+            ),
+          },
+          {
+            value: "email",
+            label: (
+              <span className="flex items-center justify-center gap-1.5">
+                <Mail size={14} /> Email
+              </span>
+            ),
+          },
+        ]}
+      />
+    </div>
+  );
+}
+
+export interface OtpChannelStepProps {
+  channel: OtpChannel;
+  /** Raw email or phone the code went to; masked before display. */
+  target: string;
+  value: string;
+  onChange: (otp: string) => void;
+  onVerify: () => void;
+  onBack: () => void;
+  onResend: () => void;
+  /** Seconds until resend is allowed; 0 enables the button. */
+  resendIn: number;
+  sending: boolean;
+  verifying: boolean;
+  error: string | null;
+  title?: string;
+  description?: string;
+  submitLabel: string;
+}
+
+/**
+ * The "enter the code we sent you" stage. Shared by signup and the
+ * forgot-password flow — both send through the same `/api/otp/*` service.
+ */
+export default function OtpChannelStep({
+  channel,
+  target,
+  value,
+  onChange,
+  onVerify,
+  onBack,
+  onResend,
+  resendIn,
+  sending,
+  verifying,
+  error,
+  title,
+  description,
+  submitLabel,
+}: OtpChannelStepProps) {
+  const maskedTarget = channel === "email" ? maskEmail(target) : maskPhone(target);
+  const busy = sending || verifying;
+
+  return (
+    <Stack gap="md">
+      <div className="mb-1 flex justify-center">
+        <span className="flex h-12 w-12 items-center justify-center rounded-full bg-primary/10 text-primary">
+          <ShieldCheck size={22} />
+        </span>
+      </div>
+
+      <div className="space-y-1.5 text-center">
+        <h1 className="text-xl font-bold tracking-tight text-gray-900 sm:text-2xl">
+          {title ?? `Verify your ${channel === "email" ? "email" : "phone"}`}
+        </h1>
+        <p className="text-sm leading-relaxed text-gray-500">
+          We sent a {OTP_LENGTH}-digit code to{" "}
+          <span className="font-medium text-gray-700">{maskedTarget}</span>.{" "}
+          {description ?? "Enter it to continue."}
+        </p>
+      </div>
+
+      {error ? (
+        <Alert color="red" variant="light" icon={<AlertCircle size={18} />}>
+          {error}
+        </Alert>
+      ) : null}
+
+      <Stack gap={6} align="center">
+        <Text size="sm" fw={500} c="edr-text">
+          Verification code
+        </Text>
+        <PinInput
+          length={OTP_LENGTH}
+          type="number"
+          oneTimeCode
+          value={value}
+          placeholder="0"
+          disabled={verifying}
+          styles={{ input: { textAlign: "center" } }}
+          onChange={onChange}
+        />
+      </Stack>
+
+      <Button
+        color="edr-green"
+        fullWidth
+        loading={verifying}
+        disabled={verifying || value.trim().length !== OTP_LENGTH}
+        onClick={onVerify}
+      >
+        {submitLabel}
+      </Button>
+
+      <div className="flex items-center justify-between">
+        <Button
+          variant="subtle"
+          color="gray"
+          leftSection={<ArrowLeft size={14} />}
+          disabled={busy}
+          onClick={onBack}
+        >
+          Back
+        </Button>
+        <Button
+          variant="subtle"
+          color="edr-green"
+          leftSection={<RotateCw size={14} />}
+          disabled={resendIn > 0 || busy}
+          onClick={onResend}
+        >
+          {resendIn > 0 ? `Resend in ${resendIn}s` : "Resend code"}
+        </Button>
+      </div>
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/components/auth/PasswordChecklist.tsx b/apps/edr-freight-web/portal/src/components/auth/PasswordChecklist.tsx
new file mode 100644
index 000000000..89cea7a0e
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/components/auth/PasswordChecklist.tsx
@@ -0,0 +1,41 @@
+import { Check, X } from "lucide-react";
+
+import { passwordRequirements } from "@/utils/passwordSchema";
+
+export interface PasswordChecklistProps {
+  /** The current password value; the checklist hides itself when empty. */
+  value: string;
+}
+
+/** Live pass/fail list of the password rules, shown under a password field. */
+export default function PasswordChecklist({ value }: PasswordChecklistProps) {
+  if (!value) return null;
+
+  return (
+    <div className="mt-2 space-y-1">
+      {passwordRequirements.map((req) => {
+        const met = req.test(value);
+        return (
+          <div key={req.label} className="flex items-center gap-2">
+            <span
+              className={`flex h-4 w-4 shrink-0 items-center justify-center rounded-full ${
+                met
+                  ? "bg-primary text-primary-foreground"
+                  : "bg-gray-200 text-gray-500"
+              }`}
+            >
+              {met ? (
+                <Check className="h-2.5 w-2.5" />
+              ) : (
+                <X className="h-2.5 w-2.5" />
+              )}
+            </span>
+            <span className={`text-xs ${met ? "text-primary" : "text-gray-500"}`}>
+              {req.label}
+            </span>
+          </div>
+        );
+      })}
+    </div>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/constants/URLS.ts b/apps/edr-freight-web/portal/src/constants/URLS.ts
index 89a3d57e7..5dfda7e58 100644
--- a/apps/edr-freight-web/portal/src/constants/URLS.ts
+++ b/apps/edr-freight-web/portal/src/constants/URLS.ts
@@ -5,6 +5,8 @@ export const URL_CONSTANTS = {
     REFRESH_TOKEN: "/api/auth/refresh-token",
     LOGOUT: "/api/auth/logout",
     PROFILE: "/auth/profile",
+    FORGOT_PASSWORD_REQUEST: "/api/auth/forgot-password/request",
+    FORGOT_PASSWORD_VERIFY: "/api/auth/forgot-password/verify",
   },
 
   USERS: {
diff --git a/apps/edr-freight-web/portal/src/hooks/useResendCooldown.ts b/apps/edr-freight-web/portal/src/hooks/useResendCooldown.ts
new file mode 100644
index 000000000..deeca8125
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/hooks/useResendCooldown.ts
@@ -0,0 +1,24 @@
+import { useEffect, useState } from "react";
+
+/** Seconds a user must wait before another OTP can be requested. */
+const DEFAULT_COOLDOWN_SECONDS = 60;
+
+/**
+ * Countdown that gates the "Resend code" button. Ticks with setTimeout rather
+ * than wall-clock arithmetic, so it needs no Date.now().
+ */
+export function useResendCooldown(seconds: number = DEFAULT_COOLDOWN_SECONDS) {
+  const [secondsLeft, setSecondsLeft] = useState(0);
+
+  useEffect(() => {
+    if (secondsLeft <= 0) return;
+    const t = setTimeout(() => setSecondsLeft((s) => s - 1), 1000);
+    return () => clearTimeout(t);
+  }, [secondsLeft]);
+
+  return {
+    secondsLeft,
+    start: () => setSecondsLeft(seconds),
+    reset: () => setSecondsLeft(0),
+  };
+}
diff --git a/apps/edr-freight-web/portal/src/pages/accounts/ForgotPasswordPage.tsx b/apps/edr-freight-web/portal/src/pages/accounts/ForgotPasswordPage.tsx
new file mode 100644
index 000000000..58cfeab43
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/accounts/ForgotPasswordPage.tsx
@@ -0,0 +1,312 @@
+import { type FormEvent, useState } from "react";
+import { Alert, Button, PasswordInput, Stack, TextInput } from "@mantine/core";
+import { AlertCircle, ArrowLeft, ArrowRight, KeyRound } from "lucide-react";
+import { Link, useNavigate } from "react-router-dom";
+
+import { useResendCooldown } from "@/hooks/useResendCooldown";
+import AuthShell from "@/components/auth/AuthShell";
+import OtpChannelStep, {
+  OTP_LENGTH,
+  OtpChannelSelect,
+  type OtpChannel,
+} from "@/components/auth/OtpChannelStep";
+import PasswordChecklist from "@/components/auth/PasswordChecklist";
+import { api } from "@/services/api";
+import type { ResetTicket } from "@/types/auth";
+import { normaliseIdentifier } from "@/utils/identifier";
+import { meetsAllRequirements } from "@/utils/passwordSchema";
+import { extractApiError } from "@/utils/result";
+
+type Stage = "identify" | "otp" | "password";
+
+export default function ForgotPasswordPage() {
+  const navigate = useNavigate();
+
+  const [stage, setStage] = useState<Stage>("identify");
+  const [identifier, setIdentifier] = useState("");
+  const [channel, setChannel] = useState<OtpChannel>("phone");
+  const [otpCode, setOtpCode] = useState("");
+  // The reset ticket lives in memory only — persisting it would leave a
+  // password-change credential sitting in localStorage.
+  const [ticket, setTicket] = useState<ResetTicket | null>(null);
+  const [password, setPassword] = useState("");
+  const [confirmPassword, setConfirmPassword] = useState("");
+
+  const [sending, setSending] = useState(false);
+  const [verifying, setVerifying] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const resendCooldown = useResendCooldown();
+
+  /** The identifier as the API will see it — normalised once, reused everywhere. */
+  const normalised = normaliseIdentifier(identifier);
+
+  const sendCode = async () => {
+    await api.auth.requestPasswordReset.call({ identifier: normalised, channel });
+    setOtpCode("");
+    resendCooldown.start();
+  };
+
+  // Stage 1 — ask for a code. The API answers identically for unknown accounts,
+  // so we always advance; a non-existent identifier simply never receives a code.
+  const handleIdentify = async (event: FormEvent<HTMLFormElement>) => {
+    event.preventDefault();
+    setError(null);
+    setSending(true);
+    try {
+      await sendCode();
+      setStage("otp");
+    } catch (err) {
+      setError(extractApiError(err).message);
+    } finally {
+      setSending(false);
+    }
+  };
+
+  const handleResend = async () => {
+    setError(null);
+    setSending(true);
+    try {
+      await sendCode();
+    } catch (err) {
+      setError(extractApiError(err).message);
+    } finally {
+      setSending(false);
+    }
+  };
+
+  // Stage 2 — trade the code for a single-use ticket.
+  const handleVerify = async () => {
+    setError(null);
+    if (otpCode.trim().length !== OTP_LENGTH) {
+      setError(`Enter the ${OTP_LENGTH}-digit code we sent you.`);
+      return;
+    }
+    setVerifying(true);
+    try {
+      const result = await api.auth.verifyPasswordResetOtp.call({
+        identifier: normalised,
+        channel,
+        otp: otpCode.trim(),
+      });
+      setTicket(result);
+      setStage("password");
+    } catch (err) {
+      setError(extractApiError(err).message);
+    } finally {
+      setVerifying(false);
+    }
+  };
+
+  // Stage 3 — spend the ticket on IAM's set-password.
+  const handleReset = async (event: FormEvent<HTMLFormElement>) => {
+    event.preventDefault();
+    setError(null);
+
+    if (!ticket) {
+      setError("Your reset session expired. Start again.");
+      setStage("identify");
+      return;
+    }
+    if (password !== confirmPassword) {
+      setError("Passwords do not match.");
+      return;
+    }
+
+    setVerifying(true);
+    try {
+      await api.auth.resetPassword.call({
+        userId: ticket.userId,
+        // The API matches this against email / username / phone, so the typed
+        // identifier works regardless of which one it is.
+        email: normalised,
+        verificationCode: ticket.verificationCode,
+        newPassword: password,
+        confirmPassword,
+      });
+      navigate("/login", {
+        replace: true,
+        state: { passwordReset: true },
+      });
+    } catch (err) {
+      setError(extractApiError(err).message);
+    } finally {
+      setVerifying(false);
+    }
+  };
+
+  const identifierLabel =
+    channel === "email" ? "the email on your account" : "the phone on your account";
+
+  return (
+    <AuthShell
+      tagline="Recover your account"
+      taglineBody="Reset your EDR Freight password with a one-time code sent to your email or phone."
+    >
+      <div className="flex w-full flex-col">
+        {stage === "identify" ? (
+          <form onSubmit={handleIdentify} className="flex w-full flex-col">
+            <div className="mb-1 flex justify-center">
+              <span className="flex h-12 w-12 items-center justify-center rounded-full bg-primary/10 text-primary">
+                <KeyRound size={22} />
+              </span>
+            </div>
+
+            <div className="mb-4 mt-3 space-y-1.5 text-center sm:mb-5">
+              <h1 className="text-xl font-bold tracking-tight text-gray-900 sm:text-2xl">
+                Forgot your password?
+              </h1>
+              <p className="text-sm leading-relaxed text-gray-500">
+                Enter your email or phone number and we&apos;ll send you a code to
+                reset it.
+              </p>
+            </div>
+
+            <Stack gap="md">
+              <TextInput
+                label="Email or Phone"
+                placeholder="name@company.com or 09XXXXXXXX"
+                autoComplete="username"
+                required
+                disabled={sending}
+                value={identifier}
+                onChange={(event) => setIdentifier(event.target.value)}
+              />
+
+              <OtpChannelSelect
+                value={channel}
+                onChange={setChannel}
+                disabled={sending}
+                label="Send the code to"
+              />
+
+              <p className="text-xs text-gray-500">
+                The code goes to {identifierLabel}, which may differ from what you
+                typed above.
+              </p>
+
+              {error ? (
+                <Alert color="red" variant="light" icon={<AlertCircle size={18} />}>
+                  {error}
+                </Alert>
+              ) : null}
+
+              <Button
+                type="submit"
+                color="edr-green"
+                fullWidth
+                loading={sending}
+                disabled={!identifier.trim()}
+                rightSection={!sending ? <ArrowRight size={16} /> : undefined}
+              >
+                Send code
+              </Button>
+
+              <p className="text-center text-sm text-gray-500">
+                Remembered it?{" "}
+                <Link to="/login" className="font-semibold text-primary hover:underline">
+                  Back to sign in
+                </Link>
+              </p>
+            </Stack>
+          </form>
+        ) : null}
+
+        {stage === "otp" ? (
+          <OtpChannelStep
+            channel={channel}
+            target={normalised}
+            value={otpCode}
+            onChange={setOtpCode}
+            onVerify={handleVerify}
+            onBack={() => {
+              setStage("identify");
+              setError(null);
+            }}
+            onResend={handleResend}
+            resendIn={resendCooldown.secondsLeft}
+            sending={sending}
+            verifying={verifying}
+            error={error}
+            title="Enter your reset code"
+            description="Enter it to choose a new password."
+            submitLabel="Verify code"
+          />
+        ) : null}
+
+        {stage === "password" ? (
+          <form onSubmit={handleReset} className="flex w-full flex-col">
+            <div className="mb-4 space-y-1.5 text-center sm:mb-5">
+              <h1 className="text-xl font-bold tracking-tight text-gray-900 sm:text-2xl">
+                Choose a new password
+              </h1>
+              <p className="text-sm leading-relaxed text-gray-500">
+                Pick something strong you haven&apos;t used before.
+              </p>
+            </div>
+
+            <Stack gap="md">
+              <div>
+                <PasswordInput
+                  label="New password"
+                  placeholder="Create a strong password"
+                  required
+                  disabled={verifying}
+                  value={password}
+                  onChange={(event) => setPassword(event.target.value)}
+                />
+                <PasswordChecklist value={password} />
+              </div>
+
+              <PasswordInput
+                label="Confirm new password"
+                placeholder="Re-enter your password"
+                required
+                disabled={verifying}
+                error={
+                  confirmPassword && confirmPassword !== password
+                    ? "Passwords do not match"
+                    : undefined
+                }
+                value={confirmPassword}
+                onChange={(event) => setConfirmPassword(event.target.value)}
+              />
+
+              {error ? (
+                <Alert color="red" variant="light" icon={<AlertCircle size={18} />}>
+                  {error}
+                </Alert>
+              ) : null}
+
+              <Button
+                type="submit"
+                color="edr-green"
+                fullWidth
+                loading={verifying}
+                disabled={
+                  verifying ||
+                  !meetsAllRequirements(password) ||
+                  password !== confirmPassword
+                }
+              >
+                Reset password
+              </Button>
+
+              <Button
+                variant="subtle"
+                color="gray"
+                leftSection={<ArrowLeft size={14} />}
+                disabled={verifying}
+                onClick={() => {
+                  setStage("otp");
+                  setError(null);
+                }}
+              >
+                Back
+              </Button>
+            </Stack>
+          </form>
+        ) : null}
+      </div>
+    </AuthShell>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/accounts/LoginPage.tsx b/apps/edr-freight-web/portal/src/pages/accounts/LoginPage.tsx
index 885888a05..7e8e512dd 100644
--- a/apps/edr-freight-web/portal/src/pages/accounts/LoginPage.tsx
+++ b/apps/edr-freight-web/portal/src/pages/accounts/LoginPage.tsx
@@ -5,21 +5,11 @@ import { Link, useLocation, useNavigate } from "react-router-dom";
 
 import useAuth from "@/hooks/useAuth";
 import AuthShell from "@/components/auth/AuthShell";
+import { normaliseIdentifier } from "@/utils/identifier";
 import { extractApiError } from "@/utils/result";
 
 const EDR_LOGO = "/assets/edr-logo.png";
 
-/** Normalise Ethiopian local phone (09…/07…) to E.164; pass email through unchanged. */
-function normaliseIdentifier(raw: string): string {
-  const v = raw.trim();
-  const digits = v.replace(/\D/g, "");
-  if (digits.length >= 9 && (v.startsWith("0") || v.startsWith("+251"))) {
-    const local = digits.startsWith("251") ? digits.slice(3) : digits.replace(/^0/, "");
-    return `+251${local}`;
-  }
-  return v.toLowerCase();
-}
-
 export default function LoginPage() {
   const navigate = useNavigate();
   const location = useLocation();
@@ -80,7 +70,7 @@ export default function LoginPage() {
             <div className="mb-1.5 flex items-center justify-between">
               <span className="text-sm font-medium text-gray-800">Password</span>
               <Link
-                to="#"
+                to="/forgot-password"
                 className="text-xs font-semibold text-primary hover:underline"
               >
                 Forgot password?
diff --git a/apps/edr-freight-web/portal/src/pages/accounts/SetPasswordPage.tsx b/apps/edr-freight-web/portal/src/pages/accounts/SetPasswordPage.tsx
index 87702bdd8..ee8dd1922 100644
--- a/apps/edr-freight-web/portal/src/pages/accounts/SetPasswordPage.tsx
+++ b/apps/edr-freight-web/portal/src/pages/accounts/SetPasswordPage.tsx
@@ -8,30 +8,20 @@ import { z } from "zod";
 
 import useAuth from "@/hooks/useAuth";
 import AuthLayout from "@/components/auth/AuthLayout";
-
-const passwordRequirements = [
-  { label: "At least 8 characters", test: (v: string) => v.length >= 8 },
-  { label: "One uppercase letter", test: (v: string) => /[A-Z]/.test(v) },
-  { label: "One lowercase letter", test: (v: string) => /[a-z]/.test(v) },
-  { label: "One number", test: (v: string) => /\d/.test(v) },
-  { label: "One special character", test: (v: string) => /[^A-Za-z0-9]/.test(v) },
-] as const;
+import {
+  PASSWORD_MISMATCH,
+  confirmPasswordField,
+  passwordField,
+  passwordRequirements,
+  samePassword,
+} from "@/utils/passwordSchema";
 
 const passwordSchema = z
   .object({
-    password: z
-      .string()
-      .min(8, "Password must be at least 8 characters")
-      .regex(/[A-Z]/, "Password must include an uppercase letter")
-      .regex(/[a-z]/, "Password must include a lowercase letter")
-      .regex(/\d/, "Password must include a number")
-      .regex(/[^A-Za-z0-9]/, "Password must include a special character"),
-    confirmPassword: z.string().min(1, "Please confirm your password"),
+    password: passwordField,
+    confirmPassword: confirmPasswordField,
   })
-  .refine((data) => data.password === data.confirmPassword, {
-    message: "Passwords do not match",
-    path: ["confirmPassword"],
-  });
+  .refine(samePassword, PASSWORD_MISMATCH);
 
 type FormData = z.infer<typeof passwordSchema>;
 
diff --git a/apps/edr-freight-web/portal/src/pages/accounts/SignupPage.tsx b/apps/edr-freight-web/portal/src/pages/accounts/SignupPage.tsx
index 5746eefd5..fe2fb09cd 100644
--- a/apps/edr-freight-web/portal/src/pages/accounts/SignupPage.tsx
+++ b/apps/edr-freight-web/portal/src/pages/accounts/SignupPage.tsx
@@ -1,50 +1,39 @@
-import { useEffect, useState } from "react";
+import { useState } from "react";
 import { zodResolver } from "@hookform/resolvers/zod";
 import {
   Alert,
   Button,
   PasswordInput,
-  PinInput,
-  SegmentedControl,
   SimpleGrid,
   Stack,
-  Text,
   TextInput,
 } from "@mantine/core";
-import {
-  AlertCircle,
-  ArrowLeft,
-  ArrowRight,
-  Check,
-  Mail,
-  RotateCw,
-  ShieldCheck,
-  Smartphone,
-  X,
-} from "lucide-react";
+import { AlertCircle, ArrowRight } from "lucide-react";
 import { useForm } from "react-hook-form";
 import { useNavigate } from "react-router-dom";
 import { z } from "zod";
 
 import { userType } from "@/enums/userType";
 import useAuth from "@/hooks/useAuth";
+import { useResendCooldown } from "@/hooks/useResendCooldown";
 import type { SignupPayload } from "@/types/auth";
 import AuthShell from "@/components/auth/AuthShell";
+import OtpChannelStep, {
+  OTP_LENGTH,
+  OtpChannelSelect,
+  type OtpChannel,
+} from "@/components/auth/OtpChannelStep";
+import PasswordChecklist from "@/components/auth/PasswordChecklist";
 import { ControlledPhoneField, isValidPhone } from "@/components/PhoneField";
 import { api } from "@/services/api";
+import {
+  PASSWORD_MISMATCH,
+  confirmPasswordField,
+  passwordField,
+  samePassword,
+} from "@/utils/passwordSchema";
 import { extractApiError } from "@/utils/result";
 
-const passwordRequirements = [
-  { label: "At least 8 characters", test: (v: string) => v.length >= 8 },
-  { label: "One uppercase letter", test: (v: string) => /[A-Z]/.test(v) },
-  { label: "One lowercase letter", test: (v: string) => /[a-z]/.test(v) },
-  { label: "One number", test: (v: string) => /\d/.test(v) },
-  {
-    label: "One special character",
-    test: (v: string) => /[^A-Za-z0-9]/.test(v),
-  },
-] as const;
-
 const userSchema = z
   .object({
     email: z.string().email("Invalid email address"),
@@ -61,43 +50,20 @@ const userSchema = z
       en: z.string().min(2, "Name is required"),
       am: z.string().nullable(),
     }),
-    password: z
-      .string()
-      .min(8, "Password must be at least 8 characters")
-      .regex(/[A-Z]/, "Password must include an uppercase letter")
-      .regex(/[a-z]/, "Password must include a lowercase letter")
-      .regex(/\d/, "Password must include a number")
-      .regex(/[^A-Za-z0-9]/, "Password must include a special character"),
-    confirmPassword: z.string().min(1, "Please confirm your password"),
+    password: passwordField,
+    confirmPassword: confirmPasswordField,
   })
-  .refine((data) => data.password === data.confirmPassword, {
-    message: "Passwords do not match",
-    path: ["confirmPassword"],
-  });
+  .refine(samePassword, PASSWORD_MISMATCH);
 
 type FormData = z.infer<typeof userSchema>;
 
-/** Mask all but the first 7 chars of an E.164 phone for display. */
-const maskPhone = (p: string) =>
-  p.length > 4 ? `${p.slice(0, 7)}${"*".repeat(Math.max(0, p.length - 7))}` : p;
-
-/** Mask the local part of an email for display (j***e@example.com). */
-const maskEmail = (email: string) => {
-  const [local, domain] = email.split("@");
-  if (!local || !domain) return email;
-  if (local.length <= 2) return `${local[0] ?? ""}***@${domain}`;
-  return `${local[0]}***${local[local.length - 1]}@${domain}`;
-};
-
-type OtpChannel = "phone" | "email";
-
 export default function SignupPage() {
   const navigate = useNavigate();
   const { signup } = useAuth();
   const [error, setError] = useState<string | null>(null);
 
-  // Two-stage signup: fill the form, then a mandatory SMS OTP challenge on the
-  // phone number before the account is actually created. The account is only
+  // Two-stage signup: fill the form, then a mandatory OTP challenge on the
+  // chosen channel before the account is actually created. The account is only
   // created after the code is verified — the OTP is a hard requirement.
   const [stage, setStage] = useState<"form" | "otp">("form");
   const [pendingData, setPendingData] = useState<FormData | null>(null);
@@ -109,14 +75,7 @@ export default function SignupPage() {
   const [verifying, setVerifying] = useState(false);
   const [otpCode, setOtpCode] = useState("");
   const [otpError, setOtpError] = useState<string | null>(null);
-  const [resendIn, setResendIn] = useState(0);
-
-  // Resend cooldown countdown (pure setTimeout ticks — no Date.now needed).
-  useEffect(() => {
-    if (resendIn <= 0) return;
-    const t = setTimeout(() => setResendIn((s) => s - 1), 1000);
-    return () => clearTimeout(t);
-  }, [resendIn]);
+  const resendCooldown = useResendCooldown();
 
   const {
     register,
@@ -170,7 +129,7 @@ export default function SignupPage() {
       setOtpChannel(channel);
       setOtpCode("");
       setOtpError(null);
-      setResendIn(60);
+      resendCooldown.start();
       setStage("otp");
     } catch (err) {
       setError(extractApiError(err).message);
@@ -190,7 +149,7 @@ export default function SignupPage() {
           : { phone: pendingData.phone },
       );
       setOtpCode("");
-      setResendIn(60);
+      resendCooldown.start();
     } catch (err) {
       setOtpError(extractApiError(err).message);
     } finally {
@@ -202,8 +161,8 @@ export default function SignupPage() {
   const confirmOtp = async () => {
     if (!pendingData) return;
     setOtpError(null);
-    if (otpCode.trim().length !== 6) {
-      setOtpError("Enter the 6-digit code we sent you.");
+    if (otpCode.trim().length !== OTP_LENGTH) {
+      setOtpError(`Enter the ${OTP_LENGTH}-digit code we sent you.`);
       return;
     }
     setVerifying(true);
@@ -298,35 +257,11 @@ export default function SignupPage() {
                 disabled={sending}
               />
 
-              <div className="space-y-1.5">
-                <Text size="sm" fw={500} c="edr-text">
-                  Send verification code via
-                </Text>
-                <SegmentedControl
-                  fullWidth
-                  disabled={sending}
-                  value={channel}
-                  onChange={(v) => setChannel(v as OtpChannel)}
-                  data={[
-                    {
-                      value: "phone",
-                      label: (
-                        <span className="flex items-center justify-center gap-1.5">
-                          <Smartphone size={14} /> Phone
-                        </span>
-                      ),
-                    },
-                    {
-                      value: "email",
-                      label: (
-                        <span className="flex items-center justify-center gap-1.5">
-                          <Mail size={14} /> Email
-                        </span>
-                      ),
-                    },
-                  ]}
-                />
-              </div>
+              <OtpChannelSelect
+                value={channel}
+                onChange={setChannel}
+                disabled={sending}
+              />
 
               <div>
                 <PasswordInput
@@ -337,37 +272,7 @@ export default function SignupPage() {
                   error={errors.password?.message}
                   {...register("password")}
                 />
-                {passwordValue.length > 0 ? (
-                  <div className="mt-2 space-y-1">
-                    {passwordRequirements.map((req) => {
-                      const met = req.test(passwordValue);
-                      return (
-                        <div
-                          key={req.label}
-                          className="flex items-center gap-2"
-                        >
-                          <span
-                            className={`flex h-4 w-4 shrink-0 items-center justify-center rounded-full ${met
-                                ? "bg-primary text-primary-foreground"
-                                : "bg-gray-200 text-gray-500"
-                              }`}
-                          >
-                            {met ? (
-                              <Check className="h-2.5 w-2.5" />
-                            ) : (
-                              <X className="h-2.5 w-2.5" />
-                            )}
-                          </span>
-                          <span
-                            className={`text-xs ${met ? "text-primary" : "text-gray-500"}`}
-                          >
-                            {req.label}
-                          </span>
-                        </div>
-                      );
-                    })}
-                  </div>
-                ) : null}
+                <PasswordChecklist value={passwordValue} />
               </div>
 
               <PasswordInput
@@ -412,87 +317,28 @@ export default function SignupPage() {
             </Stack>
           </form>
         ) : (
-          <Stack gap="md">
-            <div className="mb-1 flex justify-center">
-              <span className="flex h-12 w-12 items-center justify-center rounded-full bg-primary/10 text-primary">
-                <ShieldCheck size={22} />
-              </span>
-            </div>
-            <div className="space-y-1.5 text-center">
-              <h1 className="text-xl font-bold tracking-tight text-gray-900 sm:text-2xl">
-                Verify your {otpChannel === "email" ? "email" : "phone"}
-              </h1>
-              <p className="text-sm leading-relaxed text-gray-500">
-                We sent a 6 - digit code to{" "}
-                <span className="font-medium text-gray-700">
-                  {otpChannel === "email"
-                    ? maskEmail(pendingData?.email ?? "")
-                    : maskPhone(pendingData?.phone ?? "")}
-                </span>
-                .Enter it to finish creating your account.
-              </p>
-            </div>
-
-            {otpError ? (
-              <Alert
-                color="red"
-                variant="light"
-                icon={<AlertCircle size={18} />}
-              >
-                {otpError}
-              </Alert>
-            ) : null}
-
-            <Stack gap={6} align="center">
-              <Text size="sm" fw={500} c="edr-text">
-                Verification code
-              </Text>
-              <PinInput
-                length={6}
-                type="number"
-                oneTimeCode
-                value={otpCode}
-                placeholder="0"
-                disabled={verifying}
-                styles={{ input: { textAlign: "center" } }}
-                onChange={setOtpCode}
-              />
-            </Stack>
-
-            <Button
-              color="edr-green"
-              fullWidth
-              loading={verifying}
-              disabled={verifying || otpCode.trim().length !== 6}
-              onClick={confirmOtp}
-            >
-              Verify & create account
-            </Button>
-
-            <div className="flex items-center justify-between">
-              <Button
-                variant="subtle"
-                color="gray"
-                leftSection={<ArrowLeft size={14} />}
-                disabled={sending || verifying}
-                onClick={() => {
-                  setStage("form");
-                  setOtpError(null);
-                }}
-              >
-                Back
-              </Button>
-              <Button
-                variant="subtle"
-                color="edr-green"
-                leftSection={<RotateCw size={14} />}
-                disabled={resendIn > 0 || sending || verifying}
-                onClick={resendOtp}
-              >
-                {resendIn > 0 ? `Resend in ${resendIn}s` : "Resend code"}
-              </Button>
-            </div>
-          </Stack>
+          <OtpChannelStep
+            channel={otpChannel}
+            target={
+              otpChannel === "email"
+                ? (pendingData?.email ?? "")
+                : (pendingData?.phone ?? "")
+            }
+            value={otpCode}
+            onChange={setOtpCode}
+            onVerify={confirmOtp}
+            onBack={() => {
+              setStage("form");
+              setOtpError(null);
+            }}
+            onResend={resendOtp}
+            resendIn={resendCooldown.secondsLeft}
+            sending={sending}
+            verifying={verifying}
+            error={otpError}
+            description="Enter it to finish creating your account."
+            submitLabel="Verify & create account"
+          />
         )}
       </div>
     </AuthShell>
diff --git a/apps/edr-freight-web/portal/src/services/api.ts b/apps/edr-freight-web/portal/src/services/api.ts
index c5af03f65..b9937501f 100644
--- a/apps/edr-freight-web/portal/src/services/api.ts
+++ b/apps/edr-freight-web/portal/src/services/api.ts
@@ -77,6 +77,9 @@ import type {
   SetPasswordPayload,
   SignupPayload,
   SignupResponse,
+  ForgotPasswordRequestPayload,
+  ForgotPasswordVerifyPayload,
+  ResetTicket,
 } from "@/types/auth";
 
 // ---------------------------------------------------------------------------
@@ -110,6 +113,21 @@ export const api = {
       "setPassword",
       authService.setPassword,
     ),
+    requestPasswordReset: endpoint<ForgotPasswordRequestPayload, void>(
+      "auth",
+      "requestPasswordReset",
+      authService.requestPasswordReset,
+    ),
+    verifyPasswordResetOtp: endpoint<ForgotPasswordVerifyPayload, ResetTicket>(
+      "auth",
+      "verifyPasswordResetOtp",
+      authService.verifyPasswordResetOtp,
+    ),
+    resetPassword: endpoint<SetPasswordPayload, void>(
+      "auth",
+      "resetPassword",
+      authService.resetPassword,
+    ),
     checkAvailability: endpoint<CheckAvailabilityPayload, CheckAvailabilityResponse>(
       "auth",
       "checkAvailability",
diff --git a/apps/edr-freight-web/portal/src/services/auth.service.ts b/apps/edr-freight-web/portal/src/services/auth.service.ts
index 3f9ef4e53..3b113878d 100644
--- a/apps/edr-freight-web/portal/src/services/auth.service.ts
+++ b/apps/edr-freight-web/portal/src/services/auth.service.ts
@@ -3,11 +3,14 @@ import type {
   AuthUser,
   CheckAvailabilityPayload,
   CheckAvailabilityResponse,
+  ForgotPasswordRequestPayload,
+  ForgotPasswordVerifyPayload,
   GenerateVerificationCodePayload,
   LoginPayload,
   LoginResponse,
   OtpPayload,
   OtpResponse,
+  ResetTicket,
   SetPasswordPayload,
   SignupPayload,
   SignupResponse,
@@ -53,6 +56,31 @@ export const authService = {
     return res.data.data;
   },
 
+  // The three calls below drive the unauthenticated forgot-password flow.
+  // Responses under /api/auth are *flattened* by the API's response
+  // interceptor ({ success, ...payload }), so there is no `.data.data` here.
+
+  requestPasswordReset: async (body: ForgotPasswordRequestPayload) => {
+    await client.post(URL_CONSTANTS.AUTH.FORGOT_PASSWORD_REQUEST, body);
+  },
+
+  verifyPasswordResetOtp: async (body: ForgotPasswordVerifyPayload) => {
+    const res = await client.post<ResetTicket>(
+      URL_CONSTANTS.AUTH.FORGOT_PASSWORD_VERIFY,
+      body,
+    );
+    return { userId: res.data.userId, verificationCode: res.data.verificationCode };
+  },
+
+  /**
+   * Spend the reset ticket. Distinct from `setPassword` above, which the
+   * authenticated post-signup flow drives through `useAuth` — this one carries
+   * its own userId/verificationCode and never touches the session.
+   */
+  resetPassword: async (body: SetPasswordPayload) => {
+    await client.patch(URL_CONSTANTS.USERS.SET_PASSWORD, body);
+  },
+
   checkAvailability: async (params: CheckAvailabilityPayload) => {
     const res = await client.get<CheckAvailabilityResponse>(
       URL_CONSTANTS.USERS.CHECK_AVAILABILITY,
diff --git a/apps/edr-freight-web/portal/src/types/auth.ts b/apps/edr-freight-web/portal/src/types/auth.ts
index 04357a9ca..2e9a0b611 100644
--- a/apps/edr-freight-web/portal/src/types/auth.ts
+++ b/apps/edr-freight-web/portal/src/types/auth.ts
@@ -63,6 +63,25 @@ export interface SetPasswordPayload {
   verificationCode: string;
 }
 
+/** The channel a password-reset code is delivered over. */
+export type ResetChannel = "email" | "phone";
+
+export interface ForgotPasswordRequestPayload {
+  /** Email, username, or E.164 phone — whatever the user typed, normalised. */
+  identifier: string;
+  channel: ResetChannel;
+}
+
+export interface ForgotPasswordVerifyPayload extends ForgotPasswordRequestPayload {
+  otp: string;
+}
+
+/** Single-use ticket to spend on `PATCH /api/auth/set-password`. */
+export interface ResetTicket {
+  userId: string;
+  verificationCode: string;
+}
+
 export interface GenerateVerificationCodePayload {
   email: string;
   phoneNumber: string;
diff --git a/apps/edr-freight-web/portal/src/utils/identifier.ts b/apps/edr-freight-web/portal/src/utils/identifier.ts
new file mode 100644
index 000000000..72677f73c
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/utils/identifier.ts
@@ -0,0 +1,22 @@
+/** Normalise Ethiopian local phone (09…/07…) to E.164; pass email through unchanged. */
+export function normaliseIdentifier(raw: string): string {
+  const v = raw.trim();
+  const digits = v.replace(/\D/g, "");
+  if (digits.length >= 9 && (v.startsWith("0") || v.startsWith("+251"))) {
+    const local = digits.startsWith("251") ? digits.slice(3) : digits.replace(/^0/, "");
+    return `+251${local}`;
+  }
+  return v.toLowerCase();
+}
+
+/** Mask all but the first 7 chars of an E.164 phone for display. */
+export const maskPhone = (p: string) =>
+  p.length > 4 ? `${p.slice(0, 7)}${"*".repeat(Math.max(0, p.length - 7))}` : p;
+
+/** Mask the local part of an email for display (j***e@example.com). */
+export const maskEmail = (email: string) => {
+  const [local, domain] = email.split("@");
+  if (!local || !domain) return email;
+  if (local.length <= 2) return `${local[0] ?? ""}***@${domain}`;
+  return `${local[0]}***${local[local.length - 1]}@${domain}`;
+};
diff --git a/apps/edr-freight-web/portal/src/utils/passwordSchema.ts b/apps/edr-freight-web/portal/src/utils/passwordSchema.ts
new file mode 100644
index 000000000..d21d3f83e
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/utils/passwordSchema.ts
@@ -0,0 +1,36 @@
+import { z } from "zod";
+
+/** Live checklist shown under the password field. Mirrors {@link passwordField}. */
+export const passwordRequirements = [
+  { label: "At least 8 characters", test: (v: string) => v.length >= 8 },
+  { label: "One uppercase letter", test: (v: string) => /[A-Z]/.test(v) },
+  { label: "One lowercase letter", test: (v: string) => /[a-z]/.test(v) },
+  { label: "One number", test: (v: string) => /\d/.test(v) },
+  { label: "One special character", test: (v: string) => /[^A-Za-z0-9]/.test(v) },
+] as const;
+
+/**
+ * Must stay in step with IAM's `@IsStrongPassword()` on `InitialResetPasswordDto`
+ * — a password this accepts but the API rejects surfaces as an opaque 400.
+ */
+export const passwordField = z
+  .string()
+  .min(8, "Password must be at least 8 characters")
+  .regex(/[A-Z]/, "Password must include an uppercase letter")
+  .regex(/[a-z]/, "Password must include a lowercase letter")
+  .regex(/\d/, "Password must include a number")
+  .regex(/[^A-Za-z0-9]/, "Password must include a special character");
+
+export const confirmPasswordField = z.string().min(1, "Please confirm your password");
+
+export const samePassword = (data: { password: string; confirmPassword: string }) =>
+  data.password === data.confirmPassword;
+
+export const PASSWORD_MISMATCH = {
+  message: "Passwords do not match",
+  path: ["confirmPassword"],
+} as const;
+
+/** Every requirement in {@link passwordRequirements} is satisfied. */
+export const meetsAllRequirements = (value: string) =>
+  passwordRequirements.every((r) => r.test(value));

From 3f7734fe1607d9a03986ffe7d573b6fe670bf206 Mon Sep 17 00:00:00 2001
From: Nathnael <nathnael@example.com>
Date: Thu, 9 Jul 2026 08:55:06 +0000
Subject: [PATCH 10/25] fixes

---
 .../src/pages/accounts/SetPasswordPage.tsx    | 34 +++++++++++++++----
 .../portal/src/pages/accounts/SignupPage.tsx  |  6 ++--
 .../portal/src/utils/passwordSchema.ts        | 20 ++++++-----
 3 files changed, 43 insertions(+), 17 deletions(-)

diff --git a/apps/edr-freight-web/portal/src/pages/accounts/SetPasswordPage.tsx b/apps/edr-freight-web/portal/src/pages/accounts/SetPasswordPage.tsx
index ee8dd1922..04625f2cd 100644
--- a/apps/edr-freight-web/portal/src/pages/accounts/SetPasswordPage.tsx
+++ b/apps/edr-freight-web/portal/src/pages/accounts/SetPasswordPage.tsx
@@ -1,4 +1,13 @@
-import { Alert, Box, Button, Group, PasswordInput, Stack, Text, ThemeIcon } from "@mantine/core";
+import {
+  Alert,
+  Box,
+  Button,
+  Group,
+  PasswordInput,
+  Stack,
+  Text,
+  ThemeIcon,
+} from "@mantine/core";
 import { zodResolver } from "@hookform/resolvers/zod";
 import { ArrowRight, Check, LockKeyhole, X } from "lucide-react";
 import { useMemo, useState } from "react";
@@ -9,7 +18,6 @@ import { z } from "zod";
 import useAuth from "@/hooks/useAuth";
 import AuthLayout from "@/components/auth/AuthLayout";
 import {
-  PASSWORD_MISMATCH,
   confirmPasswordField,
   passwordField,
   passwordRequirements,
@@ -21,7 +29,10 @@ const passwordSchema = z
     password: passwordField,
     confirmPassword: confirmPasswordField,
   })
-  .refine(samePassword, PASSWORD_MISMATCH);
+  .refine(samePassword, {
+    message: "Passwords do not match",
+    path: ["confirmPassword"],
+  });
 
 type FormData = z.infer<typeof passwordSchema>;
 
@@ -44,7 +55,8 @@ export default function SetPasswordPage() {
   const password = watch("password");
 
   const requirements = useMemo(
-    () => passwordRequirements.map((r) => ({ ...r, met: r.test(password || "") })),
+    () =>
+      passwordRequirements.map((r) => ({ ...r, met: r.test(password || "") })),
     [password],
   );
 
@@ -83,11 +95,21 @@ export default function SetPasswordPage() {
           "Secure freight operations",
           "Advanced authentication system",
         ],
-        stats: { label: "Security Protection", value: "256-bit", footer: "Encrypted", progress: "w-[98%]" },
+        stats: {
+          label: "Security Protection",
+          value: "256-bit",
+          footer: "Encrypted",
+          progress: "w-[98%]",
+        },
       }}
     >
       <Stack gap="xs" mb="lg">
-        <Box w={48} h={48} bg="edr-soft" className="flex items-center justify-center rounded-2xl">
+        <Box
+          w={48}
+          h={48}
+          bg="edr-soft"
+          className="flex items-center justify-center rounded-2xl"
+        >
           <LockKeyhole size={22} color="var(--mantine-color-edr-green-6)" />
         </Box>
         <Box>
diff --git a/apps/edr-freight-web/portal/src/pages/accounts/SignupPage.tsx b/apps/edr-freight-web/portal/src/pages/accounts/SignupPage.tsx
index fe2fb09cd..72dafe9f7 100644
--- a/apps/edr-freight-web/portal/src/pages/accounts/SignupPage.tsx
+++ b/apps/edr-freight-web/portal/src/pages/accounts/SignupPage.tsx
@@ -27,7 +27,6 @@ import PasswordChecklist from "@/components/auth/PasswordChecklist";
 import { ControlledPhoneField, isValidPhone } from "@/components/PhoneField";
 import { api } from "@/services/api";
 import {
-  PASSWORD_MISMATCH,
   confirmPasswordField,
   passwordField,
   samePassword,
@@ -53,7 +52,10 @@ const userSchema = z
     password: passwordField,
     confirmPassword: confirmPasswordField,
   })
-  .refine(samePassword, PASSWORD_MISMATCH);
+  .refine(samePassword, {
+    message: "Passwords do not match",
+    path: ["confirmPassword"],
+  });
 
 type FormData = z.infer<typeof userSchema>;
 
diff --git a/apps/edr-freight-web/portal/src/utils/passwordSchema.ts b/apps/edr-freight-web/portal/src/utils/passwordSchema.ts
index d21d3f83e..207d9dc2b 100644
--- a/apps/edr-freight-web/portal/src/utils/passwordSchema.ts
+++ b/apps/edr-freight-web/portal/src/utils/passwordSchema.ts
@@ -6,7 +6,10 @@ export const passwordRequirements = [
   { label: "One uppercase letter", test: (v: string) => /[A-Z]/.test(v) },
   { label: "One lowercase letter", test: (v: string) => /[a-z]/.test(v) },
   { label: "One number", test: (v: string) => /\d/.test(v) },
-  { label: "One special character", test: (v: string) => /[^A-Za-z0-9]/.test(v) },
+  {
+    label: "One special character",
+    test: (v: string) => /[^A-Za-z0-9]/.test(v),
+  },
 ] as const;
 
 /**
@@ -21,15 +24,14 @@ export const passwordField = z
   .regex(/\d/, "Password must include a number")
   .regex(/[^A-Za-z0-9]/, "Password must include a special character");
 
-export const confirmPasswordField = z.string().min(1, "Please confirm your password");
+export const confirmPasswordField = z
+  .string()
+  .min(1, "Please confirm your password");
 
-export const samePassword = (data: { password: string; confirmPassword: string }) =>
-  data.password === data.confirmPassword;
-
-export const PASSWORD_MISMATCH = {
-  message: "Passwords do not match",
-  path: ["confirmPassword"],
-} as const;
+export const samePassword = (data: {
+  password: string;
+  confirmPassword: string;
+}) => data.password === data.confirmPassword;
 
 /** Every requirement in {@link passwordRequirements} is satisfied. */
 export const meetsAllRequirements = (value: string) =>

From fa5fde6b6bcc96b17eab320b69a08ba640a40d29 Mon Sep 17 00:00:00 2001
From: Hagernesh <hagernesh@example.com>
Date: Thu, 9 Jul 2026 08:59:58 +0000
Subject: [PATCH 11/25] Fix slow GRN button and sms timeout

---
 .../strategies/notification.sms.strategy.ts   |  5 ++
 .../warehouses/warehouse-inventory.service.ts | 47 +++++++++++++++----
 2 files changed, 44 insertions(+), 8 deletions(-)

diff --git a/apps/edr-freight-api/src/modules/notifications/strategies/notification.sms.strategy.ts b/apps/edr-freight-api/src/modules/notifications/strategies/notification.sms.strategy.ts
index d8404e84c..cddc67b2d 100644
--- a/apps/edr-freight-api/src/modules/notifications/strategies/notification.sms.strategy.ts
+++ b/apps/edr-freight-api/src/modules/notifications/strategies/notification.sms.strategy.ts
@@ -22,6 +22,10 @@ export class SmsNotificationStrategy implements NotificationStrategy {
 
     this.logger.debug(`Sending SMS to ${recipient} via ${url}`);
 
+    // axios defaults to no timeout — a hanging gateway would block the caller
+    // (and any transaction it sits in) indefinitely. Always bound the wait.
+    const timeout = Number(this.configService.get<string>("SMS_TIMEOUT_MS") ?? 8000);
+
     try {
       const response = await axios.post(
         url,
@@ -34,6 +38,7 @@ export class SmsNotificationStrategy implements NotificationStrategy {
           callbackUrl: "",
         },
         {
+          timeout,
           headers: {
             accept: "*/*",
             "Content-Type": "application/json",
diff --git a/apps/edr-freight-api/src/modules/warehouses/warehouse-inventory.service.ts b/apps/edr-freight-api/src/modules/warehouses/warehouse-inventory.service.ts
index 9b2f53a99..06e84d455 100644
--- a/apps/edr-freight-api/src/modules/warehouses/warehouse-inventory.service.ts
+++ b/apps/edr-freight-api/src/modules/warehouses/warehouse-inventory.service.ts
@@ -860,6 +860,25 @@ export class WarehouseInventoryService {
   /** Bulk-receive eligible PAID bookings into a location. Skips duplicates / wrong direction. */
   async bulkReceive(dto: BulkReceiveDto): Promise<BulkReceiveResult> {
     const result: BulkReceiveResult = { receivedCount: 0, skippedCount: 0, results: [] };
+    /** Sent after the transaction commits so the gateway never blocks the receive. */
+    const pendingNotifications: Array<{
+      owner: {
+        phone?: string | null;
+        ownerName?: string | null;
+        bookingReference?: string | null;
+        grnNumber: string;
+        direction?: string | null;
+        warehouseId?: string | null;
+      };
+      booking: {
+        companyId?: string | null;
+        reference?: string | null;
+        hasFirstMile?: boolean;
+        hasLastMile?: boolean;
+        customerTruckAssignedAt?: string | null;
+      };
+      bookingId: string;
+    }> = [];
 
     await this.dataSource.transaction(async (manager) => {
       await this.validateLocation(manager, {
@@ -1032,21 +1051,33 @@ export class WarehouseInventoryService {
           manager,
         );
 
-        await this.notifyOwnerInventoryReceived({
-          phone: truckEntrance?.customerPhone ?? booking.customerPhone,
-          ownerName: truckEntrance?.ownerName ?? booking.customer,
-          bookingReference: truckEntrance?.edrDigitalBookingId ?? booking.reference,
-          grnNumber,
-          direction: dto.direction,
-          warehouseId: dto.warehouseId,
+        // Queued, not sent here: an SMS/email round-trip inside the transaction
+        // holds capacity/location locks open for the whole gateway latency.
+        pendingNotifications.push({
+          owner: {
+            phone: truckEntrance?.customerPhone ?? booking.customerPhone,
+            ownerName: truckEntrance?.ownerName ?? booking.customer,
+            bookingReference: truckEntrance?.edrDigitalBookingId ?? booking.reference,
+            grnNumber,
+            direction: dto.direction,
+            warehouseId: dto.warehouseId,
+          },
+          booking,
+          bookingId,
         });
 
         result.receivedCount += 1;
         result.results.push({ bookingId, status: 'RECEIVED', inventoryId: saved.id, grnNumber });
-        void this.notifyTruckAssignmentNeeded(booking, bookingId);
       }
     });
 
+    // Fan out after commit, un-awaited: the receive response must not wait on the
+    // SMS gateway. Both notifiers swallow their own errors.
+    for (const pending of pendingNotifications) {
+      void this.notifyOwnerInventoryReceived(pending.owner);
+      void this.notifyTruckAssignmentNeeded(pending.booking, pending.bookingId);
+    }
+
     return result;
   }
 

From f7ceca944ad50de090983b7a3ca307de5dd2d55b Mon Sep 17 00:00:00 2001
From: Hagernesh <hagernesh@example.com>
Date: Thu, 9 Jul 2026 09:21:15 +0000
Subject: [PATCH 12/25] Freight OperationsQA Test Plan

---
 docs/qa/edr-freight-qa-test-plan.pdf | 6680 ++++++++++++++++++++++++++
 1 file changed, 6680 insertions(+)
 create mode 100644 docs/qa/edr-freight-qa-test-plan.pdf

diff --git a/docs/qa/edr-freight-qa-test-plan.pdf b/docs/qa/edr-freight-qa-test-plan.pdf
new file mode 100644
index 000000000..56c5d520d
--- /dev/null
+++ b/docs/qa/edr-freight-qa-test-plan.pdf
@@ -0,0 +1,6680 @@
+%PDF-1.3
+%�߬�
+3 0 obj
+<</Type /Page
+/Parent 1 0 R
+/Resources 2 0 R
+/MediaBox [0 0 595.2799999999999727 841.8899999999999864]
+/Contents 4 0 R
+>>
+endobj
+4 0 obj
+<<
+/Length 9916
+>>
+stream
+0.200025 w
+0 G
+BT
+/F5 8 Tf
+9.1999999999999993 TL
+0.043 0.333 0.388 rg
+42. 793.8899999999999864 Td
+(ETHIO-DJIBOUTI RAILWAY  /  FREIGHT PLATFORM) Tj
+ET
+BT
+/F9 30 Tf
+34.5 TL
+0.063 0.102 0.11 rg
+42. 767.8899999999999864 Td
+(Freight Operations) Tj
+ET
+BT
+/F9 30 Tf
+34.5 TL
+0.063 0.102 0.11 rg
+42. 737.8899999999999864 Td
+(QA Test Plan) Tj
+ET
+0.06 0.1 0.11 RG
+1.3999999999999999 w
+42. 717.8899999999999864 m
+553.2799999999999727 717.8899999999999864 l
+S
+BT
+/F1 10 Tf
+11.5 TL
+0.275 0.345 0.357 rg
+42. 697.8899999999999864 Td
+(End-to-end test flows from booking through warehouse, rail, and delivery - import and export,) Tj
+T* (with and without first/last mile, self-haul and EDR haulage. Every status, guard, and endpoint) Tj
+T* (below is taken from the code, not assumed.) Tj
+ET
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.427 0.498 0.51 rg
+42. 642.8899999999999864 Td
+(BRANCH  Truckdetantion) Tj
+ET
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.427 0.498 0.51 rg
+212. 642.8899999999999864 Td
+(SCOPE  Warehouse . Fees . Allocation . First mile . Last mile) Tj
+ET
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.427 0.498 0.51 rg
+42. 630.8899999999999864 Td
+(DEPTH  Tester steps + technical refs) Tj
+ET
+BT
+/F5 9 Tf
+10.3499999999999996 TL
+0.043 0.333 0.388 rg
+42. 596.8899999999999864 Td
+(00) Tj
+ET
+BT
+/F9 17 Tf
+19.5499999999999972 TL
+0.063 0.102 0.11 rg
+72. 595.8899999999999864 Td
+(Test data setup) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+42. 575.8899999999999864 m
+553.2799999999999727 575.8899999999999864 l
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+42. 561.8899999999999864 Td
+(Nothing below passes without this. Set it up once per environment and confirm each line before opening a single flow.) Tj
+ET
+0.43 0.5 0.51 RG
+0.6 w
+43. 547.3899999999999864 8. -8. re
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+60. 539.8899999999999864 Td
+(Warehouse tree: at least one ACTIVE warehouse with a yard and a zone. Capacities are in TONNES, not kg.) Tj
+ET
+0.43 0.5 0.51 RG
+0.6 w
+43. 530.3899999999999864 8. -8. re
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+60. 522.8899999999999864 Td
+(Company has a linked portal user. Critical - in-app notifications resolve recipients from the company's portal users. With) Tj
+T* (none linked, notify\(\) logs "0 recipients - skipped" and stores nothing. SMS/email still fire.) Tj
+ET
+0.43 0.5 0.51 RG
+0.6 w
+43. 501.3899999999999864 8. -8. re
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+60. 493.8899999999999864 Td
+(Customer saved signature. Required for Approve delivery; without it the API returns "Please save your signature before) Tj
+T* (approving delivery".) Tj
+ET
+0.43 0.5 0.51 RG
+0.6 w
+43. 472.3899999999999864 8. -8. re
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+60. 464.8899999999999864 Td
+(Allocation rules covering the freight type and trade direction under test \(see 08\), or accept the capacity-balanced fallback.) Tj
+ET
+0.43 0.5 0.51 RG
+0.6 w
+43. 455.3899999999999864 8. -8. re
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+60. 447.8899999999999864 Td
+(Fee rules: at least one each of STORAGE_FEE, DEMURRAGE_FEE, DOUBLE_HANDLING_FEE,) Tj
+T* (TRUCK_DETENTION_FEE \(see 07\).) Tj
+ET
+0.43 0.5 0.51 RG
+0.6 w
+43. 426.3899999999999864 8. -8. re
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+60. 418.8899999999999864 Td
+(Drivers and vehicles registered; a train schedule with wagons for the route under test.) Tj
+ET
+0.43 0.5 0.51 RG
+0.6 w
+43. 409.3899999999999864 8. -8. re
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+60. 401.8899999999999864 Td
+(Booking reaches PAID. Receive-to-warehouse skips any booking that is not PAID.) Tj
+ET
+0.43 0.5 0.51 RG
+0.6 w
+43. 392.3899999999999864 8. -8. re
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+60. 384.8899999999999864 Td
+(Container numbers are ISO 6346 - 4 letters + 7 digits, uppercase \(ABCU1234567\). Enforced at booking input and every) Tj
+T* (reference point.) Tj
+ET
+0.89 0.94 0.95 rg
+42. 351.8899999999999864 511.2799999999999727 -51. re
+f
+0.04 0.33 0.39 rg
+42. 351.8899999999999864 3. -51. re
+f
+BT
+/F1 8.6 Tf
+9.8899999999999988 TL
+0.275 0.345 0.357 rg
+56. 338.8899999999999864 Td
+(Direction is derived, not declared. Receive-to-warehouse computes trade direction from the ORIGIN and DESTINATION YARD) Tj
+T* (COUNTRIES, not the booking's stored trade_direction. A booking whose route says IMPORT will be skipped from an EXPORT) Tj
+T* (receive with "Booking route is IMPORT, not EXPORT". Set up yards accordingly.) Tj
+ET
+BT
+/F5 9 Tf
+10.3499999999999996 TL
+0.043 0.333 0.388 rg
+42. 278.8899999999999864 Td
+(01) Tj
+ET
+BT
+/F9 17 Tf
+19.5499999999999972 TL
+0.063 0.102 0.11 rg
+72. 277.8899999999999864 Td
+(Lifecycle reference) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+42. 257.8899999999999864 m
+553.2799999999999727 257.8899999999999864 l
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+42. 243.8899999999999864 Td
+(The three state machines a tester needs to read a failure. Anything not listed as an allowed transition is rejected by) Tj
+T* (assertTransition.) Tj
+ET
+BT
+/F2 8 Tf
+9.1999999999999993 TL
+0.063 0.102 0.11 rg
+42. 203.8899999999999864 Td
+(WAREHOUSE INVENTORY TRANSITIONS) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+42. 191.8899999999999864 105. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+47. 180.9399999999999409 Td
+(From) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+147. 191.8899999999999864 145. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+152. 180.9399999999999409 Td
+(Allowed next) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+292. 191.8899999999999864 261.2799999999999159 -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+297. 180.9399999999999409 Td
+(Notes) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 173.8400000000000318 105. -18.7399999999999984 re
+B
+BT
+/F5 7 Tf
+8.0499999999999989 TL
+0.063 0.102 0.11 rg
+47. 162.8899999999999864 Td
+(UNLOADED) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+147. 173.8400000000000318 145. -18.7399999999999984 re
+B
+BT
+/F5 7 Tf
+8.0499999999999989 TL
+0.275 0.345 0.357 rg
+152. 162.8899999999999864 Td
+(STORED, READY_FOR_PICKUP) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+292. 173.8400000000000318 261.2799999999999159 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+297. 162.3799999999999955 Td
+(Import landing state after train unload) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 155.1000000000000227 105. -18.7399999999999984 re
+B
+BT
+/F5 7 Tf
+8.0499999999999989 TL
+0.063 0.102 0.11 rg
+47. 144.1499999999999773 Td
+(RECEIVED) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+147. 155.1000000000000227 145. -18.7399999999999984 re
+B
+BT
+/F5 7 Tf
+8.0499999999999989 TL
+0.275 0.345 0.357 rg
+152. 144.1499999999999773 Td
+(STORED, READY_FOR_PICKUP) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+292. 155.1000000000000227 261.2799999999999159 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+297. 143.6399999999999864 Td
+(Export landing state after truck receive) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 136.3600000000000136 105. -27.4799999999999969 re
+B
+BT
+/F5 7 Tf
+8.0499999999999989 TL
+0.063 0.102 0.11 rg
+47. 125.4099999999999682 Td
+(STORED) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+147. 136.3600000000000136 145. -27.4799999999999969 re
+B
+BT
+/F5 7 Tf
+8.0499999999999989 TL
+0.275 0.345 0.357 rg
+152. 125.4099999999999682 Td
+(RESERVED, READY_FOR_LOADING) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+292. 136.3600000000000136 261.2799999999999159 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+297. 124.8999999999999773 Td
+(Reserve is retired from the UI; STORED -> READY_FOR_LOADING is the) Tj
+T* (live path) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 108.8799999999999955 105. -18.7399999999999984 re
+B
+BT
+/F5 7 Tf
+8.0499999999999989 TL
+0.063 0.102 0.11 rg
+47. 97.92999999999995 Td
+(READY_FOR_LOADING) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+147. 108.8799999999999955 145. -18.7399999999999984 re
+B
+BT
+/F5 7 Tf
+8.0499999999999989 TL
+0.275 0.345 0.357 rg
+152. 97.92999999999995 Td
+(LOADED) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+292. 108.8799999999999955 261.2799999999999159 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+297. 97.4199999999999591 Td
+(Onto a wagon) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 90.1399999999999864 105. -18.7399999999999984 re
+B
+BT
+/F5 7 Tf
+8.0499999999999989 TL
+0.063 0.102 0.11 rg
+47. 79.1899999999999409 Td
+(LOADED) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+147. 90.1399999999999864 145. -18.7399999999999984 re
+B
+BT
+/F5 7 Tf
+8.0499999999999989 TL
+0.275 0.345 0.357 rg
+152. 79.1899999999999409 Td
+(DISPATCHED) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+292. 90.1399999999999864 261.2799999999999159 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+297. 78.67999999999995 Td
+() Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 71.3999999999999773 105. -18.7399999999999984 re
+B
+BT
+/F5 7 Tf
+8.0499999999999989 TL
+0.063 0.102 0.11 rg
+47. 60.4499999999999318 Td
+(DISPATCHED) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+147. 71.3999999999999773 145. -18.7399999999999984 re
+B
+BT
+/F5 7 Tf
+8.0499999999999989 TL
+0.275 0.345 0.357 rg
+152. 60.4499999999999318 Td
+(UNLOADED_AT_DJIBOUTI_PORT) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+292. 71.3999999999999773 261.2799999999999159 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+297. 59.9399999999999409 Td
+(Export only, at Djibouti) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+0.78 G
+0. w
+0.8 0.85 0.85 RG
+0.5 w
+42. 36. m
+553.2799999999999727 36. l
+S
+BT
+/F9 8 Tf
+9.1999999999999993 TL
+0.427 0.498 0.51 rg
+42. 22. Td
+(EDR Freight - QA Test Plan) Tj
+ET
+BT
+/F5 7.5 Tf
+8.625 TL
+0.427 0.498 0.51 rg
+530.7799999999999727 22. Td
+(1 / 7) Tj
+ET
+endstream
+endobj
+5 0 obj
+<</Type /Page
+/Parent 1 0 R
+/Resources 2 0 R
+/MediaBox [0 0 595.2799999999999727 841.8899999999999864]
+/Contents 6 0 R
+>>
+endobj
+6 0 obj
+<<
+/Length 16091
+>>
+stream
+0. w
+0.78 G
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+42. 801.8899999999999864 105. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+47. 790.9399999999999409 Td
+(From) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+147. 801.8899999999999864 145. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+152. 790.9399999999999409 Td
+(Allowed next) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+292. 801.8899999999999864 261.2799999999999159 -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+297. 790.9399999999999409 Td
+(Notes) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 783.8400000000000318 105. -18.7399999999999984 re
+B
+BT
+/F5 7 Tf
+8.0499999999999989 TL
+0.063 0.102 0.11 rg
+47. 772.8899999999999864 Td
+(READY_FOR_PICKUP) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+147. 783.8400000000000318 145. -18.7399999999999984 re
+B
+BT
+/F5 7 Tf
+8.0499999999999989 TL
+0.275 0.345 0.357 rg
+152. 772.8899999999999864 Td
+(DELIVERED, STORED, DISPATCHED) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+292. 783.8400000000000318 261.2799999999999159 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+297. 772.3799999999999955 Td
+(Import; may be put back into storage) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.78 G
+0. w
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+BT
+/F2 8 Tf
+9.1999999999999993 TL
+0.063 0.102 0.11 rg
+42. 743.1000000000000227 Td
+(CONTAINER ITEM STAGES) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.5 w
+42. 733.1000000000000227 511.2799999999999727 -21. re
+B
+BT
+/F5 8 Tf
+9.1999999999999993 TL
+0.275 0.345 0.357 rg
+52. 721.1000000000000227 Td
+(PENDING  >  RECEIVED  >  GRN  >  ASSIGNED  >  LOADED  >  LEFT  >  DELIVERED) Tj
+ET
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+42. 700.1000000000000227 Td
+(ASSIGNED means the customer picked which containers ride which truck - planning only. LOADED requires the operator to) Tj
+T* (actually load them, and only after the truck has arrived \(loaded_at is stamped then\). Assignment alone must never show) Tj
+T* (LOADED.) Tj
+ET
+BT
+/F2 8 Tf
+9.1999999999999993 TL
+0.063 0.102 0.11 rg
+42. 650.1000000000000227 Td
+(FIRST MILE & LAST MILE) Tj
+ET
+0.8 0.85 0.85 RG
+0.5 w
+0.8 0.85 0.85 RG
+0.5 w
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+42. 638.1000000000000227 56. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+47. 627.1499999999999773 Td
+(Leg) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+98. 638.1000000000000227 210. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+103. 627.1499999999999773 Td
+(Statuses, in order) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+308. 638.1000000000000227 245.2799999999999727 -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+313. 627.1499999999999773 Td
+(Gate it controls) Tj
+ET
+0.8 0.85 0.85 RG
+0.5 w
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 620.0499999999999545 56. -26.0999999999999979 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 608.5900000000000318 Td
+(First mile) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+98. 620.0499999999999545 210. -26.0999999999999979 re
+B
+BT
+/F5 7 Tf
+8.0499999999999989 TL
+0.275 0.345 0.357 rg
+103. 609.1000000000000227 Td
+(PAYMENT_PENDING -> READY_TO_TRANSIT ->) Tj
+T* (IN_TRANSIT -> RECEIVED_TO_PORT) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+308. 620.0499999999999545 245.2799999999999727 -26.0999999999999979 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+313. 608.5900000000000318 Td
+(Export receive is blocked until RECEIVED_TO_PORT) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 593.9500000000000455 56. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 582.4900000000000091 Td
+(Last mile) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+98. 593.9500000000000455 210. -27.4799999999999969 re
+B
+BT
+/F5 7 Tf
+8.0499999999999989 TL
+0.275 0.345 0.357 rg
+103. 583. Td
+(PAYMENT_PENDING -> READY_TO_TRANSIT ->) Tj
+T* (IN_TRANSIT -> DELIVERED) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+308. 593.9500000000000455 245.2799999999999727 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+313. 582.4900000000000091 Td
+(Truck-detention window: arrivedAt \(reached destination\) -> deliveredAt) Tj
+T* (\(vehicle returned\)) Tj
+ET
+0.8 0.85 0.85 RG
+0.5 w
+0.78 G
+0. w
+0.8 0.85 0.85 RG
+0.5 w
+0.8 0.85 0.85 RG
+0.5 w
+BT
+/F5 9 Tf
+10.3499999999999996 TL
+0.043 0.333 0.388 rg
+42. 540.4700000000000273 Td
+(02) Tj
+ET
+BT
+/F9 17 Tf
+19.5499999999999972 TL
+0.063 0.102 0.11 rg
+72. 539.4700000000000273 Td
+(Export - without first mile) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+42. 519.4700000000000273 m
+553.2799999999999727 519.4700000000000273 l
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+42. 505.4700000000000273 Td
+(Customer brings the cargo to the facility themselves. The happy path from a paid booking to cargo unloaded at Djibouti port with) Tj
+T* (an interchange document.) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+42. 471.4700000000000273 34. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+47. 460.5200000000000387 Td
+(Step) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+76. 471.4700000000000273 150. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+81. 460.5200000000000387 Td
+(Tester action) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+226. 471.4700000000000273 227.2799999999999159 -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+231. 460.5200000000000387 Td
+(Expected result) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+453.2799999999999159 471.4700000000000273 100. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+458.2799999999999159 460.5200000000000387 Td
+(Technical ref) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 453.4200000000000159 34. -27.4799999999999969 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 441.9600000000000364 Td
+(E1.1) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 453.4200000000000159 150. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 441.9600000000000364 Td
+(Create an export booking \(route origin ET) Tj
+T* (-> destination DJ\), pay it.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+226. 453.4200000000000159 227.2799999999999159 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+231. 441.9600000000000364 Td
+(Booking reaches PAID.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+453.2799999999999159 453.4200000000000159 100. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+458.2799999999999159 441.9600000000000364 Td
+(Container numbers must) Tj
+T* (be ISO 6346) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 425.9399999999999977 34. -44.9599999999999937 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 414.4800000000000182 Td
+(E1.2) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 425.9399999999999977 150. -44.9599999999999937 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 414.4800000000000182 Td
+(Export Operations > Receive for Loading.) Tj
+T* (Select the booking, capture the truck) Tj
+T* (entrance \(plate, driver, weights\), pick) Tj
+T* (warehouse/yard/zone.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+226. 425.9399999999999977 227.2799999999999159 -44.9599999999999937 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+231. 414.4800000000000182 Td
+(Inventory created; GRN issued as) Tj
+T* (GRN-EXPORT-YYYYMMDD-XXXXXXXX. Customer gets a) Tj
+T* (receive SMS.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+453.2799999999999159 425.9399999999999977 100. -44.9599999999999937 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+458.2799999999999159 414.4800000000000182 Td
+(POST /warehouse-invento) Tj
+T* (ry/receive-bulk) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 380.9800000000000182 34. -36.2199999999999989 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 369.5200000000000387 Td
+(E1.3) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 380.9800000000000182 150. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 369.5200000000000387 Td
+(Store the item - either let it auto-allocate,) Tj
+T* (or pick warehouse/yard/zone in the Store) Tj
+T* (modal.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+226. 380.9800000000000182 227.2799999999999159 -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+231. 369.5200000000000387 Td
+(Status STORED; note records "allocation rule",) Tj
+T* ("capacity-balanced", or "operator-selected".) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+453.2799999999999159 380.9800000000000182 100. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+458.2799999999999159 369.5200000000000387 Td
+(Capacity decremented in) Tj
+T* (tonnes) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 344.7599999999999909 34. -27.4799999999999969 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 333.3000000000000114 Td
+(E1.4) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 344.7599999999999909 150. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 333.3000000000000114 Td
+(Inspect: mark selected items as) Tj
+T* (inspected, outcome PASSED.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+226. 344.7599999999999909 227.2799999999999159 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+231. 333.3000000000000114 Td
+(Export items advance straight to READY_FOR_LOADING.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+453.2799999999999159 344.7599999999999909 100. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+458.2799999999999159 333.3000000000000114 Td
+(Reserve step is retired) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 317.2799999999999727 34. -27.4799999999999969 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 305.8199999999999363 Td
+(E1.5) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 317.2799999999999727 150. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 305.8199999999999363 Td
+(Ready To Load tab > load onto the) Tj
+T* (allocated wagon.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+226. 317.2799999999999727 227.2799999999999159 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+231. 305.8199999999999363 Td
+(Status LOADED; a warehouse loading record exists.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+453.2799999999999159 317.2799999999999727 100. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+458.2799999999999159 305.8199999999999363 Td
+(Requires an allocated) Tj
+T* (wagon) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 289.7999999999999545 34. -27.4799999999999969 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 278.3399999999999181 Td
+(E1.6) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 289.7999999999999545 150. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 278.3399999999999181 Td
+(Download the export marshalling / load) Tj
+T* (list PDF.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+226. 289.7999999999999545 227.2799999999999159 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+231. 278.3399999999999181 Td
+(PDF lists the train's wagons, bookings, containers.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+453.2799999999999159 289.7999999999999545 100. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+458.2799999999999159 278.3399999999999181 Td
+(train-scheduling controller) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 262.3199999999999363 34. -27.4799999999999969 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 250.8599999999999 Td
+(E1.7) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 262.3199999999999363 150. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 250.8599999999999 Td
+(Dispatch Queue > dispatch.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+226. 262.3199999999999363 227.2799999999999159 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+231. 250.8599999999999 Td
+(Status DISPATCHED. Customer receives "Shipment dispatched") Tj
+T* (naming origin -> destination.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+453.2799999999999159 262.3199999999999363 100. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+458.2799999999999159 250.8599999999999 Td
+(Per booking on the) Tj
+T* (schedule) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 234.8399999999999181 34. -27.4799999999999969 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 223.3799999999998818 Td
+(E1.8) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 234.8399999999999181 150. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 223.3799999999998818 Td
+(Move the schedule to arrived at the) Tj
+T* (Djibouti-side port.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+226. 234.8399999999999181 227.2799999999999159 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+231. 223.3799999999998818 Td
+(Train appears in the Djibouti unloading queue. Customer) Tj
+T* (receives "Shipment arrived".) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+453.2799999999999159 234.8399999999999181 100. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+458.2799999999999159 223.3799999999998818 Td
+(status ARRIVED /) Tj
+T* (ARRIVED_AT_DJIBOUTI) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 207.3599999999999 34. -27.4799999999999969 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 195.8999999999998636 Td
+(E1.9) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 207.3599999999999 150. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 195.8999999999998636 Td
+(Grant the gate pass for the train, then) Tj
+T* (Unload at Djibouti.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+226. 207.3599999999999 227.2799999999999159 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+231. 195.8999999999998636 Td
+(Items become UNLOADED_AT_DJIBOUTI_PORT and an) Tj
+T* (interchange document is generated.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+453.2799999999999159 207.3599999999999 100. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+458.2799999999999159 195.8999999999998636 Td
+(Unload checks) Tj
+T* (gatepass_granted_at) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 179.8799999999998818 34. -27.4799999999999969 re
+B
+BT
+/F6 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 168.4199999999998454 Td
+(E1.G) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 179.8799999999998818 150. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 168.4199999999998454 Td
+(Try to unload at Djibouti BEFORE) Tj
+T* (granting the gate pass.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+226. 179.8799999999998818 227.2799999999999159 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+231. 168.4199999999998454 Td
+(BLOCKED. Items skipped with a gate-pass reason; no) Tj
+T* (interchange document.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+453.2799999999999159 179.8799999999998818 100. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+458.2799999999999159 168.4199999999998454 Td
+(See section 06) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.78 G
+0. w
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+0.8 0.85 0.85 RG
+0.5 w
+42. 36. m
+553.2799999999999727 36. l
+S
+BT
+/F9 8 Tf
+9.1999999999999993 TL
+0.427 0.498 0.51 rg
+42. 22. Td
+(EDR Freight - QA Test Plan) Tj
+ET
+BT
+/F5 7.5 Tf
+8.625 TL
+0.427 0.498 0.51 rg
+530.7799999999999727 22. Td
+(2 / 7) Tj
+ET
+endstream
+endobj
+7 0 obj
+<</Type /Page
+/Parent 1 0 R
+/Resources 2 0 R
+/MediaBox [0 0 595.2799999999999727 841.8899999999999864]
+/Contents 8 0 R
+>>
+endobj
+8 0 obj
+<<
+/Length 18643
+>>
+stream
+0.9 w
+0.06 0.1 0.11 RG
+BT
+/F5 9 Tf
+10.3499999999999996 TL
+0.043 0.333 0.388 rg
+42. 783.8899999999999864 Td
+(03) Tj
+ET
+BT
+/F9 17 Tf
+19.5499999999999972 TL
+0.063 0.102 0.11 rg
+72. 782.8899999999999864 Td
+(Export - with first mile) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+42. 762.8899999999999864 m
+553.2799999999999727 762.8899999999999864 l
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+42. 748.8899999999999864 Td
+(EDR collects the cargo from the customer's premises. Identical to section 02 from the store step onward; the difference is entirely) Tj
+T* (in the gate before receive.) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+42. 714.8899999999999864 40. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+47. 703.9400000000000546 Td
+(Step) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+82. 714.8899999999999864 150. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+87. 703.9400000000000546 Td
+(Tester action) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+232. 714.8899999999999864 221.2800000000000296 -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+237. 703.9400000000000546 Td
+(Expected result) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+453.2800000000000296 714.8899999999999864 100. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+458.2800000000000296 703.9400000000000546 Td
+(Technical ref) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 696.8399999999999181 40. -36.2199999999999989 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 685.3799999999999955 Td
+(E2.1) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+82. 696.8399999999999181 150. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+87. 685.3799999999999955 Td
+(Create the export booking with a first-mile) Tj
+T* (pickup address \(or a service type that) Tj
+T* (includes first mile\).) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+232. 696.8399999999999181 221.2800000000000296 -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+237. 685.3799999999999955 Td
+(Booking is flagged hasFirstMile.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+453.2800000000000296 696.8399999999999181 100. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+458.2800000000000296 685.3799999999999955 Td
+(Derived from address OR ) Tj
+T* (service_types.includes_firs) Tj
+T* (t_mile) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 660.6200000000000045 40. -27.4799999999999969 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 649.1599999999999682 Td
+(E2.2) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+82. 660.6200000000000045 150. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+87. 649.1599999999999682 Td
+(Create the first-mile request; assign a) Tj
+T* (vehicle and driver.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+232. 660.6200000000000045 221.2800000000000296 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+237. 649.1599999999999682 Td
+(Driver receives an SMS naming the vehicle, booking, pickup) Tj
+T* (and destination.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+453.2800000000000296 660.6200000000000045 100. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+458.2800000000000296 649.1599999999999682 Td
+(First Mile page) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 633.1399999999999864 40. -27.4799999999999969 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 621.67999999999995 Td
+(E2.3) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+82. 633.1399999999999864 150. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+87. 621.67999999999995 Td
+(Walk the leg: READY_TO_TRANSIT ->) Tj
+T* (IN_TRANSIT -> RECEIVED_TO_PORT.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+232. 633.1399999999999864 221.2800000000000296 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+237. 621.67999999999995 Td
+(Each transition persists.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+453.2800000000000296 633.1399999999999864 100. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+458.2800000000000296 621.67999999999995 Td
+() Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 605.6599999999999682 40. -27.4799999999999969 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 594.2000000000000455 Td
+(E2.4) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+82. 605.6599999999999682 150. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+87. 594.2000000000000455 Td
+(Now run Receive for Loading.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+232. 605.6599999999999682 221.2800000000000296 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+237. 594.2000000000000455 Td
+(Booking is received; truck entrance pre-filled from the first-mile) Tj
+T* (vehicle and driver.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+453.2800000000000296 605.6599999999999682 100. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+458.2800000000000296 594.2000000000000455 Td
+(Then continue at E1.3) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 578.1800000000000637 40. -27.4799999999999969 re
+B
+BT
+/F6 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 566.7200000000000273 Td
+(E2.G1) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+82. 578.1800000000000637 150. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+87. 566.7200000000000273 Td
+(Attempt receive with NO first-mile request) Tj
+T* (created.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+232. 578.1800000000000637 221.2800000000000296 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+237. 566.7200000000000273 Td
+(SKIPPED: "First-mile request not created".) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+453.2800000000000296 578.1800000000000637 100. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+458.2800000000000296 566.7200000000000273 Td
+() Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 550.7000000000000455 40. -36.2199999999999989 re
+B
+BT
+/F6 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 539.2400000000000091 Td
+(E2.G2) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+82. 550.7000000000000455 150. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+87. 539.2400000000000091 Td
+(Attempt receive while first-mile status is) Tj
+T* (IN_TRANSIT.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+232. 550.7000000000000455 221.2800000000000296 -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+237. 539.2400000000000091 Td
+(SKIPPED: "First-mile truck has not arrived".) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+453.2800000000000296 550.7000000000000455 100. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+458.2800000000000296 539.2400000000000091 Td
+(Only) Tj
+T* (RECEIVED_TO_PORT) Tj
+T* (passes) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.78 G
+0. w
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+BT
+/F5 9 Tf
+10.3499999999999996 TL
+0.043 0.333 0.388 rg
+42. 488.4800000000000182 Td
+(04) Tj
+ET
+BT
+/F9 17 Tf
+19.5499999999999972 TL
+0.063 0.102 0.11 rg
+72. 487.4800000000000182 Td
+(Import - self-haul \(customer collects\)) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+42. 467.4800000000000182 m
+553.2799999999999727 467.4800000000000182 l
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+42. 453.4800000000000182 Td
+(The longest flow, and the one with the most guards. The customer assigns their own trucks, signs a booking-level handover, and) Tj
+T* (collects. Test this one first - it exercises truck arrival, loading, weighing, handover, exit paper, and fees.) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.5 w
+42. 421.4800000000000182 511.2799999999999727 -32. re
+B
+BT
+/F5 8 Tf
+9.1999999999999993 TL
+0.275 0.345 0.357 rg
+52. 409.4800000000000182 Td
+(train arrives  >  unload  >  inspect  >  ready for pickup  >  assign truck  >  truck arrival  >  sign) Tj
+T* (handover  >  load  >  truck leaving  >  exit paper  >  deliver) Tj
+ET
+0.8 0.85 0.85 RG
+0.5 w
+0.8 0.85 0.85 RG
+0.5 w
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+42. 377.4800000000000182 34. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+47. 366.5300000000000296 Td
+(Step) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+76. 377.4800000000000182 145. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+81. 366.5300000000000296 Td
+(Tester action) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+221. 377.4800000000000182 234.2800000000000296 -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+226. 366.5300000000000296 Td
+(Expected result) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+455.2800000000000296 377.4800000000000182 98. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+460.2800000000000296 366.5300000000000296 Td
+(Technical ref) Tj
+ET
+0.8 0.85 0.85 RG
+0.5 w
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 359.4300000000000068 34. -36.2199999999999989 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 347.9700000000000273 Td
+(I1.1) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 359.4300000000000068 145. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 347.9700000000000273 Td
+(Import booking \(route DJ -> ET\), paid,) Tj
+T* (no last-mile address and a service type) Tj
+T* (that excludes last mile.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+221. 359.4300000000000068 234.2800000000000296 -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+226. 347.9700000000000273 Td
+(Booking is self-haul.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+455.2800000000000296 359.4300000000000068 98. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+460.2800000000000296 347.9700000000000273 Td
+(Drives) Tj
+T* (usesCustomerTruck) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 323.2100000000000364 34. -44.9599999999999937 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 311.75 Td
+(I1.2) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 323.2100000000000364 145. -44.9599999999999937 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 311.75 Td
+(Import Operations > Arrival Queue.) Tj
+T* (Open the arrived train, assign) Tj
+T* (warehouse/yard/zone per booking, Auto) Tj
+T* (Unload Arrived Bookings.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+221. 323.2100000000000364 234.2800000000000296 -44.9599999999999937 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+226. 311.75 Td
+(Inventory created at UNLOADED. Counter shows n/total unloaded.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+455.2800000000000296 323.2100000000000364 98. -44.9599999999999937 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+460.2800000000000296 311.75 Td
+(Train must be ARRIVED) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 278.25 34. -27.4799999999999969 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 266.7899999999999636 Td
+(I1.3) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 278.25 145. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 266.7899999999999636 Td
+(Inspect the item, outcome PASSED.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+221. 278.25 234.2800000000000296 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+226. 266.7899999999999636 Td
+(Item advances to READY_FOR_PICKUP. Customer receives) Tj
+T* ("Assign a truck for pickup" \(in-app + SMS + email\).) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+455.2800000000000296 278.25 98. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+460.2800000000000296 266.7899999999999636 Td
+(Fires only when self-haul) Tj
+T* (AND no truck assigned) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 250.7699999999999818 34. -36.2199999999999989 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 239.3099999999999454 Td
+(I1.4) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 250.7699999999999818 145. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 239.3099999999999454 Td
+(PORTAL: customer assigns truck\(s\),) Tj
+T* (entering ISO container numbers per) Tj
+T* (truck.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+221. 250.7699999999999818 234.2800000000000296 -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+226. 239.3099999999999454 Td
+(Containers move to stage ASSIGNED and show their planned) Tj
+T* (truck. Booking becomes TRUCK_ASSIGNED.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+455.2800000000000296 250.7699999999999818 98. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+460.2800000000000296 239.3099999999999454 Td
+(20ft -> max 2/truck; 40ft ->) Tj
+T* (1/truck; trucks <=) Tj
+T* (containers) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 214.5499999999999545 34. -36.2199999999999989 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 203.0899999999999181 Td
+(I1.5) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 214.5499999999999545 145. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 203.0899999999999181 Td
+(Backoffice row menu > Truck Arrival.) Tj
+T* (Select the assigned truck, record gate-in) Tj
+T* (time and TARE weight \(tonnes\).) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+221. 214.5499999999999545 234.2800000000000296 -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+226. 203.0899999999999181 Td
+(Truck stamped arrived. A SELF_HAUL handover is generated) Tj
+T* (\(booking-level\) and the customer is notified to sign, on all three) Tj
+T* (channels.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+455.2800000000000296 214.5499999999999545 98. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+460.2800000000000296 203.0899999999999181 Td
+(Truck Arrival disabled until) Tj
+T* (a truck is assigned) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 178.3299999999999272 34. -27.4799999999999969 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 166.8699999999998909 Td
+(I1.6) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 178.3299999999999272 145. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 166.8699999999998909 Td
+(PORTAL: customer opens the booking >) Tj
+T* (Approve delivery.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+221. 178.3299999999999272 234.2800000000000296 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+226. 166.8699999999998909 Td
+(The handover PDF opens for review; approving applies their saved) Tj
+T* (signature and returns the signed PDF.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+455.2800000000000296 178.3299999999999272 98. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+460.2800000000000296 166.8699999999998909 Td
+(Signs all unsigned) Tj
+T* (handovers on the booking) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 150.8499999999999091 34. -36.2199999999999989 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 139.3899999999998727 Td
+(I1.7) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 150.8499999999999091 145. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 139.3899999999998727 Td
+(Open the container list > select the) Tj
+T* (assigned containers > Load onto truck) Tj
+T* (\(pick the arrived truck\).) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+221. 150.8499999999999091 234.2800000000000296 -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+226. 139.3899999999998727 Td
+(Containers move to LOADED; loaded_at stamped.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+455.2800000000000296 150.8499999999999091 98. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+460.2800000000000296 139.3899999999998727 Td
+(Only arrived, not-departed) Tj
+T* (trucks are listed) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 114.6299999999998818 34. -36.2199999999999989 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 103.1699999999998454 Td
+(I1.8) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 114.6299999999998818 145. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 103.1699999999998454 Td
+(Row menu > Truck Leaving. Select the) Tj
+T* (containers on the truck, record gate-out) Tj
+T* (time and GROSS weight.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+221. 114.6299999999998818 234.2800000000000296 -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+226. 103.1699999999998454 Td
+(Net is computed from the selected containers' cargo weight and) Tj
+T* (must equal gross - tare. Release document issued.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+455.2800000000000296 114.6299999999998818 98. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+460.2800000000000296 103.1699999999998454 Td
+(Weight match enforced) Tj
+T* (client- AND server-side) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 78.4099999999998545 34. -18.7399999999999984 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 66.9499999999998181 Td
+(I1.9) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 78.4099999999998545 145. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 66.9499999999998181 Td
+(Generate the exit paper for the truck.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+221. 78.4099999999998545 234.2800000000000296 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+226. 66.9499999999998181 Td
+(PDF lists the truck, driver, and its containers. Containers move to) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+455.2800000000000296 78.4099999999998545 98. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+460.2800000000000296 66.9499999999998181 Td
+(Requires signed handover) Tj
+ET
+0.8 0.85 0.85 RG
+0.5 w
+0.8 0.85 0.85 RG
+0.5 w
+0.78 G
+0. w
+0.8 0.85 0.85 RG
+0.5 w
+42. 36. m
+553.2799999999999727 36. l
+S
+BT
+/F9 8 Tf
+9.1999999999999993 TL
+0.427 0.498 0.51 rg
+42. 22. Td
+(EDR Freight - QA Test Plan) Tj
+ET
+BT
+/F5 7.5 Tf
+8.625 TL
+0.427 0.498 0.51 rg
+530.7799999999999727 22. Td
+(3 / 7) Tj
+ET
+endstream
+endobj
+9 0 obj
+<</Type /Page
+/Parent 1 0 R
+/Resources 2 0 R
+/MediaBox [0 0 595.2799999999999727 841.8899999999999864]
+/Contents 10 0 R
+>>
+endobj
+10 0 obj
+<<
+/Length 20063
+>>
+stream
+0. w
+0.78 G
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+42. 801.8899999999999864 34. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+47. 790.9399999999999409 Td
+(Step) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+76. 801.8899999999999864 145. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+81. 790.9399999999999409 Td
+(Tester action) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+221. 801.8899999999999864 234.2800000000000296 -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+226. 790.9399999999999409 Td
+(Expected result) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+455.2800000000000296 801.8899999999999864 98. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+460.2800000000000296 790.9399999999999409 Td
+(Technical ref) Tj
+ET
+0.8 0.85 0.85 RG
+0.5 w
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 783.8400000000000318 34. -18.7399999999999984 re
+B
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 783.8400000000000318 145. -18.7399999999999984 re
+B
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+221. 783.8400000000000318 234.2800000000000296 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+226. 772.3799999999999955 Td
+(LEFT.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+455.2800000000000296 783.8400000000000318 98. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+460.2800000000000296 772.3799999999999955 Td
+(+ cleared fees) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 765.1000000000000227 34. -27.4799999999999969 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 753.6399999999999864 Td
+(I1.10) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 765.1000000000000227 145. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 753.6399999999999864 Td
+(Deliver the inventory, recording the) Tj
+T* (receiver name.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+221. 765.1000000000000227 234.2800000000000296 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+226. 753.6399999999999864 Td
+(Status DELIVERED; handovers stamped delivered.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+455.2800000000000296 765.1000000000000227 98. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+460.2800000000000296 753.6399999999999864 Td
+(Requires handover signed) Tj
+T* (AND truck departed) Tj
+ET
+0.8 0.85 0.85 RG
+0.5 w
+0.78 G
+0. w
+0.8 0.85 0.85 RG
+0.5 w
+0.8 0.85 0.85 RG
+0.5 w
+0.97 0.93 0.93 rg
+42. 723.6200000000000045 511.2799999999999727 -51. re
+f
+0.62 0.17 0.2 rg
+42. 723.6200000000000045 3. -51. re
+f
+BT
+/F1 8.6 Tf
+9.8899999999999988 TL
+0.275 0.345 0.357 rg
+56. 710.6200000000000045 Td
+(THE SINGLE MOST LIKELY BUG YOU WILL HIT. Exit paper returns 400 when the handover is not fully signed, or when a) Tj
+T* (warehouse fee invoice is ISSUED / PARTIALLY_PAID. In the container list, the Exit Paper button turns grey and clicking it sends) Tj
+T* (the customer a signature request instead of erroring. That is correct behaviour - verify the message, do not file it as a bug.) Tj
+ET
+BT
+/F5 9 Tf
+10.3499999999999996 TL
+0.043 0.333 0.388 rg
+42. 650.6200000000000045 Td
+(05) Tj
+ET
+BT
+/F9 17 Tf
+19.5499999999999972 TL
+0.063 0.102 0.11 rg
+72. 649.6200000000000045 Td
+(Import - EDR last mile) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+42. 629.6200000000000045 m
+553.2799999999999727 629.6200000000000045 l
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+42. 615.6200000000000045 Td
+(EDR delivers to the customer's door. No customer truck, no portal Approve delivery, and the handover is PER DELIVERING) Tj
+T* (TRUCK - not per booking. This is where truck detention accrues.) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+42. 581.6200000000000045 34. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+47. 570.6700000000000728 Td
+(Step) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+76. 581.6200000000000045 145. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+81. 570.6700000000000728 Td
+(Tester action) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+221. 581.6200000000000045 234.2799999999999727 -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+226. 570.6700000000000728 Td
+(Expected result) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+455.2799999999999727 581.6200000000000045 98. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+460.2799999999999727 570.6700000000000728 Td
+(Technical ref) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 563.5699999999999363 34. -36.2199999999999989 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 552.1100000000000136 Td
+(I2.1) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 563.5699999999999363 145. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 552.1100000000000136 Td
+(Import booking with a last-mile delivery) Tj
+T* (address \(or service type including last) Tj
+T* (mile\).) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+221. 563.5699999999999363 234.2799999999999727 -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+226. 552.1100000000000136 Td
+(hasLastMile is true; no "assign a truck" notification is sent.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+455.2799999999999727 563.5699999999999363 98. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+460.2799999999999727 552.1100000000000136 Td
+(EDR haulage - customer) Tj
+T* (assigns nothing) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 527.3500000000000227 34. -27.4799999999999969 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 515.8900000000001 Td
+(I2.2) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 527.3500000000000227 145. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 515.8900000000001 Td
+(Unload from the arrived train, inspect) Tj
+T* (PASSED.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+221. 527.3500000000000227 234.2799999999999727 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+226. 515.8900000000001 Td
+(Item becomes READY_FOR_PICKUP and the last-mile leg is) Tj
+T* (accepted automatically.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+455.2799999999999727 527.3500000000000227 98. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+460.2799999999999727 515.8900000000001 Td
+() Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 499.8700000000000045 34. -18.7399999999999984 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 488.410000000000025 Td
+(I2.3) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 499.8700000000000045 145. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 488.410000000000025 Td
+(Last Mile page: assign vehicle + driver.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+221. 499.8700000000000045 234.2799999999999727 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+226. 488.410000000000025 Td
+(Leg reaches READY_TO_TRANSIT. Row shows Assigned.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+455.2799999999999727 499.8700000000000045 98. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+460.2799999999999727 488.410000000000025 Td
+(Driver notified by SMS) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 481.1299999999999955 34. -27.4799999999999969 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 469.6700000000000159 Td
+(I2.4) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 481.1299999999999955 145. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 469.6700000000000159 Td
+(Truck Arrival from the Last Mile row:) Tj
+T* (gate-in, tare weight.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+221. 481.1299999999999955 234.2799999999999727 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+226. 469.6700000000000159 Td
+(Weighing saved; the assigned last-mile truck is pre-selected.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+455.2799999999999727 481.1299999999999955 98. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+460.2799999999999727 469.6700000000000159 Td
+(Re-opening must show) Tj
+T* (the saved details) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 453.6499999999999773 34. -27.4799999999999969 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 442.1899999999999977 Td
+(I2.5) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 453.6499999999999773 145. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 442.1899999999999977 Td
+(Truck Leaving: gate-out, gross weight.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+221. 453.6499999999999773 234.2799999999999727 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+226. 442.1899999999999977 Td
+(Release document issued; leg moves to IN_TRANSIT. arrivedAt) Tj
+T* (starts the detention clock.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+455.2799999999999727 453.6499999999999773 98. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+460.2799999999999727 442.1899999999999977 Td
+(Detention window opens) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 426.1699999999999591 34. -36.2199999999999989 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 414.7099999999999795 Td
+(I2.6) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 426.1699999999999591 145. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 414.7099999999999795 Td
+(Deliver at the customer's door, recording) Tj
+T* (the receiver name.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+221. 426.1699999999999591 234.2799999999999727 -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+226. 414.7099999999999795 Td
+(Item DELIVERED. An EDR_LAST_MILE handover is generated) Tj
+T* (PER DELIVERING TRUCK, resolved from the container's allocated) Tj
+T* (vehicle.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+455.2799999999999727 426.1699999999999591 98. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+460.2799999999999727 414.7099999999999795 Td
+(Not booking-level) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 389.9499999999999318 34. -27.4799999999999969 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 378.4899999999999523 Td
+(I2.7) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 389.9499999999999318 145. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 378.4899999999999523 Td
+(Return the vehicle > mark the leg) Tj
+T* (DELIVERED.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+221. 389.9499999999999318 234.2799999999999727 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+226. 378.4899999999999523 Td
+(deliveredAt stamped; detention clock stops.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+455.2799999999999727 389.9499999999999318 98. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+460.2799999999999727 378.4899999999999523 Td
+() Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 362.4699999999999136 34. -27.4799999999999969 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 351.0099999999999341 Td
+(I2.8) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 362.4699999999999136 145. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 351.0099999999999341 Td
+(Preview, then generate the truck) Tj
+T* (detention invoice.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+221. 362.4699999999999136 234.2799999999999727 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+226. 351.0099999999999341 Td
+(Charged per truck per day beyond the grace hours, at the matching) Tj
+T* (tier. See section 07.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+455.2799999999999727 362.4699999999999136 98. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+460.2799999999999727 351.0099999999999341 Td
+(POST /last-mile/:id/genera) Tj
+T* (te-truck-detention-invoice) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 334.9899999999998954 34. -36.2199999999999989 re
+B
+BT
+/F6 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 323.529999999999859 Td
+(I2.G) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+76. 334.9899999999998954 145. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+81. 323.529999999999859 Td
+(Open the booking in the portal.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+221. 334.9899999999998954 234.2799999999999727 -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+226. 323.529999999999859 Td
+(ABSENT: Approve delivery must NOT appear. The portal flag) Tj
+T* (counts only SELF_HAUL handovers; EDR handovers are signed) Tj
+T* (by the receiver at the door.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+455.2799999999999727 334.9899999999998954 98. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+460.2799999999999727 323.529999999999859 Td
+(Regression check) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.78 G
+0. w
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+BT
+/F5 9 Tf
+10.3499999999999996 TL
+0.043 0.333 0.388 rg
+42. 272.7699999999998681 Td
+(06) Tj
+ET
+BT
+/F9 17 Tf
+19.5499999999999972 TL
+0.063 0.102 0.11 rg
+72. 271.7699999999998681 Td
+(Marshalling, gate pass, interchange) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+42. 251.7699999999998681 m
+553.2799999999999727 251.7699999999998681 l
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+42. 237.7699999999998681 Td
+(Documents are generated, not uploaded. Each has a precondition; test the precondition, not just the PDF.) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+42. 215.7699999999998681 92. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+47. 204.8199999999998226 Td
+(Document) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+134. 215.7699999999998681 95. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+139. 204.8199999999998226 Td
+(When) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+229. 215.7699999999998681 146.1434567681443468 -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+234. 204.8199999999998226 Td
+(Precondition) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+375.1434567681443468 215.7699999999998681 178.1365432318555975 -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+380.1434567681443468 204.8199999999998226 Td
+(Verify) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 197.7199999999999136 92. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 186.2599999999998772 Td
+(GRN) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+134. 197.7199999999999136 95. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+139. 186.2599999999998772 Td
+(On receive to warehouse) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+229. 197.7199999999999136 146.1434567681443468 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+234. 186.2599999999998772 Td
+(Booking PAID; route direction matches;) Tj
+T* (export needs a truck entrance) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+375.1434567681443468 197.7199999999999136 178.1365432318555975 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+380.1434567681443468 186.2599999999998772 Td
+(Number format GRN-<DIR>-<YYYYMMDD>-<8>;) Tj
+T* (PDF opens; customer SMS sent) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 170.2399999999998954 92. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 158.779999999999859 Td
+(Import load list /) Tj
+T* (marshalling) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+134. 170.2399999999998954 95. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+139. 158.779999999999859 Td
+(Import train, before) Tj
+T* (unload) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+229. 170.2399999999998954 146.1434567681443468 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+234. 158.779999999999859 Td
+(Schedule has bookings assigned) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+375.1434567681443468 170.2399999999998954 178.1365432318555975 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+380.1434567681443468 158.779999999999859 Td
+(Summary endpoint and printable PDF agree;) Tj
+T* (portrait/landscape both render) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 142.7599999999998772 92. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 131.2999999999998408 Td
+(Export marshalling /) Tj
+T* (load list) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+134. 142.7599999999998772 95. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+139. 131.2999999999998408 Td
+(Export train, after loading) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+229. 142.7599999999998772 146.1434567681443468 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+234. 131.2999999999998408 Td
+(Items LOADED onto wagons) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+375.1434567681443468 142.7599999999998772 178.1365432318555975 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+380.1434567681443468 131.2999999999998408 Td
+(Wagon, booking, container rows are complete) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 115.279999999999859 92. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 103.8199999999998226 Td
+(Gate pass) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+134. 115.279999999999859 95. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+139. 103.8199999999998226 Td
+(Djibouti-side operations) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+229. 115.279999999999859 146.1434567681443468 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+234. 103.8199999999998226 Td
+(Granted per schedule) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+375.1434567681443468 115.279999999999859 178.1365432318555975 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+380.1434567681443468 103.8199999999998226 Td
+(gatepass_granted_at is set; export Djibouti unload) Tj
+T* (reads this same field) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 87.7999999999998408 92. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 76.3399999999998045 Td
+(Interchange document) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+134. 87.7999999999998408 95. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+139. 76.3399999999998045 Td
+(Automatically, after a) Tj
+T* (successful Djibouti) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+229. 87.7999999999998408 146.1434567681443468 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+234. 76.3399999999998045 Td
+(At least one item unloaded) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+375.1434567681443468 87.7999999999998408 178.1365432318555975 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+380.1434567681443468 76.3399999999998045 Td
+(Document number returned in the unload) Tj
+T* (response; visible in Interchange Documents) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+0.78 G
+0. w
+0.8 0.85 0.85 RG
+0.5 w
+42. 36. m
+553.2799999999999727 36. l
+S
+BT
+/F9 8 Tf
+9.1999999999999993 TL
+0.427 0.498 0.51 rg
+42. 22. Td
+(EDR Freight - QA Test Plan) Tj
+ET
+BT
+/F5 7.5 Tf
+8.625 TL
+0.427 0.498 0.51 rg
+530.7799999999999727 22. Td
+(4 / 7) Tj
+ET
+endstream
+endobj
+11 0 obj
+<</Type /Page
+/Parent 1 0 R
+/Resources 2 0 R
+/MediaBox [0 0 595.2799999999999727 841.8899999999999864]
+/Contents 12 0 R
+>>
+endobj
+12 0 obj
+<<
+/Length 13441
+>>
+stream
+0. w
+0.78 G
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+42. 801.8899999999999864 92. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+47. 790.9399999999999409 Td
+(Document) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+134. 801.8899999999999864 95. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+139. 790.9399999999999409 Td
+(When) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+229. 801.8899999999999864 146.1434567681443468 -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+234. 790.9399999999999409 Td
+(Precondition) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+375.1434567681443468 801.8899999999999864 178.1365432318555975 -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+380.1434567681443468 790.9399999999999409 Td
+(Verify) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 783.8400000000000318 92. -18.7399999999999984 re
+B
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+134. 783.8400000000000318 95. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+139. 772.3799999999999955 Td
+(unload) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+229. 783.8400000000000318 146.1434567681443468 -18.7399999999999984 re
+B
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+375.1434567681443468 783.8400000000000318 178.1365432318555975 -18.7399999999999984 re
+B
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 765.1000000000000227 92. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 753.6399999999999864 Td
+(Handover) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+134. 765.1000000000000227 95. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+139. 753.6399999999999864 Td
+(Self-haul: on truck arrival.) Tj
+T* (EDR: at delivery.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+229. 765.1000000000000227 146.1434567681443468 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+234. 753.6399999999999864 Td
+(See sections 04 / 05) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+375.1434567681443468 765.1000000000000227 178.1365432318555975 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+380.1434567681443468 753.6399999999999864 Td
+(Self-haul is booking-level, one per booking; EDR) Tj
+T* (is one per delivering truck) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 737.6200000000000045 92. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 726.1599999999999682 Td
+(Exit paper / release doc) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+134. 737.6200000000000045 95. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+139. 726.1599999999999682 Td
+(Truck leaving) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+229. 737.6200000000000045 146.1434567681443468 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+234. 726.1599999999999682 Td
+(Handover fully signed AND no unpaid) Tj
+T* (warehouse fee) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+375.1434567681443468 737.6200000000000045 178.1365432318555975 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+380.1434567681443468 726.1599999999999682 Td
+(Weights on the paper match the gate weighing) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.78 G
+0. w
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+0.97 0.94 0.89 rg
+42. 696.1399999999999864 511.2799999999999727 -51. re
+f
+0.54 0.35 0.04 rg
+42. 696.1399999999999864 3. -51. re
+f
+BT
+/F1 8.6 Tf
+9.8899999999999988 TL
+0.275 0.345 0.357 rg
+56. 683.1399999999999864 Td
+(CROSS-MODULE QUIRK WORTH CONFIRMING WITH THE TEAM. The EXPORT Djibouti unload checks the gate-pass flag) Tj
+T* (stored on the IMPORT Djibouti operations record \(import_djibouti_operations.gatepass_granted_at\). It works, but it is surprising.) Tj
+T* (If an export unload silently skips every item, check that field first.) Tj
+ET
+BT
+/F5 9 Tf
+10.3499999999999996 TL
+0.043 0.333 0.388 rg
+42. 623.1399999999999864 Td
+(07) Tj
+ET
+BT
+/F9 17 Tf
+19.5499999999999972 TL
+0.063 0.102 0.11 rg
+72. 622.1399999999999864 Td
+(Fee rules) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+42. 602.1399999999999864 m
+553.2799999999999727 602.1399999999999864 l
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+42. 588.1399999999999864 Td
+(Four rule types. Two are day-based with free days and tiers; double handling is a flat rate multiplied by a basis; truck detention is) Tj
+T* (hour-graced and vehicle-scoped.) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+42. 554.1399999999999864 88. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+47. 543.1900000000000546 Td
+(Rule type) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+130. 554.1399999999999864 72. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+135. 543.1900000000000546 Td
+(Charged on) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+202. 554.1399999999999864 85. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+207. 543.1900000000000546 Td
+(Key fields) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+287. 554.1399999999999864 266.2799999999999727 -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+292. 543.1900000000000546 Td
+(Test cases) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 536.0899999999999181 88. -27.4799999999999969 re
+B
+BT
+/F5 7 Tf
+8.0499999999999989 TL
+0.063 0.102 0.11 rg
+47. 525.1399999999999864 Td
+(STORAGE_FEE) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+130. 536.0899999999999181 72. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+135. 524.6299999999999955 Td
+(Days in storage) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+202. 536.0899999999999181 85. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+207. 524.6299999999999955 Td
+(free days, tiers) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+287. 536.0899999999999181 266.2799999999999727 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+292. 524.6299999999999955 Td
+(Within free days -> zero. One day past -> tier 1. Cross a tier boundary ->) Tj
+T* (correct tier rate.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 508.6099999999999568 88. -27.4799999999999969 re
+B
+BT
+/F5 7 Tf
+8.0499999999999989 TL
+0.063 0.102 0.11 rg
+47. 497.6599999999999682 Td
+(DEMURRAGE_FEE) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+130. 508.6099999999999568 72. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+135. 497.1499999999999773 Td
+(Days beyond free) Tj
+T* (time) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+202. 508.6099999999999568 85. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+207. 497.1499999999999773 Td
+(free days, tiers) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+287. 508.6099999999999568 266.2799999999999727 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+292. 497.1499999999999773 Td
+(Same boundary tests. Confirm it blocks exit paper and delivery while) Tj
+T* (ISSUED.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 481.1299999999999386 88. -44.9599999999999937 re
+B
+BT
+/F5 7 Tf
+8.0499999999999989 TL
+0.063 0.102 0.11 rg
+47. 470.17999999999995 Td
+(DOUBLE_HANDLING_FE) Tj
+T* (E) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+130. 481.1299999999999386 72. -44.9599999999999937 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+135. 469.6699999999999591 Td
+(Flat rate x quantity) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+202. 481.1299999999999386 85. -44.9599999999999937 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+207. 469.6699999999999591 Td
+(basis:) Tj
+T* (PER_CONTAINER |) Tj
+T* (PER_TON |) Tj
+T* (PER_ITEM) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+287. 481.1299999999999386 266.2799999999999727 -44.9599999999999937 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+292. 469.6699999999999591 Td
+(Container booking -> PER_CONTAINER uses container count. Bulk ->) Tj
+T* (PER_TON uses tonnage. Break-bulk machinery -> PER_ITEM uses item) Tj
+T* (count. IMPORT ONLY. Free days and tiers must not apply.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 436.1699999999999591 88. -36.2199999999999989 re
+B
+BT
+/F5 7 Tf
+8.0499999999999989 TL
+0.063 0.102 0.11 rg
+47. 425.2199999999999704 Td
+(TRUCK_DETENTION_FE) Tj
+T* (E) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+130. 436.1699999999999591 72. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+135. 424.7099999999999795 Td
+(Per truck, per day) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+202. 436.1699999999999591 85. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+207. 424.7099999999999795 Td
+(free_hours grace,) Tj
+T* (tiers, vehicle type) Tj
+T* (scope) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+287. 436.1699999999999591 266.2799999999999727 -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+292. 424.7099999999999795 Td
+(Return inside the grace window -> zero. Just past grace -> day 1 at tier 1.) Tj
+T* (Multi-day -> tier escalation. A vehicle type outside the rule's scope -> no) Tj
+T* (charge. IMPORT ONLY.) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.78 G
+0. w
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+BT
+/F2 8 Tf
+9.1999999999999993 TL
+0.063 0.102 0.11 rg
+42. 377.9499999999999318 Td
+(FEE BEHAVIOUR TO VERIFY ON EVERY RULE) Tj
+ET
+0.43 0.5 0.51 RG
+0.6 w
+43. 373.4499999999999318 8. -8. re
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+60. 365.9499999999999318 Td
+(Preview before invoice. The preview amount must equal the issued invoice total.) Tj
+ET
+0.43 0.5 0.51 RG
+0.6 w
+43. 356.4499999999999318 8. -8. re
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+60. 348.9499999999999318 Td
+(Notification on issue. Issuing a warehouse fee invoice sends the customer an in-app INVOICE_ISSUED notification AND) Tj
+T* (an SMS, deep-linked to pay.) Tj
+ET
+0.43 0.5 0.51 RG
+0.6 w
+43. 327.4499999999999318 8. -8. re
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+60. 319.9499999999999318 Td
+(Clearance gate. While a warehouse-source invoice is ISSUED or PARTIALLY_PAID, exit paper, terminal release, and) Tj
+T* (Approve delivery are all blocked.) Tj
+ET
+0.43 0.5 0.51 RG
+0.6 w
+43. 298.4499999999999318 8. -8. re
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+60. 290.9499999999999318 Td
+(Payable-but-uninvoiced. If fees are payable and no invoice exists yet, release is still blocked with "Generate and fully) Tj
+T* (pay...". Confirm the operator can generate it from that state.) Tj
+ET
+0.43 0.5 0.51 RG
+0.6 w
+43. 269.4499999999999318 8. -8. re
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+60. 261.9499999999999318 Td
+(Fully paid -> release proceeds; a receipt PDF is available.) Tj
+ET
+0.43 0.5 0.51 RG
+0.6 w
+43. 252.4499999999999318 8. -8. re
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+60. 244.9499999999999318 Td
+(Edit a rule \(rate, free days, tiers, grace hours\) and confirm the next preview reflects it.) Tj
+ET
+BT
+/F5 9 Tf
+10.3499999999999996 TL
+0.043 0.333 0.388 rg
+42. 211.9499999999999318 Td
+(08) Tj
+ET
+BT
+/F9 17 Tf
+19.5499999999999972 TL
+0.063 0.102 0.11 rg
+72. 210.9499999999999318 Td
+(Allocation rules) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+42. 190.9499999999999318 m
+553.2799999999999727 190.9499999999999318 l
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+42. 176.9499999999999318 Td
+(Where an item is stored is decided by the first matching rule, in priority order. Test the precedence, not just one rule.) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+42. 154.9499999999999318 258.0206829268292381 -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+47. 143.9999999999998863 Td
+(Match criteria \(any may be null = wildcard\)) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+300.0206829268292381 154.9499999999999318 253.2593170731707346 -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+305.0206829268292381 143.9999999999998863 Td
+(Targets) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 136.8999999999999773 258.0206829268292381 -34.1499999999999986 re
+B
+BT
+/F5 7 Tf
+8.0499999999999989 TL
+0.063 0.102 0.11 rg
+47. 125.9499999999999318 Td
+(freight_type, trade_direction, cargo_type_code,) Tj
+T* (container_status, requires_inspection, ordered by priority) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+300.0206829268292381 136.8999999999999773 253.2593170731707346 -34.1499999999999986 re
+B
+BT
+/F5 7 Tf
+8.0499999999999989 TL
+0.275 0.345 0.357 rg
+305.0206829268292381 125.9499999999999318 Td
+(target_facility_code, target_warehouse_code,) Tj
+T* (target_yard_code \(required\), target_zone_code,) Tj
+T* (storage_type) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.78 G
+0. w
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+BT
+/F2 8 Tf
+9.1999999999999993 TL
+0.063 0.102 0.11 rg
+42. 80.75 Td
+(PRECEDENCE, HIGHEST FIRST) Tj
+ET
+0.8 0.85 0.85 RG
+0.5 w
+42. 36. m
+553.2799999999999727 36. l
+S
+BT
+/F9 8 Tf
+9.1999999999999993 TL
+0.427 0.498 0.51 rg
+42. 22. Td
+(EDR Freight - QA Test Plan) Tj
+ET
+BT
+/F5 7.5 Tf
+8.625 TL
+0.427 0.498 0.51 rg
+530.7799999999999727 22. Td
+(5 / 7) Tj
+ET
+endstream
+endobj
+13 0 obj
+<</Type /Page
+/Parent 1 0 R
+/Resources 2 0 R
+/MediaBox [0 0 595.2799999999999727 841.8899999999999864]
+/Contents 14 0 R
+>>
+endobj
+14 0 obj
+<<
+/Length 21215
+>>
+stream
+0.9 w
+0.06 0.1 0.11 RG
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+42. 793.8899999999999864 20. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+47. 782.9399999999999409 Td
+(#) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+62. 793.8899999999999864 120. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+67. 782.9399999999999409 Td
+(Source of the location) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+182. 793.8899999999999864 207.6664663121432 -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+187. 782.9399999999999409 Td
+(How to trigger) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+389.6664663121432 793.8899999999999864 163.6135336878567728 -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+394.6664663121432 782.9399999999999409 Td
+(Note recorded) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 775.8400000000000318 20. -18.7399999999999984 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 764.3799999999999955 Td
+(1) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+62. 775.8400000000000318 120. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+67. 764.3799999999999955 Td
+(Operator selection) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+182. 775.8400000000000318 207.6664663121432 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+187. 764.3799999999999955 Td
+(Store modal > pick warehouse + yard + zone) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+389.6664663121432 775.8400000000000318 163.6135336878567728 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+394.6664663121432 764.3799999999999955 Td
+("Stored at operator-selected location") Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 757.1000000000000227 20. -18.7399999999999984 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 745.6399999999999864 Td
+(2) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+62. 757.1000000000000227 120. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+67. 745.6399999999999864 Td
+(Allocation rule) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+182. 757.1000000000000227 207.6664663121432 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+187. 745.6399999999999864 Td
+(Leave the Store modal blank; a matching rule exists) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+389.6664663121432 757.1000000000000227 163.6135336878567728 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+394.6664663121432 745.6399999999999864 Td
+("Stored by allocation rule <name>") Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 738.3600000000000136 20. -18.7399999999999984 re
+B
+BT
+/F5 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 726.8999999999999773 Td
+(3) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+62. 738.3600000000000136 120. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+67. 726.8999999999999773 Td
+(Capacity-balanced fallback) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+182. 738.3600000000000136 207.6664663121432 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+187. 726.8999999999999773 Td
+(Leave blank; no rule matches) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+389.6664663121432 738.3600000000000136 163.6135336878567728 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+394.6664663121432 726.8999999999999773 Td
+("Stored by capacity-balanced allocation") Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.78 G
+0. w
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+0.43 0.5 0.51 RG
+0.6 w
+43. 711.1200000000000045 8. -8. re
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+60. 703.6200000000000045 Td
+(Two matching rules -> the LOWER priority number wins.) Tj
+ET
+0.43 0.5 0.51 RG
+0.6 w
+43. 694.1200000000000045 8. -8. re
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+60. 686.6200000000000045 Td
+(Yard dropdowns are filtered by freight type - container bookings offer container yards only.) Tj
+ET
+0.43 0.5 0.51 RG
+0.6 w
+43. 677.1200000000000045 8. -8. re
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+60. 669.6200000000000045 Td
+(Only ACTIVE warehouses, yards and zones are selectable.) Tj
+ET
+0.43 0.5 0.51 RG
+0.6 w
+43. 660.1200000000000045 8. -8. re
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+60. 652.6200000000000045 Td
+(Storing beyond a zone's capacity is rejected; capacities are compared in TONNES.) Tj
+ET
+0.43 0.5 0.51 RG
+0.6 w
+43. 643.1200000000000045 8. -8. re
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+60. 635.6200000000000045 Td
+(Move an item to another warehouse/yard/zone -> capacity released at source, taken at destination.) Tj
+ET
+0.43 0.5 0.51 RG
+0.6 w
+43. 626.1200000000000045 8. -8. re
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+60. 618.6200000000000045 Td
+(Edit a rule, an existing warehouse, a yard, and a zone - all four must be editable.) Tj
+ET
+BT
+/F5 9 Tf
+10.3499999999999996 TL
+0.043 0.333 0.388 rg
+42. 585.6200000000000045 Td
+(09) Tj
+ET
+BT
+/F9 17 Tf
+19.5499999999999972 TL
+0.063 0.102 0.11 rg
+72. 584.6200000000000045 Td
+(Negative & guard cases) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+42. 564.6200000000000045 m
+553.2799999999999727 564.6200000000000045 l
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+42. 550.6200000000000045 Td
+(Every row here is intended behaviour. The test passes when the action is REFUSED with the stated message. Anything that) Tj
+T* (succeeds is the bug.) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+42. 516.6200000000000045 74. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+47. 505.6700000000000159 Td
+(Area) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+116. 516.6200000000000045 195. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+121. 505.6700000000000159 Td
+(Attempt) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+311. 516.6200000000000045 242.2800000000000296 -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+316. 505.6700000000000159 Td
+(Expected refusal) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 498.5699999999999932 74. -27.4799999999999969 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 487.1100000000000136 Td
+(Booking) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+116. 498.5699999999999932 195. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+121. 487.1100000000000136 Td
+(Enter a container number that is not 4 letters + 7 digits) Tj
+T* (\(e.g. MSKU10105185, 3456789\).) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+311. 498.5699999999999932 242.2800000000000296 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+316. 487.1100000000000136 Td
+("Use ISO format: 4 letters + 7 digits". Lowercase is auto-uppercased;) Tj
+T* (input capped at 11 characters.) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 471.089999999999975 74. -18.7399999999999984 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 459.6299999999999955 Td
+(Receive) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+116. 471.089999999999975 195. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+121. 459.6299999999999955 Td
+(Receive a booking that is not PAID.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+311. 471.089999999999975 242.2800000000000296 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+316. 459.6299999999999955 Td
+(Skipped: "Booking not PAID".) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 452.3499999999999659 74. -18.7399999999999984 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 440.8899999999999864 Td
+(Receive) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+116. 452.3499999999999659 195. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+121. 440.8899999999999864 Td
+(Receive the same booking twice.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+311. 452.3499999999999659 242.2800000000000296 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+316. 440.8899999999999864 Td
+(Skipped: "Already received".) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 433.6099999999999568 74. -18.7399999999999984 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 422.1499999999999773 Td
+(Receive) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+116. 433.6099999999999568 195. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+121. 422.1499999999999773 Td
+(Export receive with no truck entrance captured.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+311. 433.6099999999999568 242.2800000000000296 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+316. 422.1499999999999773 Td
+(Rejected before any inventory is created.) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 414.8699999999999477 74. -18.7399999999999984 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 403.4099999999999682 Td
+(Truck assign) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+116. 414.8699999999999477 195. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+121. 403.4099999999999682 Td
+(Put two 40ft containers on one truck.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+311. 414.8699999999999477 242.2800000000000296 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+316. 403.4099999999999682 Td
+("A 40ft container fills the truck - assign only 1 container to this truck".) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 396.1299999999999386 74. -18.7399999999999984 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 384.6699999999999591 Td
+(Truck assign) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+116. 396.1299999999999386 195. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+121. 384.6699999999999591 Td
+(Put three containers on one truck.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+311. 396.1299999999999386 242.2800000000000296 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+316. 384.6699999999999591 Td
+("A truck carries at most 2 containers".) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 377.3899999999999295 74. -18.7399999999999984 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 365.92999999999995 Td
+(Truck assign) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+116. 377.3899999999999295 195. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+121. 365.92999999999995 Td
+(Assign more trucks than the booking has containers.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+311. 377.3899999999999295 242.2800000000000296 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+316. 365.92999999999995 Td
+("Cannot assign more trucks than containers...".) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 358.6499999999999204 74. -27.4799999999999969 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 347.1899999999999409 Td
+(Truck assign) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+116. 358.6499999999999204 195. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+121. 347.1899999999999409 Td
+(Assign a container from another booking, or one) Tj
+T* (already on another truck.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+311. 358.6499999999999204 242.2800000000000296 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+316. 347.1899999999999409 Td
+("...is not one of this booking's containers" / "...already loaded onto) Tj
+T* (another truck".) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 331.1699999999999022 74. -18.7399999999999984 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 319.7099999999999227 Td
+(Truck assign) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+116. 331.1699999999999022 195. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+121. 319.7099999999999227 Td
+(Edit a truck AFTER it has arrived.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+311. 331.1699999999999022 242.2800000000000296 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+316. 319.7099999999999227 Td
+(Refused - edits are allowed only until arrival.) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 312.42999999999995 74. -27.4799999999999969 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 300.9699999999999136 Td
+(Loading) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+116. 312.42999999999995 195. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+121. 300.9699999999999136 Td
+(Load containers onto a truck that has not arrived.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+311. 312.42999999999995 242.2800000000000296 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+316. 300.9699999999999136 Td
+("Record the truck arrival before loading...". The truck picker lists only) Tj
+T* (arrived, not-departed trucks.) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 284.9499999999999318 74. -18.7399999999999984 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 273.4899999999998954 Td
+(Loading) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+116. 284.9499999999999318 195. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+121. 273.4899999999998954 Td
+(Load onto a truck that has already departed.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+311. 284.9499999999999318 242.2800000000000296 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+316. 273.4899999999998954 Td
+("This truck has already left - its load is locked".) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 266.2099999999999227 74. -27.4799999999999969 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 254.7499999999998863 Td
+(Stages) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+116. 266.2099999999999227 195. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+121. 254.7499999999998863 Td
+(Customer assigns containers to a truck, then check the) Tj
+T* (container list.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+311. 266.2099999999999227 242.2800000000000296 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+316. 254.7499999999998863 Td
+(Stage is ASSIGNED, NEVER LOADED. Exit Paper is not offered.) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 238.7299999999999045 74. -27.4799999999999969 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 227.2699999999998681 Td
+(Truck leaving) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+116. 238.7299999999999045 195. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+121. 227.2699999999998681 Td
+(Enter a gross weight where gross - tare != the selected) Tj
+T* (containers' cargo weight.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+311. 238.7299999999999045 242.2800000000000296 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+316. 227.2699999999998681 Td
+("Weight mismatch...". Exit paper and gate clearance blocked, client) Tj
+T* (and server.) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 211.2499999999998863 74. -18.7399999999999984 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 199.7899999999998499 Td
+(Truck leaving) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+116. 211.2499999999998863 195. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+121. 199.7899999999998499 Td
+(Save leaving with no containers selected.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+311. 211.2499999999998863 242.2800000000000296 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+316. 199.7899999999998499 Td
+("Select the containers loaded on this truck".) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 192.5099999999998772 74. -27.4799999999999969 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 181.0499999999998408 Td
+(Exit paper) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+116. 192.5099999999998772 195. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+121. 181.0499999999998408 Td
+(Generate before the handover is signed.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+311. 192.5099999999998772 242.2800000000000296 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+316. 181.0499999999998408 Td
+("Handover must be signed...". In the container list the button is grey) Tj
+T* (and instead SENDS THE CUSTOMER A SIGNATURE REQUEST.) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 165.029999999999859 74. -18.7399999999999984 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 153.5699999999998226 Td
+(Exit paper) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+116. 165.029999999999859 195. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+121. 153.5699999999998226 Td
+(Generate with an ISSUED demurrage/storage invoice.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+311. 165.029999999999859 242.2800000000000296 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+316. 153.5699999999998226 Td
+("...must be fully paid before terminal release".) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 146.2899999999998499 74. -27.4799999999999969 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 134.8299999999998136 Td
+(Approve delivery) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+116. 146.2899999999998499 195. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+121. 134.8299999999998136 Td
+(Approve without a saved signature.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+311. 146.2899999999998499 242.2800000000000296 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+316. 134.8299999999998136 Td
+("Please save your signature..." and the portal routes to the signature) Tj
+T* (page.) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 118.8099999999998317 74. -18.7399999999999984 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 107.3499999999997954 Td
+(Approve delivery) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+116. 118.8099999999998317 195. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+121. 107.3499999999997954 Td
+(Approve before warehouse inspection has passed.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+311. 118.8099999999998317 242.2800000000000296 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+316. 107.3499999999997954 Td
+("Delivery can be approved after warehouse inspection has passed".) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 100.0699999999998226 74. -18.7399999999999984 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 88.6099999999997863 Td
+(Approve delivery) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+116. 100.0699999999998226 195. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+121. 88.6099999999997863 Td
+(Approve when a truck is assigned but has not arrived.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+311. 100.0699999999998226 242.2800000000000296 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+316. 88.6099999999997863 Td
+("Customer truck arrival must be recorded before delivery approval".) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 81.3299999999998136 74. -27.4799999999999969 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 69.8699999999997772 Td
+(Deliver) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+116. 81.3299999999998136 195. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+121. 69.8699999999997772 Td
+(Deliver before a release order was issued, or before) Tj
+T* (the self-haul truck has left.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+311. 81.3299999999998136 242.2800000000000296 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+316. 69.8699999999997772 Td
+("A release order must be issued..." / "Deliver is available only after) Tj
+T* (the customer truck has left".) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+0.78 G
+0. w
+0.8 0.85 0.85 RG
+0.5 w
+42. 36. m
+553.2799999999999727 36. l
+S
+BT
+/F9 8 Tf
+9.1999999999999993 TL
+0.427 0.498 0.51 rg
+42. 22. Td
+(EDR Freight - QA Test Plan) Tj
+ET
+BT
+/F5 7.5 Tf
+8.625 TL
+0.427 0.498 0.51 rg
+530.7799999999999727 22. Td
+(6 / 7) Tj
+ET
+endstream
+endobj
+15 0 obj
+<</Type /Page
+/Parent 1 0 R
+/Resources 2 0 R
+/MediaBox [0 0 595.2799999999999727 841.8899999999999864]
+/Contents 16 0 R
+>>
+endobj
+16 0 obj
+<<
+/Length 15025
+>>
+stream
+0. w
+0.78 G
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+42. 801.8899999999999864 74. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+47. 790.9399999999999409 Td
+(Area) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+116. 801.8899999999999864 195. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+121. 790.9399999999999409 Td
+(Attempt) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+311. 801.8899999999999864 242.2800000000000296 -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+316. 790.9399999999999409 Td
+(Expected refusal) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 783.8400000000000318 74. -18.7399999999999984 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 772.3799999999999955 Td
+(Djibouti unload) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+116. 783.8400000000000318 195. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+121. 772.3799999999999955 Td
+(Unload an export train with no gate pass granted.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+311. 783.8400000000000318 242.2800000000000296 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+316. 772.3799999999999955 Td
+(Items skipped; no interchange document generated.) Tj
+ET
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 765.1000000000000227 74. -27.4799999999999969 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 753.6399999999999864 Td
+(Warehouse) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+116. 765.1000000000000227 195. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+121. 753.6399999999999864 Td
+(Store into an INACTIVE warehouse/yard/zone, or) Tj
+T* (beyond capacity.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+311. 765.1000000000000227 242.2800000000000296 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+316. 753.6399999999999864 Td
+(Not selectable / "No active warehouse yard/zone is available" /) Tj
+T* (capacity error.) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.78 G
+0. w
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+BT
+/F5 9 Tf
+10.3499999999999996 TL
+0.043 0.333 0.388 rg
+42. 711.6200000000000045 Td
+(10) Tj
+ET
+BT
+/F9 17 Tf
+19.5499999999999972 TL
+0.063 0.102 0.11 rg
+72. 710.6200000000000045 Td
+(Notifications) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+42. 690.6200000000000045 m
+553.2799999999999727 690.6200000000000045 l
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+42. 676.6200000000000045 Td
+(All customer notifications land in the same portal inbox. Verify the message, the deep link, and - where noted - the SMS and) Tj
+T* (email.) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+42. 642.6200000000000045 96. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+47. 631.6700000000000728 Td
+(Notification) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+138. 642.6200000000000045 257.2800000000000296 -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+143. 631.6700000000000728 Td
+(Fires when) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+395.2800000000000296 642.6200000000000045 74. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+400.2800000000000296 631.6700000000000728 Td
+(Channels) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+469.2800000000000296 642.6200000000000045 84. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+474.2800000000000296 631.6700000000000728 Td
+(Deep link) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 624.5699999999999363 96. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 613.1100000000000136 Td
+(Shipment dispatched) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+138. 624.5699999999999363 257.2800000000000296 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+143. 613.1100000000000136 Td
+(Train schedule dispatched, per booking) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+395.2800000000000296 624.5699999999999363 74. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+400.2800000000000296 613.1100000000000136 Td
+(In-app, SMS, email) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+469.2800000000000296 624.5699999999999363 84. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+474.2800000000000296 613.1100000000000136 Td
+(Booking) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 605.8299999999999272 96. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 594.3700000000000045 Td
+(Shipment arrived) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+138. 605.8299999999999272 257.2800000000000296 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+143. 594.3700000000000045 Td
+(Train schedule arrived, per booking) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+395.2800000000000296 605.8299999999999272 74. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+400.2800000000000296 594.3700000000000045 Td
+(In-app, SMS, email) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+469.2800000000000296 605.8299999999999272 84. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+474.2800000000000296 594.3700000000000045 Td
+(Booking) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 587.0899999999999181 96. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 575.6299999999999955 Td
+(Assign a truck for pickup) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+138. 587.0899999999999181 257.2800000000000296 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+143. 575.6299999999999955 Td
+(Export: on warehouse receive. Import: on inspection pass -> ready for) Tj
+T* (pickup. Only if self-haul AND no truck assigned.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+395.2800000000000296 587.0899999999999181 74. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+400.2800000000000296 575.6299999999999955 Td
+(In-app, SMS, email) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+469.2800000000000296 587.0899999999999181 84. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+474.2800000000000296 575.6299999999999955 Td
+(Booking > assign) Tj
+T* (truck) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 559.6099999999999 96. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 548.1499999999999773 Td
+(Handover - signature) Tj
+T* (needed) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+138. 559.6099999999999 257.2800000000000296 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+143. 548.1499999999999773 Td
+(Self-haul truck arrives \(handover generated\), and re-sent when an) Tj
+T* (operator requests a signature from the Exit Paper button.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+395.2800000000000296 559.6099999999999 74. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+400.2800000000000296 548.1499999999999773 Td
+(In-app, SMS, email) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+469.2800000000000296 559.6099999999999 84. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+474.2800000000000296 548.1499999999999773 Td
+(Booking > approve) Tj
+T* (delivery) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 532.1299999999998818 96. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 520.6699999999999591 Td
+(Warehouse fee due) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+138. 532.1299999999998818 257.2800000000000296 -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+143. 520.6699999999999591 Td
+(Storage / demurrage invoice issued) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+395.2800000000000296 532.1299999999998818 74. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+400.2800000000000296 520.6699999999999591 Td
+(In-app, SMS) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+469.2800000000000296 532.1299999999998818 84. -18.7399999999999984 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+474.2800000000000296 520.6699999999999591 Td
+(Booking > pay) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 513.3899999999998727 96. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 501.92999999999995 Td
+(Wagon allocated /) Tj
+T* (payment window) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+138. 513.3899999999998727 257.2800000000000296 -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+143. 501.92999999999995 Td
+(Scheduling) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+395.2800000000000296 513.3899999999998727 74. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+400.2800000000000296 501.92999999999995 Td
+(In-app) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+469.2800000000000296 513.3899999999998727 84. -27.4799999999999969 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+474.2800000000000296 501.92999999999995 Td
+(Booking) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.78 G
+0. w
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+0.97 0.93 0.93 rg
+42. 471.9099999999999113 511.2799999999999727 -62. re
+f
+0.62 0.17 0.2 rg
+42. 471.9099999999999113 3. -62. re
+f
+BT
+/F1 8.6 Tf
+9.8899999999999988 TL
+0.275 0.345 0.357 rg
+56. 458.9099999999999113 Td
+(DO NOT CHASE A MISSING IN-APP NOTIFICATION BEFORE CHECKING THIS. Recipients are resolved from the company's) Tj
+T* (linked portal users. If a company has none, notify\(\) logs "0 recipients - skipped" and stores nothing - the notification simply never) Tj
+T* (appears, with no error. SMS and email still go out, because they address the company's phone and email directly. On a fresh) Tj
+T* (environment this is the usual explanation.) Tj
+ET
+BT
+/F5 9 Tf
+10.3499999999999996 TL
+0.043 0.333 0.388 rg
+42. 387.9099999999999113 Td
+(11) Tj
+ET
+BT
+/F9 17 Tf
+19.5499999999999972 TL
+0.063 0.102 0.11 rg
+72. 386.9099999999999113 Td
+(Known open issues) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+42. 366.9099999999999113 m
+553.2799999999999727 366.9099999999999113 l
+S
+BT
+/F1 9 Tf
+10.3499999999999996 TL
+0.275 0.345 0.357 rg
+42. 352.9099999999999113 Td
+(Do not raise duplicates for these. Each is already identified.) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+42. 330.9099999999999113 78. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+47. 319.9599999999999227 Td
+(Status) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+120. 330.9099999999999113 190. -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+125. 319.9599999999999227 Td
+(Issue) Tj
+ET
+0.93 0.95 0.95 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.93 0.95 0.95 rg
+310. 330.9099999999999113 243.2799999999999727 -18.0499999999999972 re
+B
+BT
+/F2 7 Tf
+8.0499999999999989 TL
+0.427 0.498 0.51 rg
+315. 319.9599999999999227 Td
+(Impact on testing) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.97 0.93 0.93 rg
+0.8 0.85 0.85 RG
+0.4 w
+0.97 0.93 0.93 rg
+42. 312.8599999999999 78. -36.2199999999999989 re
+B
+BT
+/F2 7.6 Tf
+8.7399999999999984 TL
+0.616 0.169 0.196 rg
+47. 301.3999999999998636 Td
+(OPEN) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+120. 312.8599999999999 190. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+125. 301.3999999999998636 Td
+(Export receive returns 500 on the deployed) Tj
+T* (environment \(POST) Tj
+T* (/warehouse-inventory/receive-bulk\).) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+310. 312.8599999999999 243.2799999999999727 -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+315. 301.3999999999998636 Td
+(Blocks flows E1 and E2 at step .2. Awaiting the response body /) Tj
+T* (server log to diagnose. Likely schema drift, not the SQL.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 276.6399999999998727 78. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 265.1799999999998363 Td
+(FIX PENDING) Tj
+T* (DEPLOY) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+120. 276.6399999999998727 190. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+125. 265.1799999999998363 Td
+(Export receive was extremely slow. The owner SMS) Tj
+T* (was awaited inside the DB transaction, and the SMS) Tj
+T* (client had no HTTP timeout.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+310. 276.6399999999998727 243.2799999999999727 -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+315. 265.1799999999998363 Td
+(Fixed on branch: SMS now has a timeout, and notifications are sent) Tj
+T* (after commit. Re-test receive latency once deployed.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 240.4199999999998454 78. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 228.959999999999809 Td
+(DATA) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+120. 240.4199999999998454 190. -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+125. 228.959999999999809 Td
+(Drivers table has no unique constraints on licence) Tj
+T* (number, email, or phone, despite the entity declaring) Tj
+T* (them unique.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+310. 240.4199999999998454 243.2799999999999727 -36.2199999999999989 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+315. 228.959999999999809 Td
+(Duplicate drivers can be created. Do not rely on uniqueness in test) Tj
+T* (assertions.) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+42. 204.1999999999998181 78. -53.6999999999999886 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.063 0.102 0.11 rg
+47. 192.7399999999997817 Td
+(BEHAVIOUR) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+120. 204.1999999999998181 190. -53.6999999999999886 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+125. 192.7399999999997817 Td
+(Handover generated before truck arrival. If an) Tj
+T* (operator triggers a signature request from the Exit) Tj
+T* (Paper button while a truck is assigned but not arrived,) Tj
+T* (Approve delivery refuses with "truck arrival must be) Tj
+T* (recorded".) Tj
+ET
+1. g
+0.8 0.85 0.85 RG
+0.4 w
+1. g
+310. 204.1999999999998181 243.2799999999999727 -53.6999999999999886 re
+B
+BT
+/F1 7.6 Tf
+8.7399999999999984 TL
+0.275 0.345 0.357 rg
+315. 192.7399999999997817 Td
+(Only reachable off the normal path. Follow flow I1 in order and it will) Tj
+T* (not occur.) Tj
+ET
+0.06 0.1 0.11 RG
+0.9 w
+0.78 G
+0. w
+0.06 0.1 0.11 RG
+0.9 w
+0.06 0.1 0.11 RG
+0.9 w
+0.8 0.85 0.85 RG
+0.5 w
+42. 36. m
+553.2799999999999727 36. l
+S
+BT
+/F9 8 Tf
+9.1999999999999993 TL
+0.427 0.498 0.51 rg
+42. 22. Td
+(EDR Freight - QA Test Plan) Tj
+ET
+BT
+/F5 7.5 Tf
+8.625 TL
+0.427 0.498 0.51 rg
+530.7799999999999727 22. Td
+(7 / 7) Tj
+ET
+endstream
+endobj
+1 0 obj
+<</Type /Pages
+/Kids [3 0 R 5 0 R 7 0 R 9 0 R 11 0 R 13 0 R 15 0 R ]
+/Count 7
+>>
+endobj
+17 0 obj
+<<
+/Type /Font
+/BaseFont /Helvetica
+/Subtype /Type1
+/Encoding /WinAnsiEncoding
+/FirstChar 32
+/LastChar 255
+>>
+endobj
+18 0 obj
+<<
+/Type /Font
+/BaseFont /Helvetica-Bold
+/Subtype /Type1
+/Encoding /WinAnsiEncoding
+/FirstChar 32
+/LastChar 255
+>>
+endobj
+19 0 obj
+<<
+/Type /Font
+/BaseFont /Helvetica-Oblique
+/Subtype /Type1
+/Encoding /WinAnsiEncoding
+/FirstChar 32
+/LastChar 255
+>>
+endobj
+20 0 obj
+<<
+/Type /Font
+/BaseFont /Helvetica-BoldOblique
+/Subtype /Type1
+/Encoding /WinAnsiEncoding
+/FirstChar 32
+/LastChar 255
+>>
+endobj
+21 0 obj
+<<
+/Type /Font
+/BaseFont /Courier
+/Subtype /Type1
+/Encoding /WinAnsiEncoding
+/FirstChar 32
+/LastChar 255
+>>
+endobj
+22 0 obj
+<<
+/Type /Font
+/BaseFont /Courier-Bold
+/Subtype /Type1
+/Encoding /WinAnsiEncoding
+/FirstChar 32
+/LastChar 255
+>>
+endobj
+23 0 obj
+<<
+/Type /Font
+/BaseFont /Courier-Oblique
+/Subtype /Type1
+/Encoding /WinAnsiEncoding
+/FirstChar 32
+/LastChar 255
+>>
+endobj
+24 0 obj
+<<
+/Type /Font
+/BaseFont /Courier-BoldOblique
+/Subtype /Type1
+/Encoding /WinAnsiEncoding
+/FirstChar 32
+/LastChar 255
+>>
+endobj
+25 0 obj
+<<
+/Type /Font
+/BaseFont /Times-Roman
+/Subtype /Type1
+/Encoding /WinAnsiEncoding
+/FirstChar 32
+/LastChar 255
+>>
+endobj
+26 0 obj
+<<
+/Type /Font
+/BaseFont /Times-Bold
+/Subtype /Type1
+/Encoding /WinAnsiEncoding
+/FirstChar 32
+/LastChar 255
+>>
+endobj
+27 0 obj
+<<
+/Type /Font
+/BaseFont /Times-Italic
+/Subtype /Type1
+/Encoding /WinAnsiEncoding
+/FirstChar 32
+/LastChar 255
+>>
+endobj
+28 0 obj
+<<
+/Type /Font
+/BaseFont /Times-BoldItalic
+/Subtype /Type1
+/Encoding /WinAnsiEncoding
+/FirstChar 32
+/LastChar 255
+>>
+endobj
+29 0 obj
+<<
+/Type /Font
+/BaseFont /ZapfDingbats
+/Subtype /Type1
+/FirstChar 32
+/LastChar 255
+>>
+endobj
+30 0 obj
+<<
+/Type /Font
+/BaseFont /Symbol
+/Subtype /Type1
+/FirstChar 32
+/LastChar 255
+>>
+endobj
+2 0 obj
+<<
+/ProcSet [/PDF /Text /ImageB /ImageC /ImageI]
+/Font <<
+/F1 17 0 R
+/F2 18 0 R
+/F3 19 0 R
+/F4 20 0 R
+/F5 21 0 R
+/F6 22 0 R
+/F7 23 0 R
+/F8 24 0 R
+/F9 25 0 R
+/F10 26 0 R
+/F11 27 0 R
+/F12 28 0 R
+/F13 29 0 R
+/F14 30 0 R
+>>
+/XObject <<
+>>
+>>
+endobj
+31 0 obj
+<<
+/Producer (jsPDF 4.2.1)
+/CreationDate (D:20260709090321-00'00')
+>>
+endobj
+32 0 obj
+<<
+/Type /Catalog
+/Pages 1 0 R
+/OpenAction [3 0 R /FitH null]
+/PageLayout /OneColumn
+>>
+endobj
+xref
+0 33
+0000000000 65535 f 
+0000115749 00000 n 
+0000117610 00000 n 
+0000000015 00000 n 
+0000000152 00000 n 
+0000010120 00000 n 
+0000010257 00000 n 
+0000026401 00000 n 
+0000026538 00000 n 
+0000045234 00000 n 
+0000045372 00000 n 
+0000065489 00000 n 
+0000065628 00000 n 
+0000079123 00000 n 
+0000079262 00000 n 
+0000100531 00000 n 
+0000100670 00000 n 
+0000115845 00000 n 
+0000115971 00000 n 
+0000116102 00000 n 
+0000116236 00000 n 
+0000116374 00000 n 
+0000116498 00000 n 
+0000116627 00000 n 
+0000116759 00000 n 
+0000116895 00000 n 
+0000117023 00000 n 
+0000117150 00000 n 
+0000117279 00000 n 
+0000117412 00000 n 
+0000117514 00000 n 
+0000117863 00000 n 
+0000117949 00000 n 
+trailer
+<<
+/Size 33
+/Root 32 0 R
+/Info 31 0 R
+/ID [ <3BEB58B86E90D0C327872D7AEEEBDAFB> <3BEB58B86E90D0C327872D7AEEEBDAFB> ]
+>>
+startxref
+118053
+%%EOF
\ No newline at end of file

From cec544fc12c9150dafcd93514b7831cd58a5a805 Mon Sep 17 00:00:00 2001
From: Stephanos A <steph.et@outlook.com>
Date: Thu, 9 Jul 2026 15:28:20 +0300
Subject: [PATCH 13/25] Coach type price change on seat selection updates

---
 .../backoffice/src/app/passengers/page.tsx    |   2 +-
 .../backoffice/src/app/tariff-rates/page.tsx  |   5 +-
 .../backoffice/src/app/tickets/page.tsx       |   9 +-
 .../backoffice/src/lib/api/passengers.ts      |   9 +-
 .../portal/src/app/booking/payment/page.tsx   |   8 +-
 .../portal/src/app/booking/results/page.tsx   |  12 +-
 .../portal/src/app/booking/review/page.tsx    |  25 +-
 .../portal/src/app/booking/seats/page.tsx     |  16 +-
 .../portal/src/app/packages/[id]/page.tsx     | 254 ++++++++++--------
 .../portal/src/lib/booking-store.ts           |   4 +-
 10 files changed, 208 insertions(+), 136 deletions(-)

diff --git a/apps/edr-passenger-web/backoffice/src/app/passengers/page.tsx b/apps/edr-passenger-web/backoffice/src/app/passengers/page.tsx
index cff41ede2..e2c0fefb5 100644
--- a/apps/edr-passenger-web/backoffice/src/app/passengers/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/passengers/page.tsx
@@ -140,7 +140,7 @@ export default function PassengersPage() {
         </div>
       ),
     },
-    { key: 'phone', label: 'Phone', sortable: true, render: (p: any) => p.phone || 'N/A'  },
+    { key: 'phone', label: 'Phone', sortable: true, render: (p: any) => p.phone || p.passenger?.user?.phone || '—' },
     { key: 'nationality', label: 'Nationality', sortable: true, render: (p: any) => p.nationality || 'N/A' },
     { key: 'gender', label: 'Gender', sortable: true, render: (p: any) => p.gender || 'N/A' },
     { key: 'dateOfBirth', label: 'Date of Birth', sortable: true, render: (p: any) => p.dateOfBirth ? formatDate(p.dateOfBirth) : 'N/A' },
diff --git a/apps/edr-passenger-web/backoffice/src/app/tariff-rates/page.tsx b/apps/edr-passenger-web/backoffice/src/app/tariff-rates/page.tsx
index 33f39d87e..ad10052fd 100644
--- a/apps/edr-passenger-web/backoffice/src/app/tariff-rates/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/tariff-rates/page.tsx
@@ -166,7 +166,10 @@ export default function TariffRatesPage() {
     },
     {
       key: 'coachType', label: 'Coach Type',
-      render: (c: any) => <span className="text-sm">{c.coachType?.name || c.coachTypeId}</span>,
+      render: (c: any) => {
+        const ct = coachTypesArray.find((t: any) => t.id === c.coachTypeId);
+        return <span className="text-sm">{ct ? `${ct.code} — ${ct.name}` : c.coachTypeId}</span>;
+      },
     },
     {
       key: 'bedPosition', label: 'Bed Position',
diff --git a/apps/edr-passenger-web/backoffice/src/app/tickets/page.tsx b/apps/edr-passenger-web/backoffice/src/app/tickets/page.tsx
index e0c7122e3..c737da4de 100644
--- a/apps/edr-passenger-web/backoffice/src/app/tickets/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/tickets/page.tsx
@@ -343,15 +343,12 @@ export default function TicketsPage() {
       key: 'contact',
       label: 'Contact',
       render: (ticket: any) => {
-        const phone = ticket.booking?.passenger?.phone || 'N/A';
-        const email = ticket.booking?.passenger?.email || 'N/A';
-        
+        const phone = ticket.booking?.contactPhone || ticket.booking?.passenger?.phone || '—';
+        const email = ticket.booking?.contactEmail || ticket.booking?.passenger?.email || '—';
         return (
           <div>
             <div className="font-medium">{phone}</div>
-            <div className="text-sm text-muted-foreground">
-              <div className="text-xs text-muted-foreground truncate" title={email}>{email}</div>
-            </div>
+            <div className="text-xs text-muted-foreground truncate" title={email}>{email}</div>
           </div>
         );
       },
diff --git a/apps/edr-passenger-web/backoffice/src/lib/api/passengers.ts b/apps/edr-passenger-web/backoffice/src/lib/api/passengers.ts
index f7191e83b..f94e3d05f 100644
--- a/apps/edr-passenger-web/backoffice/src/lib/api/passengers.ts
+++ b/apps/edr-passenger-web/backoffice/src/lib/api/passengers.ts
@@ -10,7 +10,10 @@ export const passengersApi = {
     if (filters?.role) params.append('role', filters.role);
     if (filters?.page) params.append('page', filters.page.toString());
     if (filters?.pageSize) params.append('pageSize', filters.pageSize.toString());
-    
+    if ((filters as any)?.gender) params.append('gender', (filters as any).gender);
+    if ((filters as any)?.nationality) params.append('nationality', (filters as any).nationality);
+    if ((filters as any)?.dateFrom) params.append('dateFrom', (filters as any).dateFrom);
+    if ((filters as any)?.dateTo) params.append('dateTo', (filters as any).dateTo);
     return apiClient.get<PaginatedResponse<Passenger.IPassenger>>(`/passengers?${params.toString()}`);
   },
 
@@ -21,4 +24,8 @@ export const passengersApi = {
   update: (id: string, data: Partial<Passenger.IPassenger>) => {
     return apiClient.patch<Passenger.IPassenger>(`/passengers/${id}`, data);
   },
+
+  delete: (id: string, cascade = false) => {
+    return apiClient.delete(`/passengers/${id}${cascade ? '?cascade=true' : ''}`);
+  },
 };
diff --git a/apps/edr-passenger-web/portal/src/app/booking/payment/page.tsx b/apps/edr-passenger-web/portal/src/app/booking/payment/page.tsx
index ceb54acd9..3e9cecbc7 100644
--- a/apps/edr-passenger-web/portal/src/app/booking/payment/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/booking/payment/page.tsx
@@ -72,10 +72,10 @@ export default function PaymentPage() {
   // split equally across both legs. This guarantees leg totals are consistent with the
   // per-passenger breakdown rows and the overall reviewed total.
   const outboundBaseFare = isRoundTrip
-    ? (reviewedPassengerFares ?? []).reduce((sum, f) => sum + (f.isFree ? 0 : Math.round(f.fareMinor / 2)), 0)
+    ? (reviewedPassengerFares ?? []).reduce((sum, f) => sum + (f.isFree ? 0 : (f.outboundFareMinor ?? Math.round(f.fareMinor / 2))), 0)
     : 0;
   const inboundBaseFare = isRoundTrip
-    ? (reviewedPassengerFares ?? []).reduce((sum, f) => sum + (f.isFree ? 0 : Math.round(f.fareMinor / 2)), 0)
+    ? (reviewedPassengerFares ?? []).reduce((sum, f) => sum + (f.isFree ? 0 : (f.inboundFareMinor ?? Math.round(f.fareMinor / 2))), 0)
     : 0;
 
   // reviewedPassengerFares / reviewedTotalMinor are the single source of truth for display
@@ -307,11 +307,11 @@ export default function PaymentPage() {
                 <div className="pl-3 space-y-0.5 text-xs text-gray-500 dark:text-gray-400">
                   <div className="flex justify-between">
                     <span>Outbound</span>
-                    <span>{formatFare(Math.round((reviewed?.fareMinor ?? 0) / 2), displayCurrency)}</span>
+                    <span>{formatFare(reviewed?.outboundFareMinor ?? Math.round((reviewed?.fareMinor ?? 0) / 2), displayCurrency)}</span>
                   </div>
                   <div className="flex justify-between">
                     <span>Return</span>
-                    <span>{formatFare(Math.round((reviewed?.fareMinor ?? 0) / 2), displayCurrency)}</span>
+                    <span>{formatFare(reviewed?.inboundFareMinor ?? Math.round((reviewed?.fareMinor ?? 0) / 2), displayCurrency)}</span>
                   </div>
                 </div>
               )}
diff --git a/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx b/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx
index 33609ba0e..fa52aad32 100644
--- a/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx
@@ -293,7 +293,17 @@ export default function ResultsPage() {
 
     // For round trip inbound, proceed with both schedules
     if (isRoundTrip && !isOutbound) {
-      setInboundSchedule(scheduleData);
+      // Mirror the outbound's coachTypes (fares) onto the inbound schedule so the
+      // return seat selection page shows the same prices as the outbound leg.
+      const inboundScheduleData = outboundScheduleData
+        ? {
+            ...scheduleData,
+            baseFareAdult: outboundScheduleData.baseFareAdult,
+            baseFareChild: outboundScheduleData.baseFareChild,
+            coachTypes: outboundScheduleData.coachTypes,
+          }
+        : scheduleData;
+      setInboundSchedule(inboundScheduleData);
       setSelectedSchedule(outboundScheduleData); // Set primary as outbound
     } else {
       // For one-way
diff --git a/apps/edr-passenger-web/portal/src/app/booking/review/page.tsx b/apps/edr-passenger-web/portal/src/app/booking/review/page.tsx
index cf14cc87c..57b098dc1 100644
--- a/apps/edr-passenger-web/portal/src/app/booking/review/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/booking/review/page.tsx
@@ -445,7 +445,9 @@ export default function ReviewPage() {
         const fareMinor = isPackageBooking
           ? (isFreeChild ? 0 : (seatFare ?? pkgFallback))
           : (isFreeChild ? 0 : (seatFare ?? line?.fareMinor ?? 0));
-        return { fareMinor, isFree: isFreeChild };
+        const outboundFareMinor = isRoundTrip ? ((p as any).outboundSeatFareMinor ?? undefined) : undefined;
+        const inboundFareMinor = isRoundTrip ? ((p as any).inboundSeatFareMinor ?? undefined) : undefined;
+        return { fareMinor, isFree: isFreeChild, outboundFareMinor, inboundFareMinor };
       });
       setReviewedTotal(computedTotal, passengerFares);
 
@@ -560,6 +562,14 @@ export default function ReviewPage() {
         const isFreeChild = isPackageBooking
           ? isPkgFreeChild(i)
           : (line?.isFree ?? (isChild(p) && isFirstChild(passengers, i)));
+
+        // Per-leg fares for round trips
+        const outboundFare: number | null = isRoundTrip
+          ? (isPackageBooking ? (packageTierPriceMinor ?? null) : ((p as any).outboundSeatFareMinor ?? null))
+          : null;
+        const inboundFare: number | null = isRoundTrip
+          ? (isPackageBooking ? (packageTierPriceMinor ?? null) : ((p as any).inboundSeatFareMinor ?? null))
+          : null;
         const seatFare = getPassengerSeatFare(p);
         const passengerTotal = isPackageBooking
           ? (isFreeChild ? 0 : (seatFare ?? (isChildPassenger ? pkgChildFare : pkgAdultFare)))
@@ -582,6 +592,19 @@ export default function ReviewPage() {
                 {formatFare(passengerTotal, displayCurrency)}
               </span>
             </div>
+            {/* Round-trip: show outbound + inbound breakdown */}
+            {isRoundTrip && !isFreeChild && (
+              <div className="mt-1 space-y-0.5 pl-2">
+                <div className="flex justify-between text-xs text-gray-500 dark:text-gray-400">
+                  <span>↗ Outbound</span>
+                  <span>{outboundFare != null ? formatFare(outboundFare, displayCurrency) : '—'}</span>
+                </div>
+                <div className="flex justify-between text-xs text-gray-500 dark:text-gray-400">
+                  <span>↙ Return</span>
+                  <span>{inboundFare != null ? formatFare(inboundFare, displayCurrency) : '—'}</span>
+                </div>
+              </div>
+            )}
           </div>
         );
       })}
diff --git a/apps/edr-passenger-web/portal/src/app/booking/seats/page.tsx b/apps/edr-passenger-web/portal/src/app/booking/seats/page.tsx
index f8fd23609..ccb953267 100644
--- a/apps/edr-passenger-web/portal/src/app/booking/seats/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/booking/seats/page.tsx
@@ -451,16 +451,15 @@ export default function SeatsPage() {
   // the new seat map data has finished loading.
   const applyCoachTypeSwitch = (coach: any, matchedType: any) => {
     const newFare = getCoachTypeFare(matchedType.coachTypeId || matchedType.coachId);
-    const firstClass = matchedType.classes?.[0];
     const newCoachTypeId = matchedType.coachTypeId || matchedType.coachId;
     const updatedSchedule = {
       ...(currentSchedule as any),
       selectedCoachTypeId: newCoachTypeId,
       selectedCoachTypeCode: matchedType.coachTypeCode || coach.type || "",
       selectedCoachTypeName: matchedType.coachTypeName || coach.coachTypeName || coach.typeName || "",
-      selectedSeatClass: firstClass?.name || matchedType.coachTypeName || coach.coachTypeName || "",
-      selectedSeatClassName: firstClass?.name || matchedType.coachTypeName || coach.coachTypeName || "",
-      seatClassName: firstClass?.name || matchedType.coachTypeName || coach.coachTypeName || "",
+      selectedSeatClass: matchedType.coachTypeName || coach.coachTypeName || "",
+      selectedSeatClassName: matchedType.coachTypeName || coach.coachTypeName || "",
+      seatClassName: matchedType.coachTypeName || coach.coachTypeName || "",
       baseFareAdult: newFare ?? (currentSchedule as any)?.baseFareAdult,
       baseFareChild: newFare ?? (currentSchedule as any)?.baseFareChild,
     };
@@ -921,7 +920,7 @@ export default function SeatsPage() {
           const positionLabel = newSeat?.bedPosition
             ? `${newSeat.bedPosition.charAt(0).toUpperCase()}${newSeat.bedPosition.slice(1)} berth`
             : "This seat";
-          const legMultiplier = isRoundTrip ? 2 : 1;
+          const legMultiplier = isPackageBooking && isRoundTrip ? 2 : 1;
 
           setModalState({
             isOpen: true,
@@ -1328,15 +1327,16 @@ export default function SeatsPage() {
   useEffect(() => {
     if (isRoundTrip) {
       if (!outboundSchedule || !inboundSchedule || !passengers.length) {
-        router.push("/booking/search");
+        router.push(isPackageBooking ? "/booking/passengers" : "/booking/search");
       }
     } else {
       if (!selectedSchedule || !passengers.length) {
-        router.push("/booking/search");
+        router.push(isPackageBooking ? "/booking/passengers" : "/booking/search");
       }
     }
   }, [
     isRoundTrip,
+    isPackageBooking,
     selectedSchedule,
     outboundSchedule,
     inboundSchedule,
@@ -1712,7 +1712,7 @@ export default function SeatsPage() {
 
   if (
     isRoundTrip
-      ? !outboundSchedule || !inboundSchedule || !passengers.length
+      ? !outboundSchedule || (!isPackageBooking && !inboundSchedule) || !passengers.length
       : !selectedSchedule || !passengers.length
   )
     return null;
diff --git a/apps/edr-passenger-web/portal/src/app/packages/[id]/page.tsx b/apps/edr-passenger-web/portal/src/app/packages/[id]/page.tsx
index 32e3f1178..bb839906d 100644
--- a/apps/edr-passenger-web/portal/src/app/packages/[id]/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/packages/[id]/page.tsx
@@ -221,7 +221,7 @@ function groupTiersByCoachType(tiers: PriceTier[]): Array<{
     if (!map.has(key)) {
       map.set(key, {
         coachTypeId: ct?.id ?? key,
-        coachTypeName: ct?.name ?? tier.seatType,
+        coachTypeName: ct?.name ?? tier.label ?? tier.seatType,
         coachTypeCode: ct?.code ?? '',
         coachTypeType: ct?.type ?? 'passenger',
         tiers: [],
@@ -270,90 +270,121 @@ function PriceTiersPanel({
   }
 
   return (
-    <div className="bg-white dark:bg-gray-900 rounded-2xl p-5 border border-gray-100 dark:border-gray-800 space-y-3">
-      <h2 className="text-base font-bold text-gray-900 dark:text-white">Select Coach Type</h2>
-      {groups.map((group) => {
-        const CoachIcon = getCoachIcon(group.coachTypeType);
-        const allSoldOut = group.tiers.every((t) => t.availableSeats === 0);
-        const isSelected = selectedId === group.coachTypeId;
-        return (
-          <div
-            key={group.coachTypeId}
-            className={`rounded-xl border-2 overflow-hidden transition-colors ${
-              allSoldOut
-                ? 'border-gray-200 dark:border-gray-700 opacity-50'
-                : isSelected
-                  ? 'border-primary'
-                  : 'border-gray-200 dark:border-gray-700 cursor-pointer hover:border-primary/50'
-            }`}
-            onClick={() => !allSoldOut && setSelectedId(isSelected ? null : group.coachTypeId)}
-          >
-            {/* Coach type header */}
-            <div className="flex items-center gap-3 px-4 py-3 bg-gray-50 dark:bg-gray-800/60">
-              <div className={`w-9 h-9 rounded-lg flex items-center justify-center flex-shrink-0 ${
-                isSelected ? 'bg-primary' : 'bg-primary/10'
-              }`}>
-                <CoachIcon className={`w-5 h-5 ${isSelected ? 'text-white' : 'text-primary'}`} />
-              </div>
-              <div className="flex-1 min-w-0">
-                <p className="text-sm font-bold text-gray-900 dark:text-white">
-                  {formatCoachTypeLabel(group.coachTypeType)}
-                </p>
-                <p className="text-xs text-gray-500 dark:text-gray-400">
-                  From {formatPrice(group.minPrice * priceMultiplier, group.currency)}
-                  {allSoldOut && <span className="ml-2 text-red-500 font-semibold">· Sold out</span>}
-                </p>
-              </div>
+    <div className="bg-white dark:bg-gray-900 rounded-2xl p-5 border border-gray-100 dark:border-gray-800">
+      <h2 className="text-base font-bold text-gray-900 dark:text-white mb-4">Choose Coach Type</h2>
+      <div className="grid grid-cols-1 gap-4">
+        {groups.map((group, index) => {
+          const CoachIcon = getCoachIcon(group.coachTypeType);
+          const allSoldOut = group.tiers.every((t) => t.availableSeats === 0);
+          const isSelected = selectedId === group.coachTypeId;
+          return (
+            <div
+              key={group.coachTypeId}
+              role="button"
+              tabIndex={allSoldOut ? -1 : 0}
+              onClick={() => !allSoldOut && setSelectedId(isSelected ? null : group.coachTypeId)}
+              onKeyDown={(e) => {
+                if (!allSoldOut && (e.key === 'Enter' || e.key === ' ')) {
+                  e.preventDefault();
+                  setSelectedId(isSelected ? null : group.coachTypeId);
+                }
+              }}
+              className={`group relative w-full p-2 rounded-2xl border-2 text-left transition-all duration-200 ${allSoldOut
+                  ? 'border-gray-200 dark:border-gray-700 opacity-50 cursor-not-allowed'
+                  : isSelected
+                    ? 'border-primary bg-gradient-to-br from-primary/8 to-primary/3 dark:from-primary/15 dark:to-primary/5 shadow-lg shadow-primary/20 scale-[1.02] cursor-pointer'
+                    : 'border-gray-200 dark:border-gray-700 shadow-sm hover:border-primary/40 hover:shadow-md hover:scale-[1.01] bg-white dark:bg-gray-800/50 cursor-pointer'
+                }`}
+              style={{ animation: `fade-in-up 0.3s ease-out ${index * 0.08}s both` }}
+            >
+              {/* Radio indicator */}
               {!allSoldOut && (
-                <div className={`w-5 h-5 rounded-full border-2 flex-shrink-0 flex items-center justify-center ${
-                  isSelected ? 'border-primary bg-primary' : 'border-gray-300 dark:border-gray-600'
-                }`}>
-                  {isSelected && <Check className="w-3 h-3 text-white" />}
-                </div>
+                <span className={`absolute top-4 right-4 w-5 h-5 rounded-full border-2 flex items-center justify-center flex-shrink-0 transition-all ${isSelected ? 'border-primary' : 'border-gray-300 dark:border-gray-600 group-hover:border-primary/50'
+                  }`}>
+                  {isSelected && <span className="w-2.5 h-2.5 rounded-full bg-primary" />}
+                </span>
               )}
-            </div>
 
-            {/* All available classes for this coach type */}
-            <div className="px-4 py-3 space-y-2">
-              {group.tiers.map((tier) => {
-                const soldOut = tier.availableSeats === 0;
-                return (
-                  <div
-                    key={tier.id}
-                    className={`flex items-start gap-2 py-1.5 ${soldOut ? 'opacity-50' : ''}`}
-                  >
-                    <div className="w-1.5 h-1.5 rounded-full bg-primary flex-shrink-0 mt-1.5" />
-                    <div>
-                      <p className="text-sm text-gray-700 dark:text-gray-300">{tier.seatType.trim()}</p>
-                      <p className="text-xs">
-                        <span className="font-bold text-primary">{formatPrice(tier.priceMinor * priceMultiplier, tier.currency)}</span>
-                        {soldOut ? (
-                          <span className="ml-2 font-bold text-red-500">Sold out</span>
-                        ) : (
-                          <span className="ml-2 text-gray-400">{tier.availableSeats} left</span>
-                        )}
-                      </p>
+              <div className="flex flex-col">
+                <div className="flex items-start gap-2 pr-2">
+                  <div className={`w-10 h-10 rounded-xl flex items-center justify-center flex-shrink-0 transition-all ${isSelected
+                      ? 'bg-primary/15 dark:bg-primary/25 shadow-inner'
+                      : 'bg-gray-100 dark:bg-gray-700 group-hover:bg-primary/10'
+                    }`}>
+                    <CoachIcon className={`w-4 h-4 transition-colors ${isSelected ? 'text-primary' : 'text-gray-600 dark:text-gray-400 group-hover:text-primary'
+                      }`} />
+                  </div>
+
+                  <div className="flex-1 min-w-0">
+                    <p className="text-sm font-bold text-gray-700 dark:text-gray-300 tracking-wider">
+                      {formatCoachTypeLabel(group.coachTypeType)}
+                    </p>
+                    {allSoldOut && (
+                      <span className="text-xs font-bold text-red-500 mt-0.5 block">Sold out</span>
+                    )}
+                    <div className="mt-1 flex items-baseline gap-1">
+                      <span className="text-xs text-gray-500 dark:text-gray-400 font-medium">From</span>
+                      <span className={`text-sm font-bold tracking-tight ${isSelected ? 'text-primary' : 'text-gray-900 dark:text-white'
+                        }`}>
+                        {((group.minPrice * priceMultiplier) / 100).toFixed(2)}
+                      </span>
+                      <span className="text-sm font-semibold text-gray-600 dark:text-gray-400">{group.currency}</span>
                     </div>
                   </div>
-                );
-              })}
-            </div>
+                </div>
 
-            {/* Book Now — only when this group is selected */}
-            {isSelected && !allSoldOut && (
-              <div className="px-4 pb-4">
-                <button
-                  type="button"
-                  onClick={(e) => { e.stopPropagation(); onBookNow(group.coachTypeId); }}
-                  className="w-full py-2.5 bg-[rgb(20,113,76)] hover:bg-[rgb(16,89,60)] text-white font-bold text-sm rounded-xl transition-all shadow-md flex items-center justify-center gap-2"
-                >
-                  Book Now <ArrowRight className="w-4 h-4" />
-                </button>
+                {/* Class options — always visible, matching results page style */}
+                {group.tiers.length > 0 && (
+                  <div className="mt-2 pt-2 border-t border-gray-200/60 dark:border-gray-700/60">
+                    <div className="space-y-1.5">
+                      {group.tiers.map((tier) => {
+                        const soldOut = tier.availableSeats === 0;
+                        return (
+                          <div
+                            key={tier.id}
+                            className={`flex flex-col py-1 px-1 rounded-lg bg-gray-50/80 dark:bg-gray-800/40 ${soldOut ? 'opacity-50' : ''}`}
+                          >
+                            <span className="text-sm font-medium text-gray-700 dark:text-gray-300">{tier.seatType.trim()}</span>
+                            {soldOut ? (
+                              <span className="text-xs font-bold text-red-500 mt-0.5">Sold out</span>
+                            ) : (
+                              <div className="flex items-baseline gap-1 mt-0.5">
+                                <span className="text-sm font-bold tabular-nums text-primary">
+                                  {((tier.priceMinor * priceMultiplier) / 100).toFixed(2)}
+                                </span>
+                                <span className="text-xs text-gray-500 dark:text-gray-400 font-medium">{tier.currency}</span>
+                              </div>
+                            )}
+                          </div>
+                        );
+                      })}
+                    </div>
+                  </div>
+                )}
+
+                {!isSelected && !allSoldOut && (
+                  <p className="mt-4 pt-3 border-t border-gray-200/60 dark:border-gray-700/60 text-xs text-gray-400 dark:text-gray-500 italic text-center">
+                    Click to select this coach
+                  </p>
+                )}
+
+                {isSelected && !allSoldOut && (
+                  <button
+                    type="button"
+                    onClick={(e) => { e.stopPropagation(); onBookNow(group.coachTypeId); }}
+                    className="mt-3 w-full flex items-center justify-center gap-2 px-4 py-2.5 bg-gradient-to-r from-[rgb(20,113,76)] to-[rgb(16,95,65)] hover:from-[rgb(16,89,60)] hover:to-[rgb(12,75,50)] text-white font-bold text-sm rounded-xl transition-all shadow-md shadow-primary/30 hover:shadow-lg active:scale-[0.98]"
+                  >
+                    Book Now <ArrowRight className="w-4 h-4" />
+                  </button>
+                )}
               </div>
-            )}
-          </div>
-        );
-      })}
+            </div>
+          );
+        })}
+      </div>
+      <style>{`
+        @keyframes fade-in-up{from{opacity:0;transform:translateY(10px)}to{opacity:1;transform:translateY(0)}}
+      `}</style>
     </div>
   );
 }
@@ -407,7 +438,7 @@ function PassengerCountModal({
 
           <div className="px-6 py-3 bg-primary/5 border-b border-primary/10">
             <p className="text-xs text-gray-400 uppercase tracking-wide font-semibold">Coach type</p>
-            <p className="text-sm font-bold text-gray-900 dark:text-white mt-0.5">{tier.seatClass?.coachType?.type ? formatCoachTypeLabel(tier.seatClass.coachType.type) : tier.label.trim()}</p>
+            <p className="text-sm font-bold text-gray-900 dark:text-white mt-0.5">{tier.seatClass?.coachType?.name ?? tier.label.trim()}</p>
             <p className="text-xs text-gray-400 mt-0.5">{remaining} seats remaining · from {formatPrice(minPriceMinor * priceMultiplier, tier.currency)} per adult · 1st child per adult free (no seat)</p>
           </div>
 
@@ -416,26 +447,26 @@ function PassengerCountModal({
               { label: "Adults", sub: `Age 5+ · max ${PKG_MAX_ADULTS}`, value: adultCount, min: 1, max: Math.min(PKG_MAX_ADULTS, remaining), set: (v: number) => { setAdultCount(v); const newMax = Math.min(v * PKG_CHILDREN_PER_ADULT, v + Math.max(0, remaining - v)); setChildCount(c => Math.min(c, newMax)); } },
               { label: "Children", sub: `Under 5 · max ${PKG_CHILDREN_PER_ADULT} per adult · 1st per adult FREE (no seat)`, value: childCount, min: 0, max: Math.min(adultCount * PKG_CHILDREN_PER_ADULT, adultCount + Math.max(0, remaining - adultCount)), set: setChildCount },
             ].map(({ label, sub, value, min, max, set }) => (
-                <div key={label} className="flex items-center justify-between">
-                  <div>
-                    <p className="text-sm font-semibold text-gray-900 dark:text-white">{label}</p>
-                    <p className="text-xs text-gray-400">{sub}</p>
-                  </div>
-                  <div className="flex items-center gap-3">
-                    <button type="button" onClick={() => set(Math.max(min, value - 1))}
-                      disabled={value <= min}
-                      className="w-8 h-8 rounded-full border-2 border-gray-200 dark:border-gray-700 flex items-center justify-center text-lg font-bold text-gray-600 dark:text-gray-300 disabled:opacity-30 hover:border-primary hover:text-primary transition-colors">
-                      −
-                    </button>
-                    <span className="w-6 text-center text-base font-bold text-gray-900 dark:text-white">{value}</span>
-                    <button type="button" onClick={() => set(value + 1)}
-                      disabled={value >= max}
-                      className="w-8 h-8 rounded-full border-2 border-gray-200 dark:border-gray-700 flex items-center justify-center text-lg font-bold text-gray-600 dark:text-gray-300 disabled:opacity-30 hover:border-primary hover:text-primary transition-colors">
-                      +
-                    </button>
-                  </div>
+              <div key={label} className="flex items-center justify-between">
+                <div>
+                  <p className="text-sm font-semibold text-gray-900 dark:text-white">{label}</p>
+                  <p className="text-xs text-gray-400">{sub}</p>
                 </div>
-              ))}
+                <div className="flex items-center gap-3">
+                  <button type="button" onClick={() => set(Math.max(min, value - 1))}
+                    disabled={value <= min}
+                    className="w-8 h-8 rounded-full border-2 border-gray-200 dark:border-gray-700 flex items-center justify-center text-lg font-bold text-gray-600 dark:text-gray-300 disabled:opacity-30 hover:border-primary hover:text-primary transition-colors">
+                    −
+                  </button>
+                  <span className="w-6 text-center text-base font-bold text-gray-900 dark:text-white">{value}</span>
+                  <button type="button" onClick={() => set(value + 1)}
+                    disabled={value >= max}
+                    className="w-8 h-8 rounded-full border-2 border-gray-200 dark:border-gray-700 flex items-center justify-center text-lg font-bold text-gray-600 dark:text-gray-300 disabled:opacity-30 hover:border-primary hover:text-primary transition-colors">
+                    +
+                  </button>
+                </div>
+              </div>
+            ))}
 
             {freeChildren > 0 && (
               <div className="flex items-center justify-between text-xs text-green-600 dark:text-green-400">
@@ -457,15 +488,14 @@ function PassengerCountModal({
 
             {/* Departure Station */}
             <div>
-              <label className="flex items-center gap-1.5 text-sm font-semibold text-gray-700 dark:text-gray-300 mb-1.5 border-t pt-3">                
+              <label className="flex items-center gap-1.5 text-sm font-semibold text-gray-700 dark:text-gray-300 mb-1.5 border-t pt-3">
                 Departure Station
               </label>
               <select
                 value={departureStationId}
                 onChange={(e) => { setDepartureStationId(e.target.value); setShowStationError(false); }}
-                className={`w-full rounded-xl border bg-white dark:bg-gray-800 text-sm text-gray-900 dark:text-white px-3 py-2.5 focus:outline-none focus:ring-2 focus:ring-primary/40 ${
-                  showStationError && !departureStationId ? 'border-red-400 dark:border-red-500' : 'border-gray-200 dark:border-gray-700'
-                }`}
+                className={`w-full rounded-xl border bg-white dark:bg-gray-800 text-sm text-gray-900 dark:text-white px-3 py-2.5 focus:outline-none focus:ring-2 focus:ring-primary/40 ${showStationError && !departureStationId ? 'border-red-400 dark:border-red-500' : 'border-gray-200 dark:border-gray-700'
+                  }`}
               >
                 <option value="">Select your boarding station</option>
                 {stations.map((s) => (
@@ -480,10 +510,10 @@ function PassengerCountModal({
             )}
 
             <button type="button" onClick={() => {
-                if (!departureStationId) { setShowStationError(true); return; }
-                const station = stations.find(s => s.id === departureStationId);
-                onConfirm(adultCount, childCount, departureStationId, station?.name ?? '');
-              }}
+              if (!departureStationId) { setShowStationError(true); return; }
+              const station = stations.find(s => s.id === departureStationId);
+              onConfirm(adultCount, childCount, departureStationId, station?.name ?? '');
+            }}
               disabled={loading || adultCount + childCount < 1}
               className="w-full py-3.5 bg-[rgb(20,113,76)] hover:bg-[rgb(16,89,60)] disabled:opacity-60 text-white font-bold text-sm rounded-xl transition-all shadow-lg flex items-center justify-center gap-2">
               {loading ? <><Loader2 className="w-4 h-4 animate-spin" /> Loading...</> : <>Continue <ArrowRight className="w-4 h-4" /></>}
@@ -523,8 +553,10 @@ export default function PackageDetailPage() {
   // For the passenger modal, use the cheapest available tier in the selected coach type group
   const groups = pkg ? groupTiersByCoachType(pkg.priceTiers) : [];
   const selectedGroup = groups.find((g) => g.coachTypeId === selectedCoachTypeId);
-  // Representative tier for the modal header (cheapest available)
-  const representativeTier = selectedGroup?.tiers.find((t) => t.availableSeats > 0) ?? selectedGroup?.tiers[0] ?? null;
+  // Representative tier for the modal: cheapest available in the selected group
+  const representativeTier = selectedGroup?.tiers
+    .filter((t) => t.availableSeats > 0)
+    .sort((a, b) => a.priceMinor - b.priceMinor)[0] ?? selectedGroup?.tiers[0] ?? null;
 
   const isRoundTripPkg = pkg?.journeyType === 'ROUND_TRIP';
 
@@ -745,9 +777,9 @@ export default function PackageDetailPage() {
                 <p className="text-xs font-bold text-gray-800 dark:text-white mt-0.5">
                   {pkg.priceTiers.length
                     ? formatPrice(
-                        Math.min(...pkg.priceTiers.map((t) => t.priceMinor)) * (isRoundTripPkg ? 2 : 1),
-                        pkg.priceTiers[0].currency,
-                      )
+                      Math.min(...pkg.priceTiers.map((t) => t.priceMinor)) * (isRoundTripPkg ? 2 : 1),
+                      pkg.priceTiers[0].currency,
+                    )
                     : "—"}
                 </p>
               </div>
diff --git a/apps/edr-passenger-web/portal/src/lib/booking-store.ts b/apps/edr-passenger-web/portal/src/lib/booking-store.ts
index e5d1d83aa..ce578b7a9 100644
--- a/apps/edr-passenger-web/portal/src/lib/booking-store.ts
+++ b/apps/edr-passenger-web/portal/src/lib/booking-store.ts
@@ -128,7 +128,7 @@ interface BookingState {
   reviewedTotalMinor: number | null;
   // Per-passenger fare breakdown computed on the review page — guarantees line items
   // on the payment page sum to exactly reviewedTotalMinor.
-  reviewedPassengerFares: Array<{ fareMinor: number; isFree: boolean }> | null;
+  reviewedPassengerFares: Array<{ fareMinor: number; isFree: boolean; outboundFareMinor?: number; inboundFareMinor?: number }> | null;
 
   setSearchCriteria: (criteria: SearchCriteria) => void;
   setSelectedSchedule: (schedule: SelectedSchedule) => void;
@@ -143,7 +143,7 @@ interface BookingState {
   setCreateAccount: (create: boolean) => void;
   setPassengerId: (id: string | null) => void;
   setPackageContext: (packageId: string, priceTierId: string, priceMinor: number, packageName?: string, departureStationId?: string, departureStationName?: string) => void;
-  setReviewedTotal: (totalMinor: number, passengerFares: Array<{ fareMinor: number; isFree: boolean }>) => void;
+  setReviewedTotal: (totalMinor: number, passengerFares: Array<{ fareMinor: number; isFree: boolean; outboundFareMinor?: number; inboundFareMinor?: number }>) => void;
   clearBooking: () => void;
 }
 

From a5bc9d843594ed10b9b838e4465f144a1edfddee Mon Sep 17 00:00:00 2001
From: Nathnael <nathnael@example.com>
Date: Thu, 9 Jul 2026 11:27:33 +0000
Subject: [PATCH 14/25] fix: the company rejection on the approved ones

---
 .../company-change-request.repository.spec.ts | 88 +++++++++++++++++++
 .../company-change-request.repository.ts      | 13 ++-
 2 files changed, 97 insertions(+), 4 deletions(-)
 create mode 100644 apps/edr-freight-api/src/modules/companies/company-change-request.repository.spec.ts

diff --git a/apps/edr-freight-api/src/modules/companies/company-change-request.repository.spec.ts b/apps/edr-freight-api/src/modules/companies/company-change-request.repository.spec.ts
new file mode 100644
index 000000000..73271e0af
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/companies/company-change-request.repository.spec.ts
@@ -0,0 +1,88 @@
+import { Repository } from "typeorm";
+
+import { CompanyChangeRequestRepository } from "./company-change-request.repository";
+import {
+  ChangeRequestStatus,
+  CompanyChangeRequest,
+} from "./entities/company-change-request.entity";
+
+type Row = Pick<CompanyChangeRequest, "id" | "status"> & { createdAt: Date };
+
+const COMPANY_ID = "company-1";
+
+/**
+ * Stands in for the TypeORM repository over a fixed set of rows, honouring the
+ * `where.status` filter and the `createdAt DESC` ordering findOne relies on.
+ */
+function mockRepositoryOver(rows: Row[]) {
+  return {
+    findOne: jest.fn(
+      ({ where }: { where: Partial<Row> & { companyId: string } }) =>
+        Promise.resolve(
+          rows
+            .filter(
+              (row) =>
+                where.companyId === COMPANY_ID &&
+                (where.status === undefined || row.status === where.status),
+            )
+            .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime())[0] ??
+            null,
+        ),
+    ),
+  } as unknown as Repository<CompanyChangeRequest>;
+}
+
+function subject(rows: Row[]) {
+  return new CompanyChangeRequestRepository(mockRepositoryOver(rows));
+}
+
+describe("CompanyChangeRequestRepository.findLatestOpenByCompanyId", () => {
+  const rejected: Row = {
+    id: "rejected",
+    status: ChangeRequestStatus.Rejected,
+    createdAt: new Date("2026-01-01T00:00:00.000Z"),
+  };
+
+  it("returns the pending request when one is open", async () => {
+    const pending: Row = {
+      id: "pending",
+      status: ChangeRequestStatus.Pending,
+      createdAt: new Date("2026-01-02T00:00:00.000Z"),
+    };
+
+    const result = await subject([rejected, pending]).findLatestOpenByCompanyId(
+      COMPANY_ID,
+    );
+
+    expect(result?.id).toBe("pending");
+  });
+
+  it("returns the latest rejected request when nothing is pending", async () => {
+    const result = await subject([rejected]).findLatestOpenByCompanyId(
+      COMPANY_ID,
+    );
+
+    expect(result?.id).toBe("rejected");
+  });
+
+  it("returns null once a resubmit of a rejected request is approved", async () => {
+    const approved: Row = {
+      id: "approved",
+      status: ChangeRequestStatus.Approved,
+      createdAt: new Date("2026-01-02T00:00:00.000Z"),
+    };
+
+    const result = await subject([
+      rejected,
+      approved,
+    ]).findLatestOpenByCompanyId(COMPANY_ID);
+
+    expect(result).toBeNull();
+  });
+
+  it("returns null when the company has no requests", async () => {
+    const result = await subject([]).findLatestOpenByCompanyId(COMPANY_ID);
+
+    expect(result).toBeNull();
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/companies/company-change-request.repository.ts b/apps/edr-freight-api/src/modules/companies/company-change-request.repository.ts
index 24d988452..eb44d56cb 100644
--- a/apps/edr-freight-api/src/modules/companies/company-change-request.repository.ts
+++ b/apps/edr-freight-api/src/modules/companies/company-change-request.repository.ts
@@ -28,18 +28,23 @@ export class CompanyChangeRequestRepository extends BaseRepository<CompanyChange
 
   /**
    * The company's latest "open" request — pending (locks the customer) or the
-   * most recent rejected one (drives the reapply banner + prefill). Approved
-   * requests are terminal and ignored here.
+   * most recent rejected one (drives the reapply banner + prefill).
+   *
+   * Only the company's newest request may be open. A rejection is superseded the
+   * moment the customer resubmits: that resubmit opens a *new* request, so once
+   * it is approved the newest request is terminal and nothing is open — even
+   * though the older rejected row still sits in the table as history.
    */
   async findLatestOpenByCompanyId(
     companyId: string,
   ): Promise<CompanyChangeRequest | null> {
     const pending = await this.findPendingByCompanyId(companyId);
     if (pending) return pending;
-    return this.repository.findOne({
-      where: { companyId, status: ChangeRequestStatus.Rejected },
+    const latest = await this.repository.findOne({
+      where: { companyId },
       order: { createdAt: "DESC" },
     });
+    return latest?.status === ChangeRequestStatus.Rejected ? latest : null;
   }
 
   async findById(id: string): Promise<CompanyChangeRequest | null> {

From 3f9dca5244dfa07bf838089737cbb208d2143ca6 Mon Sep 17 00:00:00 2001
From: Nathnael <nathnael@example.com>
Date: Thu, 9 Jul 2026 11:27:56 +0000
Subject: [PATCH 15/25] fix: notification mark as read

---
 .../notification-inbox/notification-inbox.controller.ts    | 6 +++++-
 .../modules/notification-inbox/notifications.gateway.ts    | 7 ++++---
 2 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/apps/edr-freight-api/src/modules/notification-inbox/notification-inbox.controller.ts b/apps/edr-freight-api/src/modules/notification-inbox/notification-inbox.controller.ts
index 1d7fd27fc..80fecf1bf 100644
--- a/apps/edr-freight-api/src/modules/notification-inbox/notification-inbox.controller.ts
+++ b/apps/edr-freight-api/src/modules/notification-inbox/notification-inbox.controller.ts
@@ -13,8 +13,10 @@ import {
   Patch,
   Post,
   Query,
+  UseGuards,
 } from "@nestjs/common";
-import { ApiOperation, ApiTags } from "@nestjs/swagger";
+import { ApiBearerAuth, ApiOperation, ApiTags } from "@nestjs/swagger";
+import { JwtGuard } from "@tria-plc/api-common/modules/auth/services/jwt.guard";
 
 import {
   AuthUserPayload,
@@ -24,6 +26,8 @@ import { ListNotificationsQueryDto } from "./dto/list-notifications-query.dto";
 import { NotificationInboxService } from "./notification-inbox.service";
 
 @ApiTags("notifications")
+@ApiBearerAuth()
+@UseGuards(JwtGuard)
 @Controller("notifications")
 export class NotificationInboxController {
   constructor(private readonly service: NotificationInboxService) {}
diff --git a/apps/edr-freight-api/src/modules/notification-inbox/notifications.gateway.ts b/apps/edr-freight-api/src/modules/notification-inbox/notifications.gateway.ts
index c14dcbaa5..0c4704170 100644
--- a/apps/edr-freight-api/src/modules/notification-inbox/notifications.gateway.ts
+++ b/apps/edr-freight-api/src/modules/notification-inbox/notifications.gateway.ts
@@ -15,9 +15,10 @@ import { WsAuthService } from "./ws-auth.service";
 
 /**
  * Server → client push for in-app notifications. Clients only *listen* (no
- * `@SubscribeMessage` handlers), so the global HTTP JwtGuard never applies here;
- * the handshake is authenticated in `handleConnection` and each socket joins a
- * private `user:<id>` room the service targets.
+ * `@SubscribeMessage` handlers), and `@UseGuards(JwtGuard)` on the REST
+ * controller does not cover WebSockets; the handshake is authenticated in
+ * `handleConnection` and each socket joins a private `user:<id>` room the
+ * service targets.
  */
 @WebSocketGateway({
   namespace: NOTIFICATION_WS_NAMESPACE,

From 80ef15b9dc56146d63e725fbc4d60b34e286a84d Mon Sep 17 00:00:00 2001
From: Nathnael <nathnael@example.com>
Date: Thu, 9 Jul 2026 12:36:51 +0000
Subject: [PATCH 16/25] fix: onboarding back and contract blocking

---
 .../onboarding/OnboardingWizardDialog.tsx     |  12 +-
 .../src/pages/accounts/CompanyProfileForm.tsx |  25 +-
 .../src/pages/contracts/ContractsList.tsx     | 389 +++++++++++-------
 3 files changed, 245 insertions(+), 181 deletions(-)

diff --git a/apps/edr-freight-web/portal/src/components/onboarding/OnboardingWizardDialog.tsx b/apps/edr-freight-web/portal/src/components/onboarding/OnboardingWizardDialog.tsx
index ab00965fa..849ba50c5 100644
--- a/apps/edr-freight-web/portal/src/components/onboarding/OnboardingWizardDialog.tsx
+++ b/apps/edr-freight-web/portal/src/components/onboarding/OnboardingWizardDialog.tsx
@@ -286,9 +286,13 @@ export default function OnboardingWizardDialog({
     });
   }, [roles, nationality, startMutation]);
 
-  // Note: no "back to role selection" — once the draft is created the role(s)
-  // are fixed; the form's first-step Back is a no-op so progress never resets.
-  const handleBackToRoles = useCallback(() => { }, []);
+  // Back from the form's first step returns to nationality/role selection.
+  // Safe to re-enter: startOnboarding is idempotent — it reuses the existing
+  // draft, refreshes the nationality and creates only roles that don't exist yet.
+  const handleBackToRoles = useCallback(() => {
+    setStartError(null);
+    setPhase("nationality-role");
+  }, []);
 
   // Save the current step's fields to the draft (PATCH /profile). Returns the
   // server error message on failure so the form can show it (e.g. duplicate TIN).
@@ -359,7 +363,6 @@ export default function OnboardingWizardDialog({
   // The active step across the whole journey, driving the header + progress pill.
   const activeStep: WizardStep = phase === "form" ? formStep : phase;
   const stepMeta = STEP_META[activeStep];
-  console.log({ stepMeta, activeStep, STEP_META });
   const activeIdx = WIZARD_STEPS.indexOf(activeStep);
 
   // Closing from the congratulations panel also clears the completed flag so a
@@ -403,7 +406,6 @@ export default function OnboardingWizardDialog({
     onSubmit: handleSubmit,
     isPending: finishMutation.isPending,
     onBack: handleBackToRoles,
-    hideFirstStepBack: true,
     initialStep: effectiveResumeStep,
     resyncOpen: opened,
     onStepChange: handleStepChange,
diff --git a/apps/edr-freight-web/portal/src/pages/accounts/CompanyProfileForm.tsx b/apps/edr-freight-web/portal/src/pages/accounts/CompanyProfileForm.tsx
index cc9f81a29..abfb61551 100644
--- a/apps/edr-freight-web/portal/src/pages/accounts/CompanyProfileForm.tsx
+++ b/apps/edr-freight-web/portal/src/pages/accounts/CompanyProfileForm.tsx
@@ -51,7 +51,6 @@ export default function CompanyProfileForm({
   onBack,
   initialStep,
   resyncOpen,
-  hideFirstStepBack,
   onStepChange,
   onSaveStep,
   rehydrate,
@@ -73,8 +72,6 @@ export default function CompanyProfileForm({
   initialStep?: CompanyStep;
   /** When this flips true (dialog reopened), jump back to initialStep (furthest reached). */
   resyncOpen?: boolean;
-  /** Hide the Back button on the first step (onboarding can't go back to role pick). */
-  hideFirstStepBack?: boolean;
   /** Reports the active step so the parent can persist resume progress. */
   onStepChange?: (step: CompanyStep) => void;
   /** Persist the current step's data before advancing; returns an error to show. */
@@ -514,10 +511,6 @@ export default function CompanyProfileForm({
     else setStep(stepOrder[currentIdx - 1]);
   };
 
-  // Back is hidden on the first step during onboarding (can't return to role
-  // selection); otherwise always available.
-  const showBack = !(hideFirstStepBack && step === "company");
-
   return (
     <>
       <form onSubmit={(e) => e.preventDefault()}>
@@ -851,17 +844,13 @@ export default function CompanyProfileForm({
           )}
 
           <Group justify="space-between" pt="xs">
-            {showBack ? (
-              <Button
-                variant="default"
-                onClick={prevStep}
-                leftSection={<ArrowLeft size={16} />}
-              >
-                Back
-              </Button>
-            ) : (
-              <span />
-            )}
+            <Button
+              variant="default"
+              onClick={prevStep}
+              leftSection={<ArrowLeft size={16} />}
+            >
+              Back
+            </Button>
             <Button
               color="edr-green"
               onClick={nextStep}
diff --git a/apps/edr-freight-web/portal/src/pages/contracts/ContractsList.tsx b/apps/edr-freight-web/portal/src/pages/contracts/ContractsList.tsx
index d2bd8b88f..b6ba870d6 100644
--- a/apps/edr-freight-web/portal/src/pages/contracts/ContractsList.tsx
+++ b/apps/edr-freight-web/portal/src/pages/contracts/ContractsList.tsx
@@ -9,6 +9,7 @@ import {
   Group,
   Loader,
   Paper,
+  Popover,
   Select,
   Stack,
   Table,
@@ -17,6 +18,7 @@ import {
   Title,
 } from "@mantine/core";
 import {
+  AlertTriangle,
   CheckCircle2,
   ChevronDown,
   ChevronLeft,
@@ -31,6 +33,8 @@ import {
   X,
 } from "lucide-react";
 
+import { PROFILE_TYPE_LABELS } from "@/constants/profileMode";
+import useAuth from "@/hooks/useAuth";
 import { api } from "@/services/api";
 import { ContractCustomerAction } from "@/components/customer-actions/ContractCustomerAction";
 import type { ContractListFilter } from "@/services/contracts.service";
@@ -58,14 +62,26 @@ function primaryRoute(contract: Freight.IContract) {
 
 export default function ContractsList() {
   const navigate = useNavigate();
+  const { company } = useAuth();
   const { pagination, setPagination } = usePagination({ pageSize: 10 });
   const [query, setQuery] = useState("");
+  const [disclaimerOpen, setDisclaimerOpen] = useState(false);
   const [freightFilter, setFreightFilter] = useState<string | null>(null);
   const [kindFilter, setKindFilter] = useState<string | null>(null);
   const [createdFrom, setCreatedFrom] = useState<string>("");
   const [createdTo, setCreatedTo] = useState<string>("");
   const [expanded, setExpanded] = useState<Set<string>>(new Set());
 
+  // A contract can only be created under an approved profile — NewContractPage
+  // blocks every operation whose profile isn't "active". With none approved the
+  // page is reachable but unusable, so warn before sending the user there.
+  const profiles = company?.company?.companyProfiles ?? [];
+  const noActiveProfile =
+    profiles.length > 0 && !profiles.some((p) => p.status === "active");
+
+  const openNewContract = () =>
+    navigate("/contracts/new", { state: { fresh: true } });
+
   const toggleExpanded = (id: string) =>
     setExpanded((prev) => {
       const nextSet = new Set(prev);
@@ -137,9 +153,11 @@ export default function ContractsList() {
   const stats = useMemo(() => {
     const items = data?.items ?? [];
     const active = items.filter((c) =>
-      ["CONTRACT_ACTIVE", "FULLY_EXECUTED", "ACTIVE_SHIPMENT_IN_PROGRESS"].includes(
-        c.status,
-      ),
+      [
+        "CONTRACT_ACTIVE",
+        "FULLY_EXECUTED",
+        "ACTIVE_SHIPMENT_IN_PROGRESS",
+      ].includes(c.status),
     ).length;
     const pending = items.filter((c) =>
       [
@@ -158,7 +176,7 @@ export default function ContractsList() {
     return { active, pending, total };
   }, [data]);
 
-  const total = data?.meta?.total ?? (data?.items?.length ?? 0);
+  const total = data?.meta?.total ?? data?.items?.length ?? 0;
   const pageCount = Math.max(1, Math.ceil(total / pagination.pageSize));
   const pageIndex = pagination.pageIndex;
   const start = total === 0 ? 0 : pageIndex * pagination.pageSize + 1;
@@ -175,19 +193,63 @@ export default function ContractsList() {
       <Stack gap="lg">
         {/* Header */}
         <Group justify="space-between" align="center" wrap="wrap" gap="md">
-          <Title order={1} fw={800} fz={26} style={{ letterSpacing: "-0.01em" }}>
+          <Title
+            order={1}
+            fw={800}
+            fz={26}
+            style={{ letterSpacing: "-0.01em" }}
+          >
             Contracts
           </Title>
-          <Button
-            color="edr-green"
+          <Popover
+            opened={disclaimerOpen}
+            onChange={setDisclaimerOpen}
+            position="bottom-end"
+            width={340}
             radius="md"
-            size="md"
-            leftSection={<Plus size={16} />}
-            onClick={() => navigate("/contracts/new", { state: { fresh: true } })}
-            styles={{ root: { fontWeight: 600, height: 42, paddingInline: 18 } }}
+            shadow="md"
+            withArrow
+            trapFocus
           >
-            New Contract
-          </Button>
+            <Popover.Target>
+              <Button
+                color="edr-green"
+                radius="md"
+                size="md"
+                leftSection={<Plus size={16} />}
+                onClick={() =>
+                  noActiveProfile
+                    ? setDisclaimerOpen((o) => !o)
+                    : openNewContract()
+                }
+                styles={{
+                  root: { fontWeight: 600, height: 42, paddingInline: 18 },
+                }}
+              >
+                New Contract
+              </Button>
+            </Popover.Target>
+            <Popover.Dropdown>
+              <Stack gap="sm">
+                <Group gap={8} wrap="nowrap" align="flex-start">
+                  <AlertTriangle
+                    size={18}
+                    color="var(--mantine-color-edr-accent-6)"
+                    style={{ flexShrink: 0, marginTop: 1 }}
+                  />
+                  <Text fz={14} fw={700} style={{ color: INK }}>
+                    None of your profiles are active yet
+                  </Text>
+                </Group>
+
+                <Text fz={13} c="dimmed">
+                  Contracts can only be created under a profile EDR has
+                  approved. You can continue, but every operation stays locked
+                  until at least one profile is approved.
+                </Text>
+              </Stack>
+            </Popover.Dropdown>
+          </Popover>
         </Group>
 
         {/* Summary strip */}
@@ -378,7 +440,11 @@ export default function ContractsList() {
                   <Table.Tr>
                     <Table.Td colSpan={11}>
                       <Stack align="center" gap={8} py={48}>
-                        <Inbox size={26} color={MUTED} style={{ opacity: 0.5 }} />
+                        <Inbox
+                          size={26}
+                          color={MUTED}
+                          style={{ opacity: 0.5 }}
+                        />
                         <Text fz={13} c="dimmed">
                           No contracts yet. Create one from New Contract.
                         </Text>
@@ -400,154 +466,159 @@ export default function ContractsList() {
                     const isOpen = expanded.has(c.id);
                     return (
                       <Fragment key={c.id}>
-                      <Table.Tr
-                        style={{
-                          cursor: "pointer",
-                          background: isOpen ? "#F4FBF8" : undefined,
-                        }}
-                        onClick={() => navigate(`/contracts/${c.id}`)}
-                      >
-                        <Table.Td>
-                          <Box
-                            component="button"
-                            aria-label={isOpen ? "Hide progress" : "Show progress"}
-                            aria-expanded={isOpen}
-                            onClick={(e) => {
-                              e.stopPropagation();
-                              toggleExpanded(c.id);
-                            }}
-                            style={{
-                              display: "flex",
-                              alignItems: "center",
-                              justifyContent: "center",
-                              width: 28,
-                              height: 28,
-                              borderRadius: 8,
-                              border: `1px solid ${BORDER}`,
-                              background: isOpen ? GREEN : "#FFFFFF",
-                              color: isOpen ? "#FFFFFF" : MUTED,
-                              cursor: "pointer",
-                              transition: "all 140ms ease",
-                            }}
-                          >
-                            <ChevronDown
-                              size={16}
-                              style={{
-                                transform: isOpen ? "rotate(180deg)" : "none",
-                                transition: "transform 160ms ease",
+                        <Table.Tr
+                          style={{
+                            cursor: "pointer",
+                            background: isOpen ? "#F4FBF8" : undefined,
+                          }}
+                          onClick={() => navigate(`/contracts/${c.id}`)}
+                        >
+                          <Table.Td>
+                            <Box
+                              component="button"
+                              aria-label={
+                                isOpen ? "Hide progress" : "Show progress"
+                              }
+                              aria-expanded={isOpen}
+                              onClick={(e) => {
+                                e.stopPropagation();
+                                toggleExpanded(c.id);
                               }}
-                            />
-                          </Box>
-                        </Table.Td>
-                        <Table.Td>
-                          <Text fz={14} fw={700} style={{ color: INK }}>
-                            {c.reference}
-                          </Text>
-                          <Text fz={12} c="dimmed">
-                            {isContainer ? "Containerised" : "Bulk"}
-                          </Text>
-                        </Table.Td>
-                        <Table.Td>
-                          <Badge
-                            variant="light"
-                            color={isGeneral ? "edr-green" : "gray"}
-                            radius="sm"
-                          >
-                            {isGeneral ? "General" : "One-Time"}
-                          </Badge>
-                        </Table.Td>
-                        <Table.Td>
-                          <Group gap={7} wrap="nowrap" align="center">
-                            {isContainer ? (
-                              <Package size={15} color={MUTED} />
-                            ) : (
-                              <Weight size={15} color={MUTED} />
-                            )}
-                            <Text fz={13} style={{ color: INK }}>
-                              {isContainer ? "Container" : "Bulk"}
+                              style={{
+                                display: "flex",
+                                alignItems: "center",
+                                justifyContent: "center",
+                                width: 28,
+                                height: 28,
+                                borderRadius: 8,
+                                border: `1px solid ${BORDER}`,
+                                background: isOpen ? GREEN : "#FFFFFF",
+                                color: isOpen ? "#FFFFFF" : MUTED,
+                                cursor: "pointer",
+                                transition: "all 140ms ease",
+                              }}
+                            >
+                              <ChevronDown
+                                size={16}
+                                style={{
+                                  transform: isOpen ? "rotate(180deg)" : "none",
+                                  transition: "transform 160ms ease",
+                                }}
+                              />
+                            </Box>
+                          </Table.Td>
+                          <Table.Td>
+                            <Text fz={14} fw={700} style={{ color: INK }}>
+                              {c.reference}
                             </Text>
-                          </Group>
-                        </Table.Td>
-                        <Table.Td>
-                          <Text fz={13} style={{ color: INK }}>
-                            {origin}{" "}
-                            <Text span c="dimmed">
-                              →
-                            </Text>{" "}
-                            {destination}
-                            {count > 1 && (
-                              <Text span c="dimmed" fz={12}>
-                                {" "}
-                                +{count - 1}
+                            <Text fz={12} c="dimmed">
+                              {isContainer ? "Containerised" : "Bulk"}
+                            </Text>
+                          </Table.Td>
+                          <Table.Td>
+                            <Badge
+                              variant="light"
+                              color={isGeneral ? "edr-green" : "gray"}
+                              radius="sm"
+                            >
+                              {isGeneral ? "General" : "One-Time"}
+                            </Badge>
+                          </Table.Td>
+                          <Table.Td>
+                            <Group gap={7} wrap="nowrap" align="center">
+                              {isContainer ? (
+                                <Package size={15} color={MUTED} />
+                              ) : (
+                                <Weight size={15} color={MUTED} />
+                              )}
+                              <Text fz={13} style={{ color: INK }}>
+                                {isContainer ? "Container" : "Bulk"}
                               </Text>
-                            )}
-                          </Text>
-                        </Table.Td>
-                        <Table.Td>
-                          <Text
-                            fz={13}
-                            c={dir ? undefined : "dimmed"}
-                            style={{ color: dir ? INK : undefined }}
-                          >
-                            {tradeLabel}
-                          </Text>
-                        </Table.Td>
-                        <Table.Td>
-                          <Text fz={13} style={{ color: INK }}>
-                            {c.paymentCurrency ?? "—"}
-                          </Text>
-                        </Table.Td>
-                        <Table.Td>
-                          <Text
-                            fz={13}
-                            c={c.createdAt ? undefined : "dimmed"}
-                            style={{ color: c.createdAt ? INK : undefined }}
-                          >
-                            {c.createdAt
-                              ? new Date(c.createdAt).toLocaleDateString()
-                              : "—"}
-                          </Text>
-                        </Table.Td>
-                        <Table.Td>
-                          <Text
-                            fz={13}
-                            c={c.contractValidUntil ? undefined : "dimmed"}
-                            style={{
-                              color: c.contractValidUntil ? INK : undefined,
-                            }}
-                          >
-                            {c.contractValidUntil
-                              ? new Date(
+                            </Group>
+                          </Table.Td>
+                          <Table.Td>
+                            <Text fz={13} style={{ color: INK }}>
+                              {origin}{" "}
+                              <Text span c="dimmed">
+                                →
+                              </Text>{" "}
+                              {destination}
+                              {count > 1 && (
+                                <Text span c="dimmed" fz={12}>
+                                  {" "}
+                                  +{count - 1}
+                                </Text>
+                              )}
+                            </Text>
+                          </Table.Td>
+                          <Table.Td>
+                            <Text
+                              fz={13}
+                              c={dir ? undefined : "dimmed"}
+                              style={{ color: dir ? INK : undefined }}
+                            >
+                              {tradeLabel}
+                            </Text>
+                          </Table.Td>
+                          <Table.Td>
+                            <Text fz={13} style={{ color: INK }}>
+                              {c.paymentCurrency ?? "—"}
+                            </Text>
+                          </Table.Td>
+                          <Table.Td>
+                            <Text
+                              fz={13}
+                              c={c.createdAt ? undefined : "dimmed"}
+                              style={{ color: c.createdAt ? INK : undefined }}
+                            >
+                              {c.createdAt
+                                ? new Date(c.createdAt).toLocaleDateString()
+                                : "—"}
+                            </Text>
+                          </Table.Td>
+                          <Table.Td>
+                            <Text
+                              fz={13}
+                              c={c.contractValidUntil ? undefined : "dimmed"}
+                              style={{
+                                color: c.contractValidUntil ? INK : undefined,
+                              }}
+                            >
+                              {c.contractValidUntil
+                                ? new Date(
                                   c.contractValidUntil,
                                 ).toLocaleDateString()
-                              : "—"}
-                          </Text>
-                        </Table.Td>
-                        <Table.Td>
-                          <ContractStatusBadge status={c.status} />
-                        </Table.Td>
-                        <Table.Td>
-                          <Group justify="flex-end" gap={8} wrap="nowrap">
-                            <ContractDocButton
-                              contract={c}
-                              onClick={(e) => e.stopPropagation()}
-                            />
-                            <ContractCustomerAction
-                              contract={c}
-                              bookings={bookings}
-                              size="sm"
-                              listStyle
-                            />
-                          </Group>
-                        </Table.Td>
-                      </Table.Tr>
-                      {isOpen && (
-                        <Table.Tr style={{ background: "#F4FBF8" }}>
-                          <Table.Td colSpan={11} style={{ padding: "6px 20px 18px" }}>
-                            <ContractStepBanner contract={c} />
+                                : "—"}
+                            </Text>
+                          </Table.Td>
+                          <Table.Td>
+                            <ContractStatusBadge status={c.status} />
+                          </Table.Td>
+                          <Table.Td>
+                            <Group justify="flex-end" gap={8} wrap="nowrap">
+                              <ContractDocButton
+                                contract={c}
+                                onClick={(e) => e.stopPropagation()}
+                              />
+                              <ContractCustomerAction
+                                contract={c}
+                                bookings={bookings}
+                                size="sm"
+                                listStyle
+                              />
+                            </Group>
                           </Table.Td>
                         </Table.Tr>
-                      )}
+                        {isOpen && (
+                          <Table.Tr style={{ background: "#F4FBF8" }}>
+                            <Table.Td
+                              colSpan={11}
+                              style={{ padding: "6px 20px 18px" }}
+                            >
+                              <ContractStepBanner contract={c} />
+                            </Table.Td>
+                          </Table.Tr>
+                        )}
                       </Fragment>
                     );
                   })}
@@ -564,7 +635,10 @@ export default function ContractsList() {
               gap="md"
               px={20}
               py={14}
-              style={{ borderTop: `1px solid ${BORDER}`, background: "#FCFDFE" }}
+              style={{
+                borderTop: `1px solid ${BORDER}`,
+                background: "#FCFDFE",
+              }}
             >
               <Group gap={10} align="center">
                 <Text fz={13} c="dimmed">
@@ -574,8 +648,7 @@ export default function ContractsList() {
                   data={["10", "25", "50"]}
                   value={String(pagination.pageSize)}
                   onChange={(v) =>
-                    v &&
-                    setPagination({ pageIndex: 0, pageSize: Number(v) })
+                    v && setPagination({ pageIndex: 0, pageSize: Number(v) })
                   }
                   radius="md"
                   size="xs"

From 188c818251e94c93f735be6cd0d1f3294f8d20c3 Mon Sep 17 00:00:00 2001
From: Roba Boru <robab@ethiopianairines.com>
Date: Thu, 9 Jul 2026 16:18:52 +0300
Subject: [PATCH 17/25] Fix chat bot alignment

---
 .../src/app/booking/confirmation/page.tsx     |  2 +-
 .../portal/src/app/booking/layout.tsx         |  3 +-
 .../src/app/booking/passengers/page.tsx       |  4 +-
 .../portal/src/app/booking/payment/page.tsx   |  8 +-
 .../portal/src/app/booking/results/page.tsx   | 12 +--
 .../portal/src/app/booking/review/page.tsx    |  4 +-
 .../portal/src/app/booking/search/page.tsx    |  6 +-
 .../portal/src/app/booking/seats/page.tsx     | 16 ++--
 .../portal/src/app/globals.css                | 35 ++++++---
 .../portal/src/app/layout.tsx                 |  2 +-
 .../edr-passenger-web/portal/src/app/page.tsx | 48 ++++++++++--
 .../src/components/LoadingIndicator.tsx       | 73 +++++++++++++++++--
 .../src/components/ModernDatePicker.tsx       | 15 ++++
 .../portal/src/components/PageTransition.tsx  | 15 ++++
 .../portal/src/components/Skeleton.tsx        | 10 +++
 .../src/features/support/SupportWidget.tsx    |  6 +-
 .../features/support/SupportWidgetLazy.tsx    | 13 ++++
 17 files changed, 221 insertions(+), 51 deletions(-)
 create mode 100644 apps/edr-passenger-web/portal/src/components/PageTransition.tsx
 create mode 100644 apps/edr-passenger-web/portal/src/components/Skeleton.tsx
 create mode 100644 apps/edr-passenger-web/portal/src/features/support/SupportWidgetLazy.tsx

diff --git a/apps/edr-passenger-web/portal/src/app/booking/confirmation/page.tsx b/apps/edr-passenger-web/portal/src/app/booking/confirmation/page.tsx
index 515eb4449..4189e9240 100644
--- a/apps/edr-passenger-web/portal/src/app/booking/confirmation/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/booking/confirmation/page.tsx
@@ -188,7 +188,7 @@ export default function ConfirmationPage() {
   if (!bookingId || !pnr) return null;
 
   return (
-    <div className="min-h-screen bg-gray-50 dark:bg-gray-900 py-12">
+    <div className="booking-page">
       <div className="container mx-auto px-4">
         <div className="max-w-6xl mx-auto">
           {/* Success Header */}
diff --git a/apps/edr-passenger-web/portal/src/app/booking/layout.tsx b/apps/edr-passenger-web/portal/src/app/booking/layout.tsx
index dd01d4d49..ec67ec56a 100644
--- a/apps/edr-passenger-web/portal/src/app/booking/layout.tsx
+++ b/apps/edr-passenger-web/portal/src/app/booking/layout.tsx
@@ -2,6 +2,7 @@
 
 import { usePathname } from 'next/navigation';
 import { ProgressIndicator } from '@/components/ProgressIndicator';
+import { PageTransition } from '@/components/PageTransition';
 
 export default function BookingLayout({
   children,
@@ -31,7 +32,7 @@ export default function BookingLayout({
           <ProgressIndicator currentStep={currentStep} />
         </div>
       )}
-      {children}
+      <PageTransition>{children}</PageTransition>
     </div>
   );
 }
diff --git a/apps/edr-passenger-web/portal/src/app/booking/passengers/page.tsx b/apps/edr-passenger-web/portal/src/app/booking/passengers/page.tsx
index 5e5c13b3e..da81c5cd8 100644
--- a/apps/edr-passenger-web/portal/src/app/booking/passengers/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/booking/passengers/page.tsx
@@ -1024,7 +1024,7 @@ export default function PassengersPage() {
 
   if (!formInitialized || faydaCompleting) {
     return (
-      <div className="min-h-screen bg-gray-50 dark:bg-gray-900 py-12">
+      <div className="booking-page">
         <div className="container mx-auto px-4">
           <div className="max-w-lg mx-auto text-center">
             <Loader2 className="w-8 h-8 animate-spin mx-auto text-blue-600" />
@@ -1043,7 +1043,7 @@ export default function PassengersPage() {
     <div className="min-h-screen bg-gray-50 dark:bg-gray-900 py-12">
       <div className="container mx-auto px-4">
         <div className="max-w-6xl mx-auto">
-          <h1 className="text-3xl font-bold mb-6 text-gray-900 dark:text-gray-100">Passenger details</h1>
+          <h1 className="section-title">Passenger details</h1>
 
           <form onSubmit={handleSubmit(onSubmit, onInvalid)} className="space-y-6">
             {fields.map((field, index) => {
diff --git a/apps/edr-passenger-web/portal/src/app/booking/payment/page.tsx b/apps/edr-passenger-web/portal/src/app/booking/payment/page.tsx
index ceb54acd9..03b342d04 100644
--- a/apps/edr-passenger-web/portal/src/app/booking/payment/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/booking/payment/page.tsx
@@ -188,10 +188,10 @@ export default function PaymentPage() {
 
   if (!bookingId && !pnr) {
     return (
-      <div className="min-h-screen bg-gray-50 py-12 flex items-center justify-center">
+      <div className="booking-page flex items-center justify-center">
         <div className="text-center">
           <Loader2 className="w-12 h-12 text-primary animate-spin mx-auto mb-4" />
-          <p className="text-gray-600">Loading payment details...</p>
+          <p className="text-gray-600 dark:text-gray-400">Loading payment details...</p>
         </div>
       </div>
     );
@@ -372,10 +372,10 @@ export default function PaymentPage() {
   );
 
   return (
-    <div className="min-h-screen bg-gray-50 dark:bg-gray-900 py-6 pb-28 lg:pb-10">
+    <div className="booking-page pb-28 lg:pb-10">
       <div className="container mx-auto px-4">
         <div className="max-w-6xl mx-auto">
-          <h1 className="text-2xl font-bold mb-4 text-gray-900 dark:text-gray-100">Complete payment</h1>
+          <h1 className="section-title">Complete payment</h1>
 
           {/* Reservation confirmation banner */}
           <div className="card bg-green-50 dark:bg-green-900/20 border border-green-200 dark:border-green-800 mb-4 flex items-start gap-3">
diff --git a/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx b/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx
index 33609ba0e..dbaa4180b 100644
--- a/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx
@@ -524,7 +524,7 @@ export default function ResultsPage() {
                               e.stopPropagation();
                               handleSelect(classModal, isOutbound);
                             }}
-                            className="mt-3 w-full flex items-center justify-center gap-2 px-4 py-2.5 bg-gradient-to-r from-[rgb(20,113,76)] to-[rgb(16,95,65)] hover:from-[rgb(16,89,60)] hover:to-[rgb(12,75,50)] text-white font-bold text-sm rounded-xl transition-all shadow-md shadow-primary/30 hover:shadow-lg active:scale-[0.98]"
+                            className="btn-primary w-full mt-3 text-sm active:scale-[0.98]"
                           >
                             <span>
                               {isRoundTrip && isOutbound
@@ -739,7 +739,7 @@ export default function ResultsPage() {
 
   if (isLoading) {
     return (
-      <div className="min-h-screen bg-gray-50 dark:bg-gray-900 py-4 md:py-6">
+      <div className="booking-page">
         <div className="container mx-auto px-4">
           <div className="max-w-6xl mx-auto">
             {/* Progress Header */}
@@ -942,7 +942,7 @@ export default function ResultsPage() {
       (results?.alternativeInbound || []).length === 0;
     if (isRoundTripNoResults) {
       return (
-        <div className="min-h-screen bg-gray-50 dark:bg-gray-900 py-12">
+        <div className="booking-page">
           <div className="container mx-auto px-4">
             <div className="max-w-6xl mx-auto">
               <div className="flex items-center justify-between gap-4 px-4 py-3 rounded-xl bg-red-50 dark:bg-red-900/20 border border-red-200 dark:border-red-800">
@@ -964,7 +964,7 @@ export default function ResultsPage() {
       const hasAlternatives = alternativeOutbound.length > 0;
 
       return (
-        <div className="min-h-screen bg-gray-50 dark:bg-gray-900 py-12">
+        <div className="booking-page">
           {renderClassModal()}
           <div className="container mx-auto px-4">
             <div className="max-w-6xl mx-auto">
@@ -1003,7 +1003,7 @@ export default function ResultsPage() {
     }
 
     return (
-      <div className="min-h-screen bg-gray-50 dark:bg-gray-900 py-12">
+      <div className="booking-page">
         <div className="container mx-auto px-4">
           <div className="max-w-6xl mx-auto">
             <div className="flex items-center justify-between gap-4 px-4 py-3 rounded-xl bg-gray-100 dark:bg-gray-800 border border-gray-200 dark:border-gray-700">
@@ -1022,7 +1022,7 @@ export default function ResultsPage() {
   }
 
   return (
-    <div className="min-h-screen bg-gray-50 dark:bg-gray-900 py-4 md:py-6">
+    <div className="booking-page">
       <div className="container mx-auto px-4">
         <div className="max-w-6xl mx-auto">
           {renderClassModal()}
diff --git a/apps/edr-passenger-web/portal/src/app/booking/review/page.tsx b/apps/edr-passenger-web/portal/src/app/booking/review/page.tsx
index cf14cc87c..081626642 100644
--- a/apps/edr-passenger-web/portal/src/app/booking/review/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/booking/review/page.tsx
@@ -613,10 +613,10 @@ export default function ReviewPage() {
   );
 
   return (
-    <div className="min-h-screen bg-gray-50 dark:bg-gray-900 py-6 pb-28 lg:pb-10">
+    <div className="booking-page pb-28 lg:pb-10">
       <div className="container mx-auto px-4">
         <div className="max-w-6xl mx-auto">
-          <h1 className="text-2xl font-bold mb-4 text-gray-900 dark:text-gray-100">
+          <h1 className="section-title">
             {packageName ? `Review your ${packageName} booking` : 'Review your booking'}
           </h1>
 
diff --git a/apps/edr-passenger-web/portal/src/app/booking/search/page.tsx b/apps/edr-passenger-web/portal/src/app/booking/search/page.tsx
index 574b08487..c51ee4141 100644
--- a/apps/edr-passenger-web/portal/src/app/booking/search/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/booking/search/page.tsx
@@ -1079,7 +1079,7 @@ export default function SearchPage() {
                     <button
                       type="submit"
                       disabled={isLoading}
-                      className="w-full flex items-center justify-center gap-2 py-3.5 bg-[rgb(20,113,76)] hover:bg-[rgb(16,89,60)] text-white font-bold text-sm rounded-xl transition-all shadow-lg disabled:opacity-50"
+                      className="btn-primary w-full text-sm"
                     >
                       <Search className="w-5 h-5" />
                       Search
@@ -1219,7 +1219,7 @@ export default function SearchPage() {
                         <button
                           type="submit"
                           disabled={isLoading}
-                          className="flex-shrink-0 flex items-center justify-center gap-2 px-5 py-3.5 bg-[rgb(20,113,76)] hover:bg-[rgb(16,89,60)] text-white font-bold text-sm rounded-xl transition-all shadow-lg hover:shadow-xl disabled:opacity-50"
+                          className="flex-shrink-0 flex items-center justify-center gap-2 px-5 py-3.5 bg-[rgb(20,113,76)] hover:bg-[rgb(16,89,60)] text-white font-bold text-sm rounded-xl transition-all transform hover:-translate-y-0.5 shadow-lg hover:shadow-xl disabled:opacity-50"
                         >
                           <Search className="w-5 h-5" />
                           Search
@@ -1482,7 +1482,7 @@ export default function SearchPage() {
                             <button
                               type="submit"
                               disabled={isLoading}
-                              className="flex items-center justify-center gap-2 px-6 py-3.5 bg-[rgb(20,113,76)] hover:bg-[rgb(16,89,60)] text-white font-bold text-sm rounded-xl transition-all shadow-lg hover:shadow-xl disabled:opacity-50"
+                              className="flex items-center justify-center gap-2 px-6 py-3.5 bg-[rgb(20,113,76)] hover:bg-[rgb(16,89,60)] text-white font-bold text-sm rounded-xl transition-all transform hover:-translate-y-0.5 shadow-lg hover:shadow-xl disabled:opacity-50"
                             >
                               <Search className="w-5 h-5" />
                               Search
diff --git a/apps/edr-passenger-web/portal/src/app/booking/seats/page.tsx b/apps/edr-passenger-web/portal/src/app/booking/seats/page.tsx
index f8fd23609..4b764e342 100644
--- a/apps/edr-passenger-web/portal/src/app/booking/seats/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/booking/seats/page.tsx
@@ -11,6 +11,7 @@ import { Armchair, Bed, ChevronLeft, ChevronDown, Train, TrainFront, X } from "l
 import Image from "next/image";
 
 import CustomModal from "@/components/CustomModal";
+import { Skeleton } from "@/components/Skeleton";
 import { isChild } from "@/utils/fare-utils";
 
 const BED_POSITION_SUFFIX: Record<string, string> = { lower: 'L', middle: 'M', upper: 'U' };
@@ -2187,11 +2188,16 @@ export default function SeatsPage() {
                   </button>
                 </div>
                 {isLoading ? (
-                  <div className="bg-white dark:bg-gray-800 rounded-2xl p-8 text-center">
-                    <div className="w-10 h-10 border-4 border-primary border-t-transparent rounded-full animate-spin mx-auto mb-3" />
-                    <p className="text-sm text-gray-500 dark:text-gray-400">
-                      Loading seat map...
-                    </p>
+                  <div className="bg-white dark:bg-gray-800 rounded-2xl p-6 space-y-4">
+                    <div className="flex items-center justify-between">
+                      <Skeleton className="h-5 w-32" />
+                      <Skeleton className="h-8 w-24 rounded-lg" />
+                    </div>
+                    <div className="grid grid-cols-4 gap-3">
+                      {Array.from({ length: 24 }).map((_, i) => (
+                        <Skeleton key={i} className="aspect-square rounded-xl" />
+                      ))}
+                    </div>
                   </div>
                 ) : error ? (
                   <div className="bg-white dark:bg-gray-800 rounded-2xl p-8 text-center">
diff --git a/apps/edr-passenger-web/portal/src/app/globals.css b/apps/edr-passenger-web/portal/src/app/globals.css
index 9714d54bc..9296f3030 100644
--- a/apps/edr-passenger-web/portal/src/app/globals.css
+++ b/apps/edr-passenger-web/portal/src/app/globals.css
@@ -26,19 +26,17 @@
   }
   
   .btn-ghost {
-    @apply text-[rgb(20_113_76)] font-medium py-2 px-4 rounded-lg transition-colors;
+    @apply text-[rgb(20_113_76)] font-medium py-2 px-4 rounded-lg transition-colors hover:bg-[rgba(20,113,76,0.1)] dark:hover:bg-[rgba(20,113,76,0.2)];
   }
-  
-  .btn-ghost:hover {
-    background-color: rgba(20, 113, 76, 0.1);
+
+  .booking-page {
+    @apply min-h-screen bg-gray-50 dark:bg-gray-900 py-6 md:py-8;
   }
-  
-  @media (prefers-color-scheme: dark) {
-    .btn-ghost:hover {
-      background-color: rgba(20, 113, 76, 0.2);
-    }
+
+  .booking-container {
+    @apply container mx-auto px-4 max-w-6xl;
   }
-  
+
   .input-field {
     @apply w-full px-4 py-3 border-2 border-gray-200 dark:border-gray-700 rounded-xl focus:outline-none focus:ring-2 focus:ring-[rgb(20_113_76)] focus:border-transparent disabled:bg-gray-50 dark:disabled:bg-gray-800 disabled:cursor-not-allowed transition-all duration-200 text-base bg-white dark:bg-gray-800 text-gray-900 dark:text-gray-100;
   }
@@ -162,7 +160,18 @@
       opacity: 1;
     }
   }
-  
+
+  @keyframes fade-in-up {
+    from {
+      opacity: 0;
+      transform: translateY(8px);
+    }
+    to {
+      opacity: 1;
+      transform: translateY(0);
+    }
+  }
+
   .animate-bounce-in {
     animation: bounce-in 0.5s cubic-bezier(0.34, 1.56, 0.64, 1);
   }
@@ -188,6 +197,10 @@
     animation: slide-up 0.25s cubic-bezier(0.32, 0.72, 0, 1);
   }
 
+  .animate-fade-in-up {
+    animation: fade-in-up 0.35s ease-out;
+  }
+
   .scrollbar-hide {
     -ms-overflow-style: none;
     scrollbar-width: none;
diff --git a/apps/edr-passenger-web/portal/src/app/layout.tsx b/apps/edr-passenger-web/portal/src/app/layout.tsx
index 3c18f1c13..e393b5f20 100644
--- a/apps/edr-passenger-web/portal/src/app/layout.tsx
+++ b/apps/edr-passenger-web/portal/src/app/layout.tsx
@@ -5,7 +5,7 @@ import { Providers } from './providers';
 import AppHeader from '@/components/AppHeader';
 import { Footer } from '@/components/Footer';
 import { LoadingIndicator } from '@/components/LoadingIndicator';
-import SupportWidget from '@/features/support/SupportWidget';
+import SupportWidget from '@/features/support/SupportWidgetLazy';
 
 export const metadata: Metadata = {
   title: 'EDR Passenger Portal - Book your train journey',
diff --git a/apps/edr-passenger-web/portal/src/app/page.tsx b/apps/edr-passenger-web/portal/src/app/page.tsx
index 93bf02fc2..b9475fc81 100644
--- a/apps/edr-passenger-web/portal/src/app/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/page.tsx
@@ -1,9 +1,37 @@
 import { Suspense } from 'react';
+import dynamic from 'next/dynamic';
 import { dehydrate, HydrationBoundary, QueryClient } from '@tanstack/react-query';
 import SearchPage from '@/app/booking/search/page';
-import PackagesSection from '@/components/PackagesSection';
 
-export default async function Home() {
+// Below-the-fold on the landing page — code-split out of the initial bundle
+// needed to render/hydrate the (above-the-fold) search form.
+const PackagesSection = dynamic(() => import('@/components/PackagesSection'));
+
+// Skeleton for the search form while stations are prefetched server-side —
+// keeps first paint on a slow connection from being a blank page, and
+// approximates the real form's height to avoid layout shift once it streams in.
+function SearchFormSkeleton() {
+  return (
+    <div className="w-full max-w-4xl mx-auto animate-pulse">
+      <div className="rounded-2xl border border-gray-100 dark:border-gray-800 p-6 space-y-4">
+        <div className="h-8 bg-gray-200 dark:bg-gray-700 rounded w-1/3" />
+        <div className="grid md:grid-cols-2 gap-4">
+          <div className="h-12 bg-gray-200 dark:bg-gray-700 rounded-xl" />
+          <div className="h-12 bg-gray-200 dark:bg-gray-700 rounded-xl" />
+        </div>
+        <div className="h-12 bg-gray-200 dark:bg-gray-700 rounded-xl" />
+        <div className="h-12 bg-gray-300 dark:bg-gray-600 rounded-xl w-40" />
+      </div>
+    </div>
+  );
+}
+
+// Isolates the server-side stations prefetch behind its own Suspense boundary
+// (a real async Server Component, unlike a plain `await` in the page body) so
+// Next.js can stream: the shell flushes immediately with SearchFormSkeleton,
+// then the real search form + hydrated stations data stream in once ready —
+// instead of blocking the whole page's TTFB on that one fetch.
+async function StationsPrefetch({ children }: { children: React.ReactNode }) {
   const queryClient = new QueryClient();
   const apiUrl = process.env.NEXT_PUBLIC_API_URL || 'http://localhost:4000';
 
@@ -18,10 +46,18 @@ export default async function Home() {
 
   return (
     <HydrationBoundary state={dehydrate(queryClient)}>
-      <Suspense>
-        <SearchPage />
-        <PackagesSection />
-      </Suspense>
+      {children}
     </HydrationBoundary>
   );
 }
+
+export default function Home() {
+  return (
+    <Suspense fallback={<SearchFormSkeleton />}>
+      <StationsPrefetch>
+        <SearchPage />
+        <PackagesSection />
+      </StationsPrefetch>
+    </Suspense>
+  );
+}
diff --git a/apps/edr-passenger-web/portal/src/components/LoadingIndicator.tsx b/apps/edr-passenger-web/portal/src/components/LoadingIndicator.tsx
index 9fa5c466e..09ad7d787 100644
--- a/apps/edr-passenger-web/portal/src/components/LoadingIndicator.tsx
+++ b/apps/edr-passenger-web/portal/src/components/LoadingIndicator.tsx
@@ -1,23 +1,72 @@
 'use client';
 
-import { useEffect, useState } from 'react';
+import { Suspense, useEffect, useRef, useState } from 'react';
+import { usePathname, useSearchParams } from 'next/navigation';
 
-export function LoadingIndicator() {
+// Minimum time the bar stays visible once shown, so very fast local
+// transitions don't flash imperceptibly (standard practice for top-loading
+// progress bars).
+const MIN_VISIBLE_MS = 300;
+
+function LoadingIndicatorInner() {
+  const pathname = usePathname();
+  const searchParams = useSearchParams();
   const [isVisible, setIsVisible] = useState(false);
+  const shownAtRef = useRef<number | null>(null);
 
+  // Detects the START of a navigation: a same-origin link click gives
+  // instant feedback on tap, before the RSC fetch even begins. Browser
+  // back/forward (popstate) is covered the same way.
   useEffect(() => {
-    const handleStart = () => setIsVisible(true);
-    const handleEnd = () => setIsVisible(false);
+    const handleClick = (e: MouseEvent) => {
+      if (e.defaultPrevented || e.button !== 0) return;
+      if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;
 
-    window.addEventListener('beforeunload', handleStart);
-    window.addEventListener('load', handleEnd);
+      const anchor = (e.target as HTMLElement | null)?.closest('a');
+      if (!anchor) return;
+      if (anchor.target && anchor.target !== '_self') return;
+      if (anchor.hasAttribute('download')) return;
 
+      const href = anchor.getAttribute('href');
+      if (!href || href.startsWith('#') || href.startsWith('mailto:') || href.startsWith('tel:')) return;
+
+      let url: URL;
+      try {
+        url = new URL(href, window.location.href);
+      } catch {
+        return;
+      }
+      if (url.origin !== window.location.origin) return;
+      if (url.pathname + url.search === window.location.pathname + window.location.search) return;
+
+      shownAtRef.current = Date.now();
+      setIsVisible(true);
+    };
+
+    const handlePopState = () => {
+      shownAtRef.current = Date.now();
+      setIsVisible(true);
+    };
+
+    document.addEventListener('click', handleClick, true);
+    window.addEventListener('popstate', handlePopState);
     return () => {
-      window.removeEventListener('beforeunload', handleStart);
-      window.removeEventListener('load', handleEnd);
+      document.removeEventListener('click', handleClick, true);
+      window.removeEventListener('popstate', handlePopState);
     };
   }, []);
 
+  // Detects the END of a navigation: pathname/search settling to a new value
+  // means the route transition has completed.
+  useEffect(() => {
+    if (!isVisible) return;
+    const elapsed = shownAtRef.current ? Date.now() - shownAtRef.current : MIN_VISIBLE_MS;
+    const remaining = Math.max(0, MIN_VISIBLE_MS - elapsed);
+    const timer = setTimeout(() => setIsVisible(false), remaining);
+    return () => clearTimeout(timer);
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [pathname, searchParams]);
+
   if (!isVisible) return null;
 
   return (
@@ -28,3 +77,11 @@ export function LoadingIndicator() {
     </div>
   );
 }
+
+export function LoadingIndicator() {
+  return (
+    <Suspense fallback={null}>
+      <LoadingIndicatorInner />
+    </Suspense>
+  );
+}
diff --git a/apps/edr-passenger-web/portal/src/components/ModernDatePicker.tsx b/apps/edr-passenger-web/portal/src/components/ModernDatePicker.tsx
index 5ea145bba..1f0bbddfe 100644
--- a/apps/edr-passenger-web/portal/src/components/ModernDatePicker.tsx
+++ b/apps/edr-passenger-web/portal/src/components/ModernDatePicker.tsx
@@ -259,6 +259,21 @@ export default function ModernDatePicker({
         {calendarType === 'gregorian' ? renderGregorianCalendar() : renderEthiopianCalendar()}
         {calendarFooter}
       </div>
+
+      {/* Mobile-only: a large, unmistakable Cancel action in addition to the header
+          X — the mobile view is a full-screen takeover with no backdrop to tap, so
+          this is the fallback way out without having to pick a date. */}
+      {isMobileView && (
+        <div className="flex-shrink-0 border-t border-gray-200 dark:border-gray-700 p-3 bg-white dark:bg-gray-900">
+          <button
+            type="button"
+            onClick={() => setIsOpen(false)}
+            className="w-full py-3 rounded-xl border-2 border-gray-200 dark:border-gray-700 text-sm font-semibold text-gray-700 dark:text-gray-300 hover:bg-gray-50 dark:hover:bg-gray-800 transition-colors"
+          >
+            Cancel
+          </button>
+        </div>
+      )}
     </div>
   );
 
diff --git a/apps/edr-passenger-web/portal/src/components/PageTransition.tsx b/apps/edr-passenger-web/portal/src/components/PageTransition.tsx
new file mode 100644
index 000000000..dbc8839e3
--- /dev/null
+++ b/apps/edr-passenger-web/portal/src/components/PageTransition.tsx
@@ -0,0 +1,15 @@
+'use client';
+
+import { usePathname } from 'next/navigation';
+
+// Keying by pathname forces React to remount this wrapper on every route
+// change, which restarts the CSS animation — a subtle fade/slide-up on each
+// step of the booking flow, no animation library required.
+export function PageTransition({ children }: { children: React.ReactNode }) {
+  const pathname = usePathname();
+  return (
+    <div key={pathname} className="animate-fade-in-up">
+      {children}
+    </div>
+  );
+}
diff --git a/apps/edr-passenger-web/portal/src/components/Skeleton.tsx b/apps/edr-passenger-web/portal/src/components/Skeleton.tsx
new file mode 100644
index 000000000..1c69f7483
--- /dev/null
+++ b/apps/edr-passenger-web/portal/src/components/Skeleton.tsx
@@ -0,0 +1,10 @@
+interface SkeletonProps {
+  className?: string;
+}
+
+// Shared pulse-block primitive for loading placeholders — replaces the
+// hand-rolled `animate-pulse` divs duplicated across PackagesSection,
+// results/page.tsx, and the home page's search skeleton.
+export function Skeleton({ className = '' }: SkeletonProps) {
+  return <div className={`animate-pulse rounded-lg bg-gray-200 dark:bg-gray-700 ${className}`} />;
+}
diff --git a/apps/edr-passenger-web/portal/src/features/support/SupportWidget.tsx b/apps/edr-passenger-web/portal/src/features/support/SupportWidget.tsx
index 96ecc7276..8a4100de9 100644
--- a/apps/edr-passenger-web/portal/src/features/support/SupportWidget.tsx
+++ b/apps/edr-passenger-web/portal/src/features/support/SupportWidget.tsx
@@ -23,7 +23,11 @@ export function SupportWidget() {
   useSupportSocket(true);
 
   return (
-    <div className="fixed bottom-6 right-6 z-[100] flex flex-col items-end gap-3">
+    // Kept below every modal/drawer tier (z-90 through z-[120]) and the mobile sticky
+    // bottom action bars (z-40) used on booking flow pages, so the floating launcher never
+    // paints over dialog content or a page's "Continue" bar — it only sits above ordinary
+    // in-page content.
+    <div className="fixed bottom-6 right-6 z-30 flex flex-col items-end gap-3">
       {open && <SupportPanel onClose={() => setOpen(false)} />}
       {!open && (
         <button
diff --git a/apps/edr-passenger-web/portal/src/features/support/SupportWidgetLazy.tsx b/apps/edr-passenger-web/portal/src/features/support/SupportWidgetLazy.tsx
new file mode 100644
index 000000000..6c5faadcd
--- /dev/null
+++ b/apps/edr-passenger-web/portal/src/features/support/SupportWidgetLazy.tsx
@@ -0,0 +1,13 @@
+'use client';
+
+import dynamic from 'next/dynamic';
+
+// Code-split the support widget out of the initial page bundle — it pulls in
+// socket.io-client and opens a live WebSocket connection on mount (see
+// useSupportSocket), which otherwise happens on every single page load before
+// the user ever opens the chat. next/dynamic + ssr:false must be called from a
+// Client Component (disallowed directly in a Server Component like layout.tsx),
+// hence this thin wrapper.
+const SupportWidget = dynamic(() => import('./SupportWidget'), { ssr: false });
+
+export default SupportWidget;

From 70a974263104b6f5c6838f7edde88abb29573a6d Mon Sep 17 00:00:00 2001
From: natib21 <yaschalew10@gmail.com>
Date: Thu, 9 Jul 2026 14:01:59 +0000
Subject: [PATCH 18/25] add gps readme

---
 .../src/modules/gps-tracking/README.md        | 150 ++++++++++++++++++
 1 file changed, 150 insertions(+)
 create mode 100644 apps/edr-freight-api/src/modules/gps-tracking/README.md

diff --git a/apps/edr-freight-api/src/modules/gps-tracking/README.md b/apps/edr-freight-api/src/modules/gps-tracking/README.md
new file mode 100644
index 000000000..668b581b8
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/gps-tracking/README.md
@@ -0,0 +1,150 @@
+# GPS Tracking (GT06) — Operations & Device Configuration
+
+GT06 trackers speak a **raw TCP binary protocol**, not HTTP/HTTPS. This shapes
+everything about how the service is deployed and how devices are pointed at it.
+
+---
+
+## 1. Why GPS needs its own dedicated TCP port
+
+- **Not HTTP.** GT06 devices send binary frames
+  (`0x78 0x78 | len | protocol | payload | serial | CRC16 | 0x0D 0x0A`).
+  An HTTP server receiving these answers `400 Bad Request` and closes.
+- **Dedicated port required.** A listening socket is keyed on `(IP, port)`; two
+  listeners on the same pair collide (`EADDRINUSE`). The REST API already owns
+  its port, so GPS traffic needs a separate one.
+- **No hostname routing.** GT06 frames carry no `Host` header and no TLS SNI, so
+  L7 proxies (Nginx `http`, AWS ALB, Cloudflare proxy) cannot route them by
+  domain. Routing must happen at **Layer 4 (TCP)** by port.
+- **DNS carries no port.** An A record maps a name to an IP only. The tracker
+  config must state the port explicitly (e.g. `gps.example.com:5023`).
+
+### Operational requirements
+
+| Item | Value |
+| --- | --- |
+| Protocol | Raw TCP (not HTTP, not TLS) |
+| Default port | `5023` (configurable via `GT06_TCP_PORT`) |
+| Listener bind | `0.0.0.0` inside the `freight-gps` container |
+| Edge terminator | **L4** — AWS NLB or Nginx `stream {}`. **Not** ALB / Cloudflare proxy. |
+
+---
+
+## 2. Port configuration
+
+`5023` is only this project's default — **not** a GT06 protocol requirement. The
+listener binds whatever `GT06_TCP_PORT` says, as long as trackers are configured
+with the same number.
+
+Host and container ports are decoupled in `docker-compose.yaml`:
+
+```yaml
+freight-gps:
+  ports:
+    - "${GT06_TCP_PORT:-5023}:5023"   # host is configurable; container fixed
+  environment:
+    GT06_TCP_PORT: "5023"             # pinned inside the container
+```
+
+- The **container** always listens on `5023`.
+- The **host/public** port is configurable (443, 5023, 9000, …) via the root
+  `.env`'s `GT06_TCP_PORT`.
+- This split is required because the image runs as a **non-root** user
+  (`nestjs`, uid 1001), which cannot bind ports `<1024`. Docker (root) binds the
+  host port and forwards to `5023` inside.
+- Running **outside Docker** (`pnpm dev:gps`, systemd), `GT06_TCP_PORT` is the
+  actual bind port, so `<1024` needs root or `CAP_NET_BIND_SERVICE`.
+- **443 is allowed but risky:** GT06 stays raw TCP, not TLS. Middleboxes that
+  expect a TLS handshake on 443 may drop the connection.
+
+---
+
+## 3. Deployment topology
+
+The GT06 listener runs as its own process (`dist/main.gps.js`, module
+`GpsIngestModule`) — DB + GPS only, no HTTP server. It shares the `edr_freight`
+DB with the API; the DB is the seam (ingester writes `gps_devices` /
+`gps_positions`, API reads them).
+
+```
+freight-api    HTTP :3001   GT06_TCP_PORT=0        (listener off, applies migrations)
+freight-gps    TCP  :5023   DB_MIGRATIONS_RUN=false (owns the tracker socket)
+```
+
+`DB_MIGRATIONS_RUN=false` keeps the second process from racing migrations.
+
+Horizontal scale: each tracker holds one long-lived TCP connection with
+per-socket session state, so N `freight-gps` replicas can run behind an L4 LB —
+each device sticks to one replica. `ensureDevice` is safe under concurrency
+(unique IMEI).
+
+---
+
+## 4. Device configuration (GT06 side)
+
+Config is done by **SMS to the tracker's SIM**. Commands below are the canonical
+Concox/GT06 set — **verify against your unit's sheet**, syntax varies by firmware.
+Default command password is usually `123456`.
+
+Prep: data-enabled SIM, SMS on, **SIM PIN off**, know your carrier APN.
+
+```
+STATUS#                          # 1. sanity check — returns GSM/GPS/batt/GPRS
+APN,<apn>#                       # 2. carrier data APN (add ,user,pass if needed)
+SERVER,1,gps.example.com,5023,0# # 3. point at server (1=domain). Port MUST match GT06_TCP_PORT
+GPRSON,1#                        # 4. enable data
+GPSON,1#                         #    enable GPS
+TIMER,10#                        # 5. upload interval, seconds (some use UPLOAD,10#)
+RESET#                           # 6. reboot so it reconnects (many cache DNS until reboot)
+```
+
+Raw-IP variant of step 3: `SERVER,0,203.0.113.50,5023,0#`
+Custom host port (e.g. 443): `SERVER,1,gps.example.com,443,0#`
+
+### Verify from the server
+
+```bash
+docker compose logs -f freight-gps | grep -Ei "login|Auto-registering|ingester up"
+nc -vz gps.example.com 5023
+curl -H "Authorization: Bearer <token>" https://api.example.com/api/gps/positions/latest
+```
+
+First login packet **auto-registers** the IMEI (no manual step). `online:true`
+only when `lastSeenAt` < 5 min (computed at read time).
+
+### Link a tracker to a vehicle (optional)
+
+Auto-register leaves `vehicleId` null. Attach it (needs `tracking.manage`):
+
+```
+PATCH /api/gps/devices/:id   { "vehicleId": "<uuid>", "name": "Truck 03-ET" }
+```
+
+### Failure map
+
+| Symptom | Cause |
+| --- | --- |
+| No SMS reply | SIM PIN on / no signal / wrong number |
+| Replies but never connects | APN wrong, or `SERVER` port ≠ `GT06_TCP_PORT` |
+| Connects then drops | server not ACKing, or middlebox on 443 expecting TLS |
+| Registered but `online:false` | packets blocked by firewall — open inbound TCP |
+| Wrong location / `positioned:false` | no GPS fix yet — open sky, cold start ~1–2 min |
+
+---
+
+## 5. Security
+
+- GT06 authenticates with **IMEI only**, which is **spoofable**. Anyone who can
+  reach the port can inject fake positions.
+- **Do not** expose the port to `0.0.0.0/0`. Restrict at the firewall / security
+  group to the SIM provider's **APN / IP range**.
+- Trackers must use the same host+port as the server:
+  `SERVER,1,gps.example.com,<port>,0#`.
+
+---
+
+## 6. Edge (L4) termination
+
+See [`infrastructure/nginx/gps-stream.conf`](../../../../../infrastructure/nginx/gps-stream.conf)
+for an Nginx `stream {}` example, and the AWS NLB notes in the same file.
+Reminder: **L4 only** — an HTTP proxy cannot route GT06.

From fc065b50aa2da187bb19df0be14b6c258a3b9b68 Mon Sep 17 00:00:00 2001
From: Roba Boru <robab@ethiopianairines.com>
Date: Thu, 9 Jul 2026 17:20:00 +0300
Subject: [PATCH 19/25] design revamp

---
 .../src/app/booking/confirmation/page.tsx     |  43 ++--
 .../portal/src/app/booking/results/page.tsx   |  16 +-
 .../portal/src/app/booking/search/page.tsx    |  72 ++++--
 .../portal/src/app/contact/page.tsx           |   7 +-
 .../portal/src/app/go/page.tsx                |   2 +-
 .../portal/src/app/layout.tsx                 |  20 +-
 .../portal/src/components/AppHeader.tsx       | 214 ------------------
 .../portal/src/components/AppSidebar.tsx      | 212 +++++++++++++++++
 .../portal/src/components/BottomTabBar.tsx    |  69 ++++++
 .../portal/src/components/LandingNav.tsx      | 163 -------------
 .../portal/src/components/MobileTopBar.tsx    |  24 ++
 .../src/components/ModernDatePicker.tsx       |  14 +-
 .../src/components/ProgressIndicator.tsx      |  19 +-
 13 files changed, 430 insertions(+), 445 deletions(-)
 delete mode 100644 apps/edr-passenger-web/portal/src/components/AppHeader.tsx
 create mode 100644 apps/edr-passenger-web/portal/src/components/AppSidebar.tsx
 create mode 100644 apps/edr-passenger-web/portal/src/components/BottomTabBar.tsx
 delete mode 100644 apps/edr-passenger-web/portal/src/components/LandingNav.tsx
 create mode 100644 apps/edr-passenger-web/portal/src/components/MobileTopBar.tsx

diff --git a/apps/edr-passenger-web/portal/src/app/booking/confirmation/page.tsx b/apps/edr-passenger-web/portal/src/app/booking/confirmation/page.tsx
index 4189e9240..719e80f18 100644
--- a/apps/edr-passenger-web/portal/src/app/booking/confirmation/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/booking/confirmation/page.tsx
@@ -456,26 +456,29 @@ export default function ConfirmationPage() {
             </div>
           </div>
 
-          {/* Action Buttons */}
-          <div className="mb-6">
-            <button
-              onClick={handleDownloadVoucher}
-              disabled={isGeneratingVoucher}
-              className="btn-primary w-full flex items-center justify-center gap-2 relative"
-            >
-              {isGeneratingVoucher ? (
-                <>
-                  <div className="w-4 h-4 border-2 border-white border-t-transparent rounded-full animate-spin" />
-                  <span>Generating...</span>
-                </>
-              ) : (
-                <>
-                  <FileText className="w-4 h-4" />
-                  <span>Download Voucher</span>
-                </>
-              )}
-            </button>
-          </div>
+          {/* Action Buttons — voucher/ticket only makes sense once the booking is
+              actually confirmed; a pending-payment booking has no real ticket yet. */}
+          {isConfirmed && (
+            <div className="mb-6">
+              <button
+                onClick={handleDownloadVoucher}
+                disabled={isGeneratingVoucher}
+                className="btn-primary w-full flex items-center justify-center gap-2 relative"
+              >
+                {isGeneratingVoucher ? (
+                  <>
+                    <div className="w-4 h-4 border-2 border-white border-t-transparent rounded-full animate-spin" />
+                    <span>Generating...</span>
+                  </>
+                ) : (
+                  <>
+                    <FileText className="w-4 h-4" />
+                    <span>Download Voucher</span>
+                  </>
+                )}
+              </button>
+            </div>
+          )}
 
           {/* New Booking Button */}
           <button 
diff --git a/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx b/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx
index dbaa4180b..b049c7b55 100644
--- a/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/booking/results/page.tsx
@@ -642,9 +642,9 @@ export default function ResultsPage() {
               </div>
             </div>
 
-            <div className="flex items-center gap-4">
+            <div className="flex items-center gap-2 md:gap-4">
               <div className="text-center">
-                <div className="text-3xl font-bold text-gray-900 dark:text-gray-100">
+                <div className="text-xl md:text-3xl font-bold text-gray-900 dark:text-gray-100 whitespace-nowrap">
                   {schedule.departureAt
                     ? formatTime(schedule.departureAt)
                     : "--:--"}
@@ -659,9 +659,9 @@ export default function ResultsPage() {
                 </div>
               </div>
 
-              <div className="flex-1 flex flex-col items-center">
-                <div className="flex items-center gap-2 mb-2 text-sm text-gray-600 dark:text-gray-400">
-                  <Clock className="w-4 h-4" />
+              <div className="flex-1 min-w-0 flex flex-col items-center">
+                <div className="flex items-center gap-1 md:gap-2 mb-2 text-xs md:text-sm text-gray-600 dark:text-gray-400 whitespace-nowrap">
+                  <Clock className="w-3.5 h-3.5 md:w-4 md:h-4 flex-shrink-0" />
                   <span>{durationStr}</span>
                 </div>
                 <div className="w-full h-0.5 bg-gray-200 dark:bg-gray-700 relative">
@@ -669,15 +669,15 @@ export default function ResultsPage() {
                   <div className="absolute right-0 top-1/2 -translate-y-1/2 w-2 h-2 bg-primary rounded-full" />
                 </div>
                 {schedule.stops && schedule.stops.length > 0 && (
-                  <div className="flex items-center gap-1 mt-2 text-sm text-gray-600 dark:text-gray-400">
-                    <MapPin className="w-4 h-4" />
+                  <div className="flex items-center gap-1 mt-2 text-xs md:text-sm text-gray-600 dark:text-gray-400 whitespace-nowrap">
+                    <MapPin className="w-3.5 h-3.5 md:w-4 md:h-4 flex-shrink-0" />
                     <span>{schedule.stops.length - 2} stops</span>
                   </div>
                 )}
               </div>
 
               <div className="text-center">
-                <div className="text-3xl font-bold text-gray-900 dark:text-gray-100">
+                <div className="text-xl md:text-3xl font-bold text-gray-900 dark:text-gray-100 whitespace-nowrap">
                   {schedule.arrivalAt
                     ? formatTime(schedule.arrivalAt)
                     : "--:--"}
diff --git a/apps/edr-passenger-web/portal/src/app/booking/search/page.tsx b/apps/edr-passenger-web/portal/src/app/booking/search/page.tsx
index c51ee4141..02c1fcd35 100644
--- a/apps/edr-passenger-web/portal/src/app/booking/search/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/booking/search/page.tsx
@@ -608,6 +608,12 @@ export default function SearchPage() {
     reValidateMode: "onSubmit",
     defaultValues: {
       tripType: "ONE_WAY",
+      // originStationId/destinationStationId must default to "" rather than being omitted —
+      // Zod's base string type check runs before .min(1, "..."), so an `undefined` value hits
+      // its generic "Required" message instead of our custom one. An empty string is still a
+      // string, so .min() (and its custom message) is what actually fires.
+      originStationId: "",
+      destinationStationId: "",
       adultCount: 1,
       childCount: 0,
       // No default nationality — the user must explicitly pick one. Left blank (not a valid
@@ -827,19 +833,21 @@ export default function SearchPage() {
         />
       )}
 
-      {/* ── 90vh hero with banner image ── */}
-      {/* Round trip stacks an extra Return Date field into the widget on mobile, which grows
+      {/* ── 90vh hero with banner image (desktop) / top-aligned widget only (mobile) ── */}
+      {/* Round trip stacks an extra Return Date field into the widget on desktop, which grows
           upward from its bottom-anchored position — give the hero extra height there so the
-          widget's top edge doesn't creep up into the sticky header. */}
+          widget's top edge doesn't creep up into the sticky header. On mobile the widget is
+          in normal flow (not bottom-anchored), so this only applies at md: and up. */}
       <section
         className={`relative ${
           tripType === "ROUND_TRIP"
-            ? "h-[calc(90vh+60px)] min-h-[670px] md:h-[90vh] md:min-h-[560px]"
-            : "h-[94vh] min-h-[560px]"
+            ? "md:h-[90vh] md:min-h-[560px]"
+            : "md:h-[94vh] md:min-h-[560px]"
         }`}
       >
-        {/* Background image with zoom - fully isolated */}
-        <div className="absolute inset-0 overflow-hidden">
+        {/* Background image with zoom — desktop only; mobile drops the hero image entirely
+            so the booking widget can sit at the top and use the available space. */}
+        <div className="hidden md:block absolute inset-0 overflow-hidden">
           <div
             className="w-full h-full bg-cover bg-center animate-bg-zoom"
             style={{
@@ -852,12 +860,12 @@ export default function SearchPage() {
             }}
           />
         </div>
-        {/* Gradient overlay */}
-        <div className="absolute inset-0 bg-gradient-to-br from-black/70 via-black/40 to-transparent" />
-        <div className="absolute inset-0 bg-gradient-to-t from-black/80 via-transparent to-transparent" />
+        {/* Gradient overlay — desktop only (exists to keep the hero text readable over the image) */}
+        <div className="hidden md:block absolute inset-0 bg-gradient-to-br from-black/70 via-black/40 to-transparent" />
+        <div className="hidden md:block absolute inset-0 bg-gradient-to-t from-black/80 via-transparent to-transparent" />
 
-        {/* Hero headline — top area */}
-        <div className="relative z-10 pt-16 md:pt-20 px-6 md:px-12 max-w-6xl mx-auto">
+        {/* Hero headline — desktop only; removed on mobile along with the banner image */}
+        <div className="hidden md:block relative z-10 pt-16 md:pt-20 px-6 md:px-12 max-w-6xl mx-auto">
           <h1 className="text-4xl md:text-5xl lg:text-6xl font-extrabold text-white leading-tight drop-shadow-lg max-w-2xl animate-fade-in-up">
             Where are you
             <br className="hidden sm:block" /> headed today?
@@ -867,14 +875,28 @@ export default function SearchPage() {
           </p>
         </div>
 
-        {/* ── Widget — absolutely positioned at bottom with margin ── */}
+        {/* ── Widget — top-aligned, normal flow on mobile; absolutely positioned at
+            bottom on desktop over the hero image. z-[35] sits above the floating
+            support chat launcher (z-30) but below the sidebar/tab bar (z-40), so it
+            never covers either. Modals opened from inside the widget (date picker
+            etc.) are portaled to <body> — see ModernDatePicker — so they aren't
+            capped by this wrapper's own stacking context. ── */}
         <div
-          className="absolute bottom-8 left-0 right-0 z-[50] px-4 md:px-6"
+          className="relative pt-4 pb-4 md:pt-0 md:pb-0 md:absolute md:bottom-8 md:left-0 md:right-0 z-[35] px-4 md:px-6"
           ref={widgetRef}
         >
           <div className="max-w-6xl mx-auto">
+            {/* Mobile-only heading — desktop keeps the version overlaid on the hero image above */}
+            <div className="md:hidden mb-3">
+              <h1 className="text-2xl font-extrabold text-gray-900 dark:text-gray-100 leading-tight">
+                Where are you headed today?
+              </h1>
+              <p className="text-sm text-gray-500 dark:text-gray-400 mt-1">
+                Book your train journey across East Africa
+              </p>
+            </div>
             <form onSubmit={handleSubmit(onSubmit, onInvalid)}>
-              <div className="bg-white dark:bg-gray-900 rounded-2xl shadow-2xl border border-white/20 overflow-visible">
+              <div className="bg-white dark:bg-gray-900 rounded-2xl shadow-none md:shadow-2xl border border-white/20 overflow-visible">
                 {error && (
                   <div className="flex items-center gap-2 px-5 py-3 bg-red-50 text-red-600 text-sm border-b border-red-100 rounded-t-2xl">
                     <span>⚠️</span>
@@ -950,6 +972,11 @@ export default function SearchPage() {
                           </span>
                         </div>
                       </button>
+                      {hasInteracted && errors.originStationId && (
+                        <p className="text-xs text-red-500">
+                          {errors.originStationId.message}
+                        </p>
+                      )}
                     </div>
                     <div className="space-y-1.5">
                       <div className="flex items-center justify-between">
@@ -998,6 +1025,11 @@ export default function SearchPage() {
                           </span>
                         </div>
                       </button>
+                      {hasInteracted && errors.destinationStationId && (
+                        <p className="text-xs text-red-500">
+                          {errors.destinationStationId.message}
+                        </p>
+                      )}
                     </div>
                     <div className="space-y-1.5">
                       <label className="text-xs font-semibold text-gray-500 uppercase tracking-wide">
@@ -1019,8 +1051,14 @@ export default function SearchPage() {
                           }}
                           minDate={new Date()}
                           placeholder="Select date"
+                          error={!!errors.departureDate}
                         />
                       </div>
+                      {errors.departureDate && (
+                        <p className="text-xs text-red-500">
+                          {errors.departureDate.message}
+                        </p>
+                      )}
                     </div>
                     {tripType === "ROUND_TRIP" && (
                       <div className="space-y-1.5">
@@ -1047,6 +1085,7 @@ export default function SearchPage() {
                                 : new Date()
                             }
                             placeholder="Select return date"
+                            error={!!errors.returnDate}
                           />
                         </div>
                         {errors.returnDate && (
@@ -1182,6 +1221,7 @@ export default function SearchPage() {
                               }}
                               minDate={new Date()}
                               placeholder="Departure"
+                              error={!!errors.departureDate}
                             />
                           </div>
                           {errors.departureDate && (
@@ -1324,6 +1364,7 @@ export default function SearchPage() {
                                 }}
                                 minDate={new Date()}
                                 placeholder="Select date"
+                                error={!!errors.departureDate}
                               />
                             </div>
                             {errors.departureDate && (
@@ -1357,6 +1398,7 @@ export default function SearchPage() {
                                     : new Date()
                                 }
                                 placeholder="Select date"
+                                error={!!errors.returnDate}
                               />
                             </div>
                             {errors.returnDate && (
diff --git a/apps/edr-passenger-web/portal/src/app/contact/page.tsx b/apps/edr-passenger-web/portal/src/app/contact/page.tsx
index f2c0f4296..669a99d0b 100644
--- a/apps/edr-passenger-web/portal/src/app/contact/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/contact/page.tsx
@@ -3,16 +3,18 @@
 import { useEffect, useState } from 'react';
 import { getTranslation, Language, useLanguage } from '@/lib/i18n';
 import { Phone, Mail, MapPin, Send, Loader } from 'lucide-react';
+import { Footer } from '@/components/Footer';
 
 const styles = `
   .contact-hero {
     padding: 60px 20px;
-    background: linear-gradient(to bottom right, rgb(20, 113, 76), transparent);
+    background: #ffffff;
     text-align: center;
     color: #111827;
   }
-  
+
   .dark .contact-hero {
+    background: #111827;
     color: #f3f4f6;
   }
   
@@ -370,6 +372,7 @@ export default function Contact() {
           </div>
         </section>
       </main>
+      <Footer />
     </>
   );
 }
diff --git a/apps/edr-passenger-web/portal/src/app/go/page.tsx b/apps/edr-passenger-web/portal/src/app/go/page.tsx
index d9f6f583f..feed05990 100644
--- a/apps/edr-passenger-web/portal/src/app/go/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/go/page.tsx
@@ -13,7 +13,7 @@ import { useSearchParams } from "next/navigation";
  * hop is browser-dependent and can be stripped) must NOT be used here.
  *
  * It fires immediately (no delay) and paints a bare white full-screen cover
- * above the sticky header (z-[60]) — no portal chrome, no text on the happy
+ * above the sidebar/tab bar (z-40) — no portal chrome, no text on the happy
  * path. A short message shows only when the link is missing/untrusted.
  *
  * `?url=` MUST be percent-encoded by the caller (Uri.encodeComponent() in the
diff --git a/apps/edr-passenger-web/portal/src/app/layout.tsx b/apps/edr-passenger-web/portal/src/app/layout.tsx
index e393b5f20..1128124e3 100644
--- a/apps/edr-passenger-web/portal/src/app/layout.tsx
+++ b/apps/edr-passenger-web/portal/src/app/layout.tsx
@@ -2,8 +2,9 @@ import type { Metadata } from 'next';
 import { headers } from 'next/headers';
 import './globals.css';
 import { Providers } from './providers';
-import AppHeader from '@/components/AppHeader';
-import { Footer } from '@/components/Footer';
+import AppSidebar from '@/components/AppSidebar';
+import MobileTopBar from '@/components/MobileTopBar';
+import BottomTabBar from '@/components/BottomTabBar';
 import { LoadingIndicator } from '@/components/LoadingIndicator';
 import SupportWidget from '@/features/support/SupportWidgetLazy';
 
@@ -21,7 +22,7 @@ export default function RootLayout({
   const nonce = headers().get('x-nonce') ?? undefined;
   return (
     <html lang="en" suppressHydrationWarning>
-      <body className="font-sans antialiased flex flex-col min-h-screen">
+      <body className="font-sans antialiased">
         <script
           nonce={nonce}
           dangerouslySetInnerHTML={{
@@ -47,11 +48,14 @@ export default function RootLayout({
         />
         <Providers>
           <LoadingIndicator />
-          <AppHeader />
-          <main className="flex-1">
-            {children}
-          </main>
-          <Footer />
+          <AppSidebar />
+          <div className="lg:pl-64 flex flex-col min-h-screen">
+            <MobileTopBar />
+            <main className="flex-1">
+              {children}
+            </main>
+            <BottomTabBar />
+          </div>
           <SupportWidget />
         </Providers>
       </body>
diff --git a/apps/edr-passenger-web/portal/src/components/AppHeader.tsx b/apps/edr-passenger-web/portal/src/components/AppHeader.tsx
deleted file mode 100644
index b1fc2ddf5..000000000
--- a/apps/edr-passenger-web/portal/src/components/AppHeader.tsx
+++ /dev/null
@@ -1,214 +0,0 @@
-"use client";
-
-import { Menu, X, Moon, Sun, HelpCircle, KeyRound, LogOut, ChevronDown } from "lucide-react";
-import Link from "next/link";
-import Image from "next/image";
-import { useEffect, useState } from "react";
-import { useAuthStore } from "@/lib/auth-store";
-import ChangePasswordModal from "@/components/ChangePasswordModal";
-
-export default function AppHeader() {
-  const [isOpen, setIsOpen] = useState(false);
-  const [isDark, setIsDark] = useState(false);
-  const [showUserMenu, setShowUserMenu] = useState(false);
-  const [showChangePassword, setShowChangePassword] = useState(false);
-  const { user, isAuthenticated, initialize, logout } = useAuthStore();
-
-  useEffect(() => {
-    const isDarkMode = document.documentElement.classList.contains("dark");
-    setIsDark(isDarkMode);
-    initialize();
-  }, [initialize]);
-
-  const toggleTheme = () => {
-    const html = document.documentElement;
-    const isDarkMode = html.classList.contains("dark");
-    if (isDarkMode) {
-      html.classList.remove("dark");
-      setIsDark(false);
-      localStorage.setItem("theme", "light");
-    } else {
-      html.classList.add("dark");
-      setIsDark(true);
-      localStorage.setItem("theme", "dark");
-    }
-  };
-
-
-
-  return (
-    <header className="sticky top-0 z-[60] bg-[rgb(20_113_76)] dark:bg-gray-900 border-b border-[rgb(16_89_60)] dark:border-gray-800 shadow-sm">
-      <div className="container mx-auto px-4">
-        <div className="max-w-6xl mx-auto">
-          <div className="flex items-center justify-between h-16">
-            {/* Logo */}
-            <Link
-              href="/"
-              className="flex items-center hover:opacity-80 transition-opacity"
-            >
-              <Image
-                src="/edr-logo.png"
-                alt="Ethio-Djibouti Railway"
-                width={140}
-                height={48}
-                className="h-14 w-auto"
-                priority
-              />
-            </Link>
-
-            {/* Desktop Menu */}
-            <div className="hidden md:flex items-center gap-8">
-              <Link
-                href="/booking/lookup"
-                className="text-sm font-medium text-gray-100 hover:text-white transition-colors"
-              >
-                My Booking
-              </Link>
-            </div>
-
-            {/* Right Actions */}
-            <div className="flex items-center gap-2">
-              {/* Help Link */}
-              <Link
-                href="/help"
-                className="hidden sm:flex items-center justify-center p-2 text-gray-100 hover:bg-white hover:bg-opacity-10 rounded-lg transition-colors"
-                title="Help & FAQ"
-              >
-                <HelpCircle className="w-5 h-5" />
-              </Link>
-
-              {/* Theme Toggler */}
-              <button
-                onClick={toggleTheme}
-                className="p-2 text-gray-100 hover:bg-white hover:bg-opacity-10 rounded-lg transition-colors"
-                title={isDark ? "Light mode" : "Dark mode"}
-              >
-                {isDark ? (
-                  <Sun className="w-5 h-5" />
-                ) : (
-                  <Moon className="w-5 h-5" />
-                )}
-              </button>
-
-              {/* Auth */}
-              {isAuthenticated && user ? (
-                <div className="relative">
-                  <button
-                    onClick={() => setShowUserMenu(!showUserMenu)}
-                    className="flex items-center gap-2 p-1.5 hover:bg-white hover:bg-opacity-10 rounded-lg transition-colors"
-                  >
-                    <div className="flex h-8 w-8 items-center justify-center rounded-full bg-white text-[rgb(20_113_76)] font-semibold text-sm">
-                      {user.fullName?.toUpperCase().charAt(0) || 'U'}
-                    </div>
-                    <ChevronDown className="hidden sm:block w-4 h-4 text-gray-100" />
-                  </button>
-
-                  {showUserMenu && (
-                    <div className="absolute right-0 top-full mt-2 w-56 z-50 rounded-lg border border-gray-200 dark:border-gray-700 bg-white dark:bg-gray-800 shadow-xl">
-                      <div className="p-3 border-b border-gray-200 dark:border-gray-700">
-                        <p className="text-sm font-medium text-gray-900 dark:text-gray-100 truncate">{user.fullName}</p>
-                        <p className="text-xs text-gray-500 dark:text-gray-400 truncate">{user.email}</p>
-                      </div>
-                      <div className="p-2">
-                        <button
-                          onClick={() => {
-                            setShowUserMenu(false);
-                            setShowChangePassword(true);
-                          }}
-                          className="flex w-full items-center gap-2 rounded-lg px-3 py-2 text-sm text-gray-700 dark:text-gray-200 hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors"
-                        >
-                          <KeyRound className="h-4 w-4" />
-                          Change Password
-                        </button>
-                        <button
-                          onClick={() => {
-                            setShowUserMenu(false);
-                            logout();
-                          }}
-                          className="flex w-full items-center gap-2 rounded-lg px-3 py-2 text-sm text-[rgb(20_113_76)] dark:text-emerald-400 hover:bg-green-50 dark:hover:bg-green-900/20 transition-colors"
-                        >
-                          <LogOut className="h-4 w-4" />
-                          Sign out
-                        </button>
-                      </div>
-                    </div>
-                  )}
-                </div>
-              ) : (
-                <div className="hidden md:flex items-center gap-2">
-                  <Link
-                    href="/login"
-                    className="px-3 py-1.5 text-sm font-medium text-gray-100 hover:bg-white hover:bg-opacity-10 rounded-lg transition-colors"
-                  >
-                    Sign in
-                  </Link>
-                  <Link
-                    href="/register"
-                    className="px-3 py-1.5 text-sm font-medium bg-white text-[rgb(20_113_76)] hover:bg-gray-100 rounded-lg transition-colors"
-                  >
-                    Register
-                  </Link>
-                </div>
-              )}
-
-              {/* Mobile Menu Button */}
-              <button
-                onClick={() => setIsOpen(!isOpen)}
-                className="md:hidden p-2 text-gray-100 hover:bg-white hover:bg-opacity-10 rounded-lg"
-              >
-                {isOpen ? (
-                  <X className="w-5 h-5" />
-                ) : (
-                  <Menu className="w-5 h-5" />
-                )}
-              </button>
-            </div>
-          </div>
-
-          {/* Mobile Menu */}
-          {isOpen && (
-            <div className="md:hidden border-t border-white border-opacity-20 dark:border-gray-700 py-4 space-y-2 animate-in slide-in-from-top-2 duration-200">
-              <Link
-                href="/booking/lookup"
-                className="block px-4 py-2 text-gray-100 dark:text-gray-300 hover:bg-white hover:bg-opacity-10 dark:hover:bg-gray-800 rounded-lg transition-colors"
-                onClick={() => setIsOpen(false)}
-              >
-                My Booking
-              </Link>
-              <Link
-                href="/help"
-                className="block px-4 py-2 text-gray-100 dark:text-gray-300 hover:bg-white hover:bg-opacity-10 dark:hover:bg-gray-800 rounded-lg transition-colors"
-                onClick={() => setIsOpen(false)}
-              >
-                Help
-              </Link>
-              {!isAuthenticated && (
-                <>
-                  <Link
-                    href="/login"
-                    className="block px-4 py-2 text-gray-100 dark:text-gray-300 hover:bg-white hover:bg-opacity-10 dark:hover:bg-gray-800 rounded-lg transition-colors"
-                    onClick={() => setIsOpen(false)}
-                  >
-                    Sign in
-                  </Link>
-                  <Link
-                    href="/register"
-                    className="block px-4 py-2 text-gray-100 dark:text-gray-300 hover:bg-white hover:bg-opacity-10 dark:hover:bg-gray-800 rounded-lg transition-colors"
-                    onClick={() => setIsOpen(false)}
-                  >
-                    Register
-                  </Link>
-                </>
-              )}
-            </div>
-          )}
-        </div>
-      </div>
-
-      <ChangePasswordModal
-        isOpen={showChangePassword}
-        onClose={() => setShowChangePassword(false)}
-      />
-    </header>
-  );
-}
diff --git a/apps/edr-passenger-web/portal/src/components/AppSidebar.tsx b/apps/edr-passenger-web/portal/src/components/AppSidebar.tsx
new file mode 100644
index 000000000..6d47b8b5a
--- /dev/null
+++ b/apps/edr-passenger-web/portal/src/components/AppSidebar.tsx
@@ -0,0 +1,212 @@
+'use client';
+
+import {
+  Home,
+  Phone,
+  Ticket,
+  HelpCircle,
+  Moon,
+  Sun,
+  KeyRound,
+  LogOut,
+  ChevronDown,
+  Check,
+} from 'lucide-react';
+import Link from 'next/link';
+import Image from 'next/image';
+import { usePathname } from 'next/navigation';
+import { useEffect, useState } from 'react';
+import { useAuthStore } from '@/lib/auth-store';
+import ChangePasswordModal from '@/components/ChangePasswordModal';
+import { BOOKING_STEPS } from '@/components/ProgressIndicator';
+
+// Mirrors booking/layout.tsx's stepMap — the linear booking flow routes that
+// get a vertical step list instead of the standard nav highlighting.
+const BOOKING_STEP_MAP: Record<string, string> = {
+  '/booking/search': 'search',
+  '/booking/results': 'results',
+  '/booking/auth-check': 'passengers',
+  '/booking/passengers': 'passengers',
+  '/booking/seats': 'seats',
+  '/booking/review': 'review',
+  '/booking/payment': 'payment',
+  '/booking/confirmation': 'confirmation',
+};
+
+const NAV_LINKS = [
+  { href: '/', label: 'Home', icon: Home },
+  { href: '/booking/lookup', label: 'My Bookings', icon: Ticket },
+  { href: '/contact', label: 'Contact', icon: Phone },
+  { href: '/help', label: 'Help', icon: HelpCircle },
+];
+
+export default function AppSidebar() {
+  const pathname = usePathname();
+  const [isDark, setIsDark] = useState(false);
+  const [showUserMenu, setShowUserMenu] = useState(false);
+  const [showChangePassword, setShowChangePassword] = useState(false);
+  const { user, isAuthenticated, initialize, logout } = useAuthStore();
+
+  useEffect(() => {
+    setIsDark(document.documentElement.classList.contains('dark'));
+    initialize();
+  }, [initialize]);
+
+  const toggleTheme = () => {
+    const html = document.documentElement;
+    const nextDark = !html.classList.contains('dark');
+    html.classList.toggle('dark', nextDark);
+    localStorage.setItem('theme', nextDark ? 'dark' : 'light');
+    setIsDark(nextDark);
+  };
+
+  const currentStepId = BOOKING_STEP_MAP[pathname ?? ''];
+  const currentStepIndex = currentStepId ? BOOKING_STEPS.findIndex((s) => s.id === currentStepId) : -1;
+
+  return (
+    <aside className="hidden lg:flex w-64 fixed inset-y-0 left-0 z-40 flex-col bg-[rgb(20_113_76)] dark:bg-gray-900 border-r border-[rgb(16_89_60)] dark:border-gray-800">
+      <Link href="/" className="flex items-center px-5 h-20 flex-shrink-0 hover:opacity-80 transition-opacity">
+        <Image
+          src="/edr-logo.png"
+          alt="Ethio-Djibouti Railway"
+          width={140}
+          height={48}
+          className="h-16 w-auto"
+          priority
+        />
+      </Link>
+
+      <nav className="flex-1 overflow-y-auto px-3 py-4 space-y-1">
+        {NAV_LINKS.map(({ href, label, icon: Icon }) => {
+          const isActive = href === '/' ? pathname === '/' : pathname?.startsWith(href);
+          return (
+            <Link
+              key={href}
+              href={href}
+              className={`flex items-center gap-3 px-3 py-2.5 rounded-lg text-sm font-medium transition-colors ${
+                isActive
+                  ? 'bg-white/15 text-white'
+                  : 'text-gray-100 hover:bg-white/10 hover:text-white'
+              }`}
+            >
+              <Icon className="w-5 h-5" />
+              {label}
+            </Link>
+          );
+        })}
+
+        {currentStepIndex >= 0 && (
+          <div className="mt-6 pt-4 border-t border-white/15">
+            <p className="px-3 pb-2 text-xs font-semibold uppercase tracking-wide text-gray-200/80">
+              Your booking
+            </p>
+            <ol className="space-y-1">
+              {BOOKING_STEPS.map((step, index) => {
+                const isComplete = index < currentStepIndex;
+                const isCurrent = index === currentStepIndex;
+                return (
+                  <li key={step.id} className="flex items-center gap-2.5 px-3 py-1.5">
+                    <span
+                      className={`flex h-5 w-5 flex-shrink-0 items-center justify-center rounded-full text-[10px] font-bold transition-colors ${
+                        isComplete
+                          ? 'bg-white text-[rgb(20,113,76)]'
+                          : isCurrent
+                            ? 'border-2 border-white text-white'
+                            : 'border border-white/30 text-white/50'
+                      }`}
+                    >
+                      {isComplete ? <Check className="w-3 h-3" /> : index + 1}
+                    </span>
+                    <span
+                      className={`text-sm ${
+                        isCurrent ? 'text-white font-semibold' : isComplete ? 'text-gray-100' : 'text-white/50'
+                      }`}
+                    >
+                      {step.name}
+                    </span>
+                  </li>
+                );
+              })}
+            </ol>
+          </div>
+        )}
+      </nav>
+
+      <div className="flex-shrink-0 border-t border-white/15 p-3 space-y-1">
+        <button
+          onClick={toggleTheme}
+          className="flex w-full items-center gap-3 px-3 py-2.5 rounded-lg text-sm font-medium text-gray-100 hover:bg-white/10 hover:text-white transition-colors"
+        >
+          {isDark ? <Sun className="w-5 h-5" /> : <Moon className="w-5 h-5" />}
+          {isDark ? 'Light mode' : 'Dark mode'}
+        </button>
+
+        {isAuthenticated && user ? (
+          <div className="relative">
+            <button
+              onClick={() => setShowUserMenu((v) => !v)}
+              className="flex w-full items-center gap-3 px-3 py-2 rounded-lg hover:bg-white/10 transition-colors"
+            >
+              <div className="flex h-8 w-8 flex-shrink-0 items-center justify-center rounded-full bg-white text-[rgb(20_113_76)] font-semibold text-sm">
+                {user.fullName?.toUpperCase().charAt(0) || 'U'}
+              </div>
+              <span className="flex-1 text-left text-sm font-medium text-white truncate">{user.fullName}</span>
+              <ChevronDown className={`w-4 h-4 text-gray-200 transition-transform ${showUserMenu ? 'rotate-180' : ''}`} />
+            </button>
+
+            {showUserMenu && (
+              <div className="absolute bottom-full left-0 mb-2 w-full rounded-lg border border-gray-200 dark:border-gray-700 bg-white dark:bg-gray-800 shadow-xl overflow-hidden">
+                <div className="p-3 border-b border-gray-200 dark:border-gray-700">
+                  <p className="text-sm font-medium text-gray-900 dark:text-gray-100 truncate">{user.fullName}</p>
+                  <p className="text-xs text-gray-500 dark:text-gray-400 truncate">{user.email}</p>
+                </div>
+                <div className="p-2">
+                  <button
+                    onClick={() => {
+                      setShowUserMenu(false);
+                      setShowChangePassword(true);
+                    }}
+                    className="flex w-full items-center gap-2 rounded-lg px-3 py-2 text-sm text-gray-700 dark:text-gray-200 hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors"
+                  >
+                    <KeyRound className="h-4 w-4" />
+                    Change Password
+                  </button>
+                  <button
+                    onClick={() => {
+                      setShowUserMenu(false);
+                      logout();
+                    }}
+                    className="flex w-full items-center gap-2 rounded-lg px-3 py-2 text-sm text-[rgb(20_113_76)] dark:text-emerald-400 hover:bg-green-50 dark:hover:bg-green-900/20 transition-colors"
+                  >
+                    <LogOut className="h-4 w-4" />
+                    Sign out
+                  </button>
+                </div>
+              </div>
+            )}
+          </div>
+        ) : (
+          <div className="flex items-center gap-2 px-1 pt-1">
+            <Link
+              href="/login"
+              className="flex-1 text-center px-3 py-2 text-sm font-medium text-gray-100 hover:bg-white/10 rounded-lg transition-colors"
+            >
+              Sign in
+            </Link>
+            <Link
+              href="/register"
+              className="flex-1 text-center px-3 py-2 text-sm font-medium bg-white text-[rgb(20_113_76)] hover:bg-gray-100 rounded-lg transition-colors"
+            >
+              Register
+            </Link>
+          </div>
+        )}
+      </div>
+
+      <ChangePasswordModal
+        isOpen={showChangePassword}
+        onClose={() => setShowChangePassword(false)}
+      />
+    </aside>
+  );
+}
diff --git a/apps/edr-passenger-web/portal/src/components/BottomTabBar.tsx b/apps/edr-passenger-web/portal/src/components/BottomTabBar.tsx
new file mode 100644
index 000000000..47bc58792
--- /dev/null
+++ b/apps/edr-passenger-web/portal/src/components/BottomTabBar.tsx
@@ -0,0 +1,69 @@
+'use client';
+
+import { Home, Phone, Ticket, User } from 'lucide-react';
+import Link from 'next/link';
+import { usePathname } from 'next/navigation';
+import { useAuthStore } from '@/lib/auth-store';
+
+// The linear, one-screen-at-a-time booking flow — each of these pages already
+// has its own sticky mobile CTA bar (and the mobile step strip at the top),
+// so the tab bar hides rather than stacking a second bottom bar underneath.
+const LINEAR_FLOW_PREFIXES = [
+  '/booking/search',
+  '/booking/results',
+  '/booking/seats',
+  '/booking/passengers',
+  '/booking/auth-check',
+  '/booking/review',
+  '/booking/payment',
+  '/booking/confirmation',
+];
+
+export default function BottomTabBar() {
+  const pathname = usePathname() ?? '';
+  const { isAuthenticated } = useAuthStore();
+
+  const isInLinearFlow = LINEAR_FLOW_PREFIXES.some((p) => pathname.startsWith(p));
+  if (isInLinearFlow) return null;
+
+  const tabs = [
+    { href: '/', label: 'Home', icon: Home, match: (p: string) => p === '/' },
+    { href: '/booking/lookup', label: 'Bookings', icon: Ticket, match: (p: string) => p.startsWith('/booking/lookup') || p.startsWith('/booking/detail') },
+    { href: '/contact', label: 'Contact', icon: Phone, match: (p: string) => p.startsWith('/contact') },
+    {
+      href: isAuthenticated ? '/profile' : '/login',
+      label: isAuthenticated ? 'Account' : 'Sign in',
+      icon: User,
+      match: (p: string) => p.startsWith('/profile') || p.startsWith('/login') || p.startsWith('/register'),
+    },
+  ];
+
+  return (
+    <>
+      {/* In-flow spacer so page content/Footer can't end up hidden behind the
+          fixed bar below — self-contained here so it only exists when the
+          bar itself is actually rendered. */}
+      <div className="lg:hidden h-16" aria-hidden="true" />
+      <nav className="lg:hidden fixed bottom-0 inset-x-0 z-40 bg-white dark:bg-gray-900 border-t border-gray-200 dark:border-gray-800 shadow-[0_-2px_10px_rgba(0,0,0,0.05)]">
+        <ul className="flex items-stretch">
+          {tabs.map(({ href, label, icon: Icon, match }) => {
+            const isActive = match(pathname);
+            return (
+              <li key={href} className="flex-1">
+                <Link
+                  href={href}
+                  className={`flex flex-col items-center justify-center gap-0.5 py-2.5 text-[11px] font-medium transition-colors ${
+                    isActive ? 'text-primary' : 'text-gray-500 dark:text-gray-400'
+                  }`}
+                >
+                  <Icon className={`w-5 h-5 ${isActive ? 'text-primary' : ''}`} strokeWidth={isActive ? 2.5 : 2} />
+                  {label}
+                </Link>
+              </li>
+            );
+          })}
+        </ul>
+      </nav>
+    </>
+  );
+}
diff --git a/apps/edr-passenger-web/portal/src/components/LandingNav.tsx b/apps/edr-passenger-web/portal/src/components/LandingNav.tsx
deleted file mode 100644
index 76d5fabb9..000000000
--- a/apps/edr-passenger-web/portal/src/components/LandingNav.tsx
+++ /dev/null
@@ -1,163 +0,0 @@
-'use client';
-
-import { Train, Menu, X, Moon, Sun, HelpCircle } from 'lucide-react';
-import Link from 'next/link';
-import { useState, useEffect } from 'react';
-import { LanguageSwitcher } from './LanguageSwitcher';
-import { getTranslation, Language } from '@/lib/i18n';
-import { useLanguage } from '@/lib/i18n';
-
-export function LandingNav() {
-  const [isOpen, setIsOpen] = useState(false);
-  const [lang, setLang] = useState<Language>('en');
-  const [isDark, setIsDark] = useState(false);
-  const [mounted, setMounted] = useState(false);
-  const { getLang } = useLanguage();
-  const t = (key: string) => getTranslation(lang, key);
-
-  useEffect(() => {
-    setMounted(true);
-    setLang(getLang());
-    const handleLanguageChange = (e: any) => setLang(e.detail);
-    window.addEventListener('languageChange', handleLanguageChange);
-    return () => window.removeEventListener('languageChange', handleLanguageChange);
-  }, [getLang]);
-
-  useEffect(() => {
-    const isDarkMode = document.documentElement.classList.contains('dark');
-    setIsDark(isDarkMode);
-  }, []);
-
-  const toggleTheme = () => {
-    const html = document.documentElement;
-    const isDarkMode = html.classList.contains('dark');
-    if (isDarkMode) {
-      html.classList.remove('dark');
-      setIsDark(false);
-      localStorage.setItem('theme', 'light');
-    } else {
-      html.classList.add('dark');
-      setIsDark(true);
-      localStorage.setItem('theme', 'dark');
-    }
-  };
-
-  const menuItems = [
-    { label: t('nav.home'), href: '/' },
-    { label: t('nav.services'), href: '/services' },
-    { label: t('nav.about'), href: '/about' },
-    { label: t('nav.contact'), href: '/contact' },
-  ];
-
-  if (!mounted) return null;
-
-  return (
-    <nav className="sticky top-0 z-40 bg-[rgb(20_113_76)] border-b border-[rgb(16_89_60)] shadow-sm">
-      <div className="container mx-auto px-4">
-        <div className="max-w-6xl mx-auto">
-          <div className="flex items-center justify-between h-16">
-            {/* Logo */}
-            <Link href="/" className="flex items-center gap-3 hover:opacity-80 transition-opacity">
-              <div className="w-10 h-10 bg-white rounded-lg flex items-center justify-center">
-                <Train className="w-6 h-6 text-[rgb(20_113_76)]" />
-              </div>
-              <div>
-                <h1 className="text-lg font-bold text-white">
-                  Ethio-Djibouti Railway
-                </h1>
-                <p className="text-xs text-gray-100">
-                  Book your train journey with us
-                </p>
-              </div>
-            </Link>
-
-            {/* Desktop Menu */}
-            <div className="hidden md:flex items-center gap-8">
-              {menuItems.map((item) => (
-                <Link
-                  key={item.href}
-                  href={item.href}
-                  className="text-sm font-medium text-gray-100 hover:text-white transition-colors"
-                >
-                  {item.label}
-                </Link>
-              ))}
-            </div>
-
-            {/* Right Actions */}
-            <div className="flex items-center gap-3">
-              <LanguageSwitcher />
-              
-              {/* Help Link */}
-              <Link
-                href="/help"
-                className="hidden sm:flex items-center gap-1.5 px-3 py-2 text-gray-100 hover:bg-white hover:bg-opacity-10 rounded-lg transition-colors"
-                title="Help & FAQ"
-              >
-                <HelpCircle className="w-5 h-5" />
-              </Link>
-
-              {/* Theme Toggler */}
-              <button
-                onClick={toggleTheme}
-                className="p-2 text-gray-100 hover:bg-white hover:bg-opacity-10 rounded-lg transition-colors"
-                title={isDark ? 'Light mode' : 'Dark mode'}
-              >
-                {isDark ? (
-                  <Sun className="w-5 h-5" />
-                ) : (
-                  <Moon className="w-5 h-5" />
-                )}
-              </button>
-
-              <Link
-                href="/booking/search"
-                className="hidden sm:block px-4 py-2 bg-white text-[rgb(20_113_76)] text-sm font-medium rounded-lg transition-all duration-200 transform hover:scale-105 hover:bg-gray-100"
-              >
-                {t('nav.bookNow')}
-              </Link>
-
-              {/* Mobile Menu Button */}
-              <button
-                onClick={() => setIsOpen(!isOpen)}
-                className="md:hidden p-2 text-gray-100 hover:bg-white hover:bg-opacity-10 rounded-lg"
-              >
-                {isOpen ? <X className="w-5 h-5" /> : <Menu className="w-5 h-5" />}
-              </button>
-            </div>
-          </div>
-
-          {/* Mobile Menu */}
-          {isOpen && (
-            <div className="md:hidden border-t border-white border-opacity-20 py-4 space-y-2 animate-in slide-in-from-top-2 duration-200">
-              {menuItems.map((item) => (
-                <Link
-                  key={item.href}
-                  href={item.href}
-                  className="block px-4 py-2 text-gray-100 hover:bg-white hover:bg-opacity-10 rounded-lg transition-colors"
-                  onClick={() => setIsOpen(false)}
-                >
-                  {item.label}
-                </Link>
-              ))}
-              <Link
-                href="/help"
-                className="block px-4 py-2 text-gray-100 hover:bg-white hover:bg-opacity-10 rounded-lg transition-colors"
-                onClick={() => setIsOpen(false)}
-              >
-                {t('nav.help')}
-              </Link>
-              <Link
-                href="/booking/search"
-                className="block px-4 py-2 bg-white text-[rgb(20_113_76)] font-medium rounded-lg transition-colors hover:bg-gray-100"
-                onClick={() => setIsOpen(false)}
-              >
-                {t('nav.bookNow')}
-              </Link>
-            </div>
-          )}
-        </div>
-      </div>
-    </nav>
-  );
-}
diff --git a/apps/edr-passenger-web/portal/src/components/MobileTopBar.tsx b/apps/edr-passenger-web/portal/src/components/MobileTopBar.tsx
new file mode 100644
index 000000000..8920b2e80
--- /dev/null
+++ b/apps/edr-passenger-web/portal/src/components/MobileTopBar.tsx
@@ -0,0 +1,24 @@
+import Link from 'next/link';
+import Image from 'next/image';
+
+// AppSidebar (which carries the logo) is `hidden lg:flex` — invisible on
+// mobile, so mobile pages had no branding/way back to home at all. This is
+// the mobile-only equivalent: a slim bar with just the logo. Deliberately
+// not sticky — it scrolls away with the page content instead of staying
+// pinned to the top.
+export default function MobileTopBar() {
+  return (
+    <div className="lg:hidden relative bg-[rgb(20_113_76)] dark:bg-gray-900 border-b border-[rgb(16_89_60)] dark:border-gray-800 px-4 h-16 flex items-center flex-shrink-0">
+      <Link href="/" className="flex items-center hover:opacity-80 transition-opacity" aria-label="Go to home">
+        <Image
+          src="/edr-logo.png"
+          alt="Ethio-Djibouti Railway"
+          width={140}
+          height={48}
+          className="h-14 w-auto"
+          priority
+        />
+      </Link>
+    </div>
+  );
+}
diff --git a/apps/edr-passenger-web/portal/src/components/ModernDatePicker.tsx b/apps/edr-passenger-web/portal/src/components/ModernDatePicker.tsx
index 1f0bbddfe..674755516 100644
--- a/apps/edr-passenger-web/portal/src/components/ModernDatePicker.tsx
+++ b/apps/edr-passenger-web/portal/src/components/ModernDatePicker.tsx
@@ -1,6 +1,7 @@
 'use client';
 
 import { useState, useEffect, useRef } from 'react';
+import { createPortal } from 'react-dom';
 import { ChevronLeft, ChevronRight, Calendar as CalendarIcon, Globe, X } from 'lucide-react';
 import {
   gregorianToEthiopian,
@@ -18,6 +19,7 @@ interface ModernDatePickerProps {
   minDate?: Date;
   maxDate?: Date;
   placeholder?: string;
+  error?: boolean;
 }
 
 export default function ModernDatePicker({
@@ -26,6 +28,7 @@ export default function ModernDatePicker({
   minDate,
   maxDate,
   placeholder = 'Select date',
+  error = false,
 }: ModernDatePickerProps) {
   const [isOpen, setIsOpen] = useState(false);
   const [isMobileView, setIsMobileView] = useState(false);
@@ -283,7 +286,11 @@ export default function ModernDatePicker({
       <button
         type="button"
         onClick={() => setIsOpen(true)}
-        className="w-full px-3.5 py-3.5 border-2 border-gray-200 dark:border-gray-700 rounded-xl focus:outline-none focus:ring-2 focus:ring-primary/30 focus:border-primary text-left flex items-center justify-between bg-white dark:bg-gray-800 hover:border-gray-300 dark:hover:border-gray-600 transition-all group"
+        className={`w-full px-3.5 py-3.5 border-2 rounded-xl focus:outline-none focus:ring-2 focus:ring-primary/30 focus:border-primary text-left flex items-center justify-between bg-white dark:bg-gray-800 transition-all group ${
+          error
+            ? 'border-red-400 hover:border-red-400'
+            : 'border-gray-200 dark:border-gray-700 hover:border-gray-300 dark:hover:border-gray-600'
+        }`}
       >
         <span className={`text-sm ${value ? 'text-gray-900 dark:text-gray-100 font-medium' : 'text-gray-400'}`}>
           {value ? format(value, 'EEE, MMM d, yyyy') : placeholder}
@@ -291,7 +298,7 @@ export default function ModernDatePicker({
         <CalendarIcon className="w-4 h-4 text-gray-400 group-hover:text-primary transition-colors flex-shrink-0" />
       </button>
 
-      {isOpen && (
+      {isOpen && createPortal(
         <>
 
           {/* Mobile: full-screen takeover */}
@@ -329,7 +336,8 @@ export default function ModernDatePicker({
               to   { transform: scale(1);    opacity: 1; }
             }
           `}</style>
-        </>
+        </>,
+        document.body
       )}
     </div>
   );
diff --git a/apps/edr-passenger-web/portal/src/components/ProgressIndicator.tsx b/apps/edr-passenger-web/portal/src/components/ProgressIndicator.tsx
index 9d0215c3a..40f80d448 100644
--- a/apps/edr-passenger-web/portal/src/components/ProgressIndicator.tsx
+++ b/apps/edr-passenger-web/portal/src/components/ProgressIndicator.tsx
@@ -3,7 +3,9 @@
 import { Check } from 'lucide-react';
 import { useEffect, useRef } from 'react';
 
-const steps = [
+// Shared source of truth for the booking flow's step order/labels — also
+// consumed by AppSidebar's vertical step list on desktop.
+export const BOOKING_STEPS = [
   { id: 'search',       name: 'Search' },
   { id: 'results',      name: 'Results' },
   { id: 'passengers',   name: 'Passengers' },
@@ -12,6 +14,7 @@ const steps = [
   { id: 'payment',      name: 'Payment' },
   { id: 'confirmation', name: 'Done' },
 ];
+const steps = BOOKING_STEPS;
 
 export function ProgressIndicator({ currentStep }: { currentStep: string }) {
   const currentIndex = steps.findIndex((s) => s.id === currentStep);
@@ -70,24 +73,18 @@ export function ProgressIndicator({ currentStep }: { currentStep: string }) {
     );
   };
 
+  // Desktop shows the vertical step list embedded in AppSidebar instead —
+  // this component is mobile-only now (the sidebar doesn't exist below lg).
   return (
-    <nav aria-label="Progress">
-      {/* Mobile: full-bleed scrollable */}
+    <nav aria-label="Progress" className="lg:hidden">
       <div
         ref={scrollRef}
-        className="md:hidden overflow-x-auto scrollbar-hide px-4 py-3"
+        className="overflow-x-auto scrollbar-hide px-4 py-3"
       >
         <ol className="flex items-start min-w-full">
           {steps.map((s, i) => stepItem(s, i))}
         </ol>
       </div>
-
-      {/* Desktop: full container width matching header/footer */}
-      <div className="hidden md:block container mx-auto px-4 py-4">
-        <ol className="flex items-start max-w-6xl mx-auto">
-          {steps.map((s, i) => stepItem(s, i))}
-        </ol>
-      </div>
     </nav>
   );
 }

From c53c1868967be380ccc3a140672a82c8b8d2667b Mon Sep 17 00:00:00 2001
From: Hagernesh <hagernesh@example.com>
Date: Thu, 9 Jul 2026 15:11:13 +0000
Subject: [PATCH 20/25] Approve delivery and notification fix

---
 .claude/skills/edr-db/SKILL.md      |  42 ++++
 .claude/skills/edr-db/query.cjs     |  88 +++++++++
 .claude/skills/standup/SKILL.md     |  40 ++++
 .claude/skills/verify/SKILL.md      |  59 ++++++
 CLAUDE_NEW.md                       | 294 ++++++++++++++++++++++++++++
 docs/qa/edr-freight-qa-test-plan.md | 292 +++++++++++++++++++++++++++
 6 files changed, 815 insertions(+)
 create mode 100644 .claude/skills/edr-db/SKILL.md
 create mode 100644 .claude/skills/edr-db/query.cjs
 create mode 100644 .claude/skills/standup/SKILL.md
 create mode 100644 .claude/skills/verify/SKILL.md
 create mode 100644 CLAUDE_NEW.md
 create mode 100644 docs/qa/edr-freight-qa-test-plan.md

diff --git a/.claude/skills/edr-db/SKILL.md b/.claude/skills/edr-db/SKILL.md
new file mode 100644
index 000000000..47333128d
--- /dev/null
+++ b/.claude/skills/edr-db/SKILL.md
@@ -0,0 +1,42 @@
+---
+name: edr-db
+description: Query, EXPLAIN-validate, and inspect the remote EDR freight dev database. Use whenever you need to check data, verify a raw SQL statement before shipping it, list a table's columns, check schema drift, or see which migrations are recorded. psql is NOT installed on this machine — this runner is the sanctioned path. Triggers - "check the db", "query edr_dev", "does column X exist", "validate this SQL", "is migration recorded", "seed check", diagnosing a 400/500 whose cause may be data or schema.
+---
+
+# EDR dev-DB runner
+
+One script, runs from anywhere in the repo (resolves `pg` from `apps/edr-freight-api`):
+
+```bash
+node .claude/skills/edr-db/query.cjs "SELECT ... "         # run SQL, console.table output
+node .claude/skills/edr-db/query.cjs explain "SELECT ..."  # EXPLAIN-validate only (no rows touched)
+node .claude/skills/edr-db/query.cjs columns <table>       # freight.<table> column list
+node .claude/skills/edr-db/query.cjs migrations [like]     # public.migrations rows (newest first)
+node .claude/skills/edr-db/query.cjs drift <table>         # bare column names, for diffing vs the entity
+```
+
+Connection comes from `DB_HOST` / `DB_PORT` / `DB_USER` / `DB_PASSWORD` / `DB_NAME`,
+defaulting to the shared dev database (`edr_dev`).
+
+## Rules that go with it
+
+- **HARD RULE: every raw SQL statement you write into a service must pass
+  `explain` here before you ship it.** A typo'd column is a runtime 500 the
+  type-checker cannot catch.
+- Never assume a recorded migration applied — check `migrations <name>` **and**
+  `columns <table>` together. Recorded-but-absent = schema drift; fix with a
+  NEW repair migration (idempotent DDL, no-op `down()`), never by editing the
+  recorded one.
+- Writes to dev data are fine for seeding/diagnosis but keep them idempotent
+  (`WHERE NOT EXISTS` guards) — watch-mode API instances race `migrationsRun`,
+  and non-idempotent statements have double-run here before.
+- Timestamps for new migrations: must be unique across `src/migrations/` AND
+  higher than `SELECT max(timestamp) FROM public.migrations`.
+
+## Diagnosing a pasted 400/500 (the recurring loop)
+
+1. Find the route: grep the path segment in `apps/edr-freight-api/src/modules/*/**.controller.ts`.
+2. Read the service method — list its guard `throw`s. Most "bugs" are a guard
+   working as designed (handover unsigned, fee unpaid, not PAID, wrong direction).
+3. Check the actual DB state for that record with this runner.
+4. Only then decide: guard doing its job (fix the UI affordance) vs real defect.
diff --git a/.claude/skills/edr-db/query.cjs b/.claude/skills/edr-db/query.cjs
new file mode 100644
index 000000000..b4797bd45
--- /dev/null
+++ b/.claude/skills/edr-db/query.cjs
@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+/**
+ * Dev-DB runner for the EDR freight database. psql is NOT installed on this
+ * machine; this is the sanctioned way to query, EXPLAIN-validate, and inspect
+ * the remote dev DB. Resolves `pg` from apps/edr-freight-api so it runs from
+ * anywhere in the repo.
+ *
+ *   node .claude/skills/edr-db/query.cjs "SELECT ... "        run SQL (console.table)
+ *   node .claude/skills/edr-db/query.cjs explain "SELECT..."  EXPLAIN-validate only
+ *   node .claude/skills/edr-db/query.cjs columns <table>      list freight.<table> columns
+ *   node .claude/skills/edr-db/query.cjs migrations [like]    public.migrations rows
+ *   node .claude/skills/edr-db/query.cjs drift <table>        columns vs entity check helper
+ *
+ * Connection: DB_HOST/DB_PORT/DB_USER/DB_PASSWORD/DB_NAME env vars, falling
+ * back to the shared dev database.
+ */
+const path = require('path');
+const { createRequire } = require('module');
+
+const repoRoot = path.resolve(__dirname, '..', '..', '..');
+const apiRequire = createRequire(
+  path.join(repoRoot, 'apps', 'edr-freight-api', 'package.json'),
+);
+const { Client } = apiRequire('pg');
+
+const cfg = {
+  host: process.env.DB_HOST ?? '10.18.7.207',
+  port: parseInt(process.env.DB_PORT ?? '5432', 10),
+  user: process.env.DB_USER ?? 'postgres',
+  password: process.env.DB_PASSWORD ?? 'dcba@1234',
+  database: process.env.DB_NAME ?? 'edr_dev',
+};
+
+const [, , first, ...rest] = process.argv;
+
+async function main() {
+  if (!first) {
+    console.error('usage: query.cjs "<sql>" | explain "<sql>" | columns <table> | migrations [like] | drift <table>');
+    process.exit(2);
+  }
+  const c = new Client(cfg);
+  await c.connect();
+  try {
+    if (first === 'columns') {
+      const r = await c.query(
+        `SELECT column_name, data_type, is_nullable, column_default
+           FROM information_schema.columns
+          WHERE table_schema='freight' AND table_name=$1
+          ORDER BY ordinal_position`,
+        [rest[0]],
+      );
+      console.table(r.rows);
+    } else if (first === 'migrations') {
+      const like = rest[0] ? `%${rest[0]}%` : '%';
+      const r = await c.query(
+        `SELECT id, timestamp, name FROM public.migrations
+          WHERE name ILIKE $1 ORDER BY id DESC LIMIT 40`,
+        [like],
+      );
+      console.table(r.rows);
+    } else if (first === 'drift') {
+      // Quick drift signal: DB columns for the table. Compare by eye against
+      // the entity's @Column names; a recorded-but-absent column = drift.
+      const r = await c.query(
+        `SELECT column_name FROM information_schema.columns
+          WHERE table_schema='freight' AND table_name=$1 ORDER BY column_name`,
+        [rest[0]],
+      );
+      console.log(r.rows.map((x) => x.column_name).join('\n'));
+    } else if (first === 'explain') {
+      await c.query('EXPLAIN ' + rest.join(' '));
+      console.log('OK — statement is valid against', cfg.database);
+    } else {
+      const sql = [first, ...rest].join(' ');
+      const started = Date.now();
+      const r = await c.query(sql);
+      if (Array.isArray(r.rows) && r.rows.length) console.table(r.rows);
+      console.log(`${r.rowCount ?? 0} row(s), ${Date.now() - started}ms`);
+    }
+  } finally {
+    await c.end();
+  }
+}
+
+main().catch((e) => {
+  console.error('FAIL:', e.message);
+  process.exit(1);
+});
diff --git a/.claude/skills/standup/SKILL.md b/.claude/skills/standup/SKILL.md
new file mode 100644
index 000000000..272f280e7
--- /dev/null
+++ b/.claude/skills/standup/SKILL.md
@@ -0,0 +1,40 @@
+---
+name: standup
+description: Produce the work report Hagernesh asks for - "what have I done today", "tasks of yesterday and today", daily/period summaries for tickets or timesheets. Builds the answer from git history plus uncommitted work, never from memory alone.
+---
+
+# Work report (standup / ticket summary)
+
+Ground every line in git. Do not reconstruct from conversation memory — commits
+are the record.
+
+## Gather
+
+```bash
+# Commits in the window (adjust dates; author matches "Hagernesh")
+git log --since="YYYY-MM-DD 00:00" --until="YYYY-MM-DD 00:00" --author=Hagernesh \
+  --pretty=format:"%h|%ad|%s" --date=short
+
+# What each commit actually contains (subjects lie sometimes)
+git show --stat --pretty=format:"%s" <hash> | head -12
+
+# In-flight work = part of "today" even if uncommitted
+git status --short
+git log origin/dev..HEAD --oneline     # branch commits not yet in dev
+```
+
+## Known pitfalls in this repo
+
+- **Check subjects against contents.** Commit titles here sometimes mismatch the
+  diff (e.g. a commit titled "unload export" that actually contained ISO
+  container validation). Use `git show --stat` before reporting a title as fact.
+- A day with no commits usually still has uncommitted/in-flight work — report it
+  as its own section with per-item status (done / uncommitted / blocked).
+- Merge commits from other authors are noise; filter with `--author`.
+
+## Output format
+
+One table per day: `# | Task (plain language, not the commit subject verbatim) |
+Commit / Status`. Follow with a short "carry-over / blocked" list naming what
+blocks each item. Keep it ticket-ready: no jargon that needs the repo open to
+decode.
diff --git a/.claude/skills/verify/SKILL.md b/.claude/skills/verify/SKILL.md
new file mode 100644
index 000000000..a2c715db4
--- /dev/null
+++ b/.claude/skills/verify/SKILL.md
@@ -0,0 +1,59 @@
+---
+name: verify
+description: Project definition-of-done runner for the EDR platform. Use before calling any code change finished, before committing, and whenever asked "is it done / does it work". Runs the targeted checks that actually catch this repo's failure modes - type-check with turbo filters, @edr/types dist rebuild, raw-SQL EXPLAIN validation, migration safety, and honest test reporting.
+---
+
+# Verify a change (EDR definition of done)
+
+Run these in order. Report which you ran and what each said — never call
+unverified work done.
+
+## 1. Type-check exactly what you touched
+
+```bash
+pnpm turbo type-check --filter=@edr/freight-api --filter=@edr/freight-backoffice --filter=@edr/freight-portal
+```
+
+Drop filters you didn't touch; whole-repo runs waste minutes. **If you edited
+`packages/types`, rebuild it FIRST** — consumers read its `dist/`, not `src/`:
+
+```bash
+pnpm turbo build --filter=@edr/types
+```
+
+## 2. Validate every raw SQL statement
+
+Each new/edited `dataSource.query` / `manager.query` string must pass:
+
+```bash
+node .claude/skills/edr-db/query.cjs explain "<the statement with dummy params>"
+```
+
+## 3. Migration checklist (if you added one)
+
+- Timestamp unique in `src/migrations/` **and** greater than
+  `node .claude/skills/edr-db/query.cjs "SELECT max(timestamp) FROM public.migrations"`.
+- DDL idempotent (`IF NOT EXISTS`, guarded backfills).
+- Watch-mode reload does NOT run migrations — apply the SQL to the dev DB
+  yourself or fully restart the API, then confirm with
+  `query.cjs columns <table>`.
+
+## 4. Tests — honest bar
+
+`pnpm test` for `@edr/freight-api` is currently red on `dev`, so a green suite
+is not the bar. The bar: run the specs nearest what you touched and introduce
+**no new failure**. If you touched a service constructor, update its `.spec.ts`
+mocks (constructor-arity breaks are this repo's most common test regression).
+
+## 5. Observe the behaviour
+
+Compiling is not working. Hit the endpoint, drive the UI flow, or query the
+resulting rows. If you genuinely could not observe it, say so explicitly in the
+summary — do not imply it was seen working.
+
+## 6. Before commit
+
+- Conventional message (`fix(warehouses): …`). Git hooks do NOT run in this
+  repo (husky shims exist but no user hooks) — nothing will catch it for you.
+- Lint the files you touched if in doubt: `pnpm turbo lint --filter=<pkg>`.
+- Do not commit or push unless the user asked.
diff --git a/CLAUDE_NEW.md b/CLAUDE_NEW.md
new file mode 100644
index 000000000..11075e9f0
--- /dev/null
+++ b/CLAUDE_NEW.md
@@ -0,0 +1,294 @@
+# EDR Platform — Developer Guide
+
+> This file is the contract. If something here contradicts the code, the code is the
+> truth and this file is a bug — fix it in the same PR.
+
+## Overview
+
+Monorepo for the Ethio Djibouti Railway (EDR) digital platform. Contains the Freight
+Management and Passenger Management applications, a payment microservice, plus shared
+types, NestJS utilities, and React component libraries.
+
+The freight domain is the largest and most active area. Its core flow is:
+**booking → receive to warehouse → store → load onto train → dispatch → arrive → unload
+→ customer truck (self-haul) or EDR last mile → handover → exit paper → delivered.**
+Fees (storage, demurrage, double handling, truck detention) and allocation rules
+(warehouse/yard/zone) hang off the warehouse stage.
+
+## Apps
+
+| App                            | Package name                | Purpose                                            | Default port |
+| ------------------------------ | --------------------------- | -------------------------------------------------- | ------------ |
+| `edr-freight-api`              | `@edr/freight-api`          | NestJS API for freight management                  | 3001 |
+| `edr-freight-web/portal`       | `@edr/freight-portal`       | React frontend for freight customer/portal users   | 5173 |
+| `edr-freight-web/backoffice`   | `@edr/freight-backoffice`   | React frontend for freight backoffice employees    | 5183 |
+| `edr-passenger-api`            | `@edr/passenger-api`        | NestJS API for passenger management                | 3002 |
+| `edr-payment-api`              | `@edr/payment-api`          | NestJS payment microservice (intents, webhooks)    | 3003 |
+| `edr-passenger-web/portal`     | `@edr/passenger-portal`     | React frontend for passenger customer/portal users | 5174 |
+| `edr-passenger-web/backoffice` | `@edr/passenger-backoffice` | React frontend for passenger backoffice employees  | 5184 |
+
+`edr-freight-web` and `edr-passenger-web` are grouping folders, not workspace packages.
+Each holds a `portal/` and `backoffice/` sub-app, both independent pnpm workspace
+packages (see `pnpm-workspace.yaml`).
+
+`apps/edr-landing/` exists on disk but has **no `package.json`** — it is not a workspace
+package and is not built, linted, or type-checked. Leave it alone unless asked.
+
+## Packages
+
+| Package                | Purpose                                                                            |
+| ---------------------- | ---------------------------------------------------------------------------------- |
+| `@edr/types`           | Shared TypeScript interfaces and enums                                             |
+| `@edr/api-common`      | Shared NestJS decorators, filters, interceptors, pipes, BaseEntity, BaseRepository |
+| `@edr/ui-common`       | Shared React components and theme                                                  |
+| `@edr/eslint-config`   | Shared ESLint configurations (base/nestjs/react)                                   |
+| `@edr/tsconfig`        | Shared TypeScript configurations                                                   |
+| `@edr/prettier-config` | Shared Prettier configuration                                                      |
+
+**`@edr/types` is consumed as its built `dist/`** (`main: ./dist/index.js`). Editing a
+type in `packages/types/src` changes nothing for consumers until you rebuild:
+
+```bash
+pnpm turbo build --filter=@edr/types
+```
+
+If a type-check fails on a field you just added to `@edr/types`, this is why.
+
+## Commands
+
+| Command                     | Description                              |
+| --------------------------- | ---------------------------------------- |
+| `pnpm install`              | Install all workspace dependencies        |
+| `pnpm dev`                  | Run every app in dev mode                 |
+| `pnpm dev:freight`          | Freight API + portal + backoffice         |
+| `pnpm dev:freight:api`      | Freight API only                          |
+| `pnpm dev:freight:portal`   | Freight portal only                       |
+| `pnpm dev:freight:backoffice` | Freight backoffice only                 |
+| `pnpm dev:passenger`        | Passenger API + web                       |
+| `pnpm dev:payment`          | Payment API                               |
+| `pnpm build`                | Build every package and app               |
+| `pnpm test`                 | Run all tests (turbo)                     |
+| `pnpm lint`                 | Lint everything                           |
+| `pnpm type-check`           | Type-check every package                  |
+| `pnpm format`               | Format all files with Prettier            |
+
+Prefer targeted turbo filters over whole-repo runs — they are minutes faster:
+
+```bash
+pnpm turbo type-check --filter=@edr/freight-api --filter=@edr/freight-backoffice
+```
+
+`apps/edr-freight-api` also carries many `seed:*` scripts (demo bookings, wagons, trains,
+gate-pass scenarios). Read the script before running one; several write real rows.
+
+## Environment & database
+
+- Postgres is **external**. There is no postgres service in `docker-compose.yaml`, and
+  no port `5433`/`5434` is published anywhere in the repo.
+- Freight API connection comes from `DB_HOST`, `DB_PORT`, `DB_USER`, `DB_PASSWORD`,
+  `DB_NAME` (defaults: `localhost:5433`, `edr_freight`). Development points these at a
+  remote database.
+- The connection sits behind a **connection pooler**. Do **not** pass
+  `extra.options: '-c search_path=…'` — the pooler rejects it with
+  `08P01 unsupported startup parameter in options: search_path`. `search_path` is applied
+  per-connection in a pool `connect` handler instead. See
+  `apps/edr-freight-api/src/config/database.config.ts` before touching connection options.
+- Each app owns its own database. **No cross-database joins**; cross-domain data flows
+  through API calls or message queues.
+- `psql` is not installed on the dev machine. To query the database, write a short Node
+  script using the `pg` client and run it from `apps/edr-freight-api` (where `pg` resolves).
+
+## Hard rules
+
+These are non-negotiable. Everything else is a strong default.
+
+- **pnpm only.** Never run `npm install` or `yarn`.
+- **TypeScript strict mode** is on in every package and app. Do not weaken it, and do not
+  reach for `any` to make an error go away.
+- **Never `synchronize: true`.** Not in production, not anywhere. It is currently `false`
+  in every config and it has already corrupted this database twice (see *Migrations*).
+  All schema changes go through TypeORM migrations.
+- **All entities** use UUID primary keys (`@PrimaryGeneratedColumn('uuid')`).
+- **All entities** extend `BaseEntity` from `@edr/api-common` — `createdAt`, `updatedAt`,
+  `deletedAt` (soft delete).
+- **All columns** are `snake_case` in the database (`@Column({ name: 'snake_case' })`);
+  TypeScript properties are `camelCase`.
+- **Controllers contain no business logic.** They validate, delegate, and shape the response.
+- **Conventional commits.** `fix(warehouses): …`, `feat(bookings): …`.
+- **Do not commit or push unless asked.** Propose the change; let the human decide when it lands.
+- **Do not break working behaviour to add new behaviour.** When a fix is risky, say so and
+  offer the safe version.
+
+## Architecture
+
+### NestJS module shape
+
+`module → controller → service → repository`, with `entities/` and `dto/` alongside.
+
+### Data access — the real model
+
+There are two sanctioned ways to read and write, and you must pick the right one:
+
+1. **Entity CRUD → the custom repository class.** Extends `BaseRepository<Entity>` from
+   `@edr/api-common`. Services inject the repository class, never `Repository<T>` directly.
+2. **Read projections, queue endpoints, cross-table reports → raw SQL** via
+   `this.dataSource.query(...)` or `manager.query(...)` inside a transaction.
+
+Raw SQL is normal here, not a smell — the warehouse and scheduling modules are built on it.
+It carries one obligation:
+
+> **HARD RULE — validate every raw SQL statement against a real database before you ship it.**
+> A typo'd column name is a runtime 500 that no type-checker will catch. Run it through
+> `EXPLAIN` against the dev database. Column drift is real (see *Migrations*).
+
+Writes inside a transaction use `manager.getRepository(Entity)`, not the injected repository,
+so they join the caller's transaction.
+
+**Never do slow I/O inside a database transaction.** Queue the work and fan it out after
+commit. An SMS awaited inside a transaction once held capacity locks open for the whole
+gateway timeout. Any outbound HTTP call must set an explicit `timeout` — axios defaults to
+no timeout and will wait forever.
+
+### Migrations
+
+Migrations are the most dangerous surface in this repo. Two production-grade incidents have
+already come from it.
+
+- `migrationsRun: true` — **migrations run automatically on API boot**, with
+  `migrationsTransactionMode: 'each'`.
+- Consequences you must design for:
+  - Running several `nest start --watch` instances races `migrationsRun`. A non-idempotent
+    data migration can execute twice. Keep one instance.
+  - A watch-mode hot reload does **not** re-run migrations. If you add a column that new
+    code reads, apply it to the dev database yourself (idempotently) or fully restart.
+- **Give every migration a unique timestamp.** 34 timestamps are currently shared by two or
+  more migrations. TypeORM orders by timestamp and breaks ties non-deterministically. Before
+  adding one, check the filename prefix is unused *and* higher than the newest recorded row.
+- **Write idempotent DDL**: `ADD COLUMN IF NOT EXISTS`, `CREATE INDEX IF NOT EXISTS`, and
+  backfills guarded by `WHERE col IS NULL`.
+- **Never assume a recorded migration actually applied.** `AddGrnNumberToWarehouseInventory`
+  was recorded in `migrations` while its column was absent — it had been dropped out of band.
+  TypeORM will never re-run a recorded migration, so the fix is a *new repair migration*.
+- **A repair migration's `down()` should be a no-op.** Reverting a repair must not
+  re-introduce the outage it fixed.
+
+### Auth
+
+Auth **is implemented in this repo.** Do not add TODO stubs, and do not write your own.
+
+- `@CurrentUser()` (`@edr/api-common`) is a real `createParamDecorator`, not a metadata stub.
+- Route protection uses `@UseGuards(JwtGuard)` and `@UseGuards(PermissionGuard([...]))`.
+- Freight-domain checks use `hasFreightPermission(user, FREIGHT_PERMS.<area>.<action>)`.
+- Permissions are declared in `apps/edr-freight-api/src/seed/freight-permissions.registry.ts`.
+  Add a permission there before referencing it.
+- IAM has its own migrations, run ahead of freight migrations from the same data source, and
+  its own CLI scripts (`iam:migration:run`, `iam:seed:run`).
+
+Ownership checks are separate from permission checks. A staff user passes
+`hasFreightPermission`; a customer must additionally pass an ownership assertion such as
+`assertCustomerCanAccessBooking`. Do not drop the ownership check because the permission check passed.
+
+## Frontend conventions
+
+- The web apps use **Mantine v9**. Its APIs differ from v6/v7 — check the installed version
+  before copying a snippet.
+- `@edr/ui-common` holds shared components and theme; it is imported in ~94 files across the
+  freight web apps. Prefer it over re-implementing a component.
+- **Blob downloads need the async error decoder.** A request with `responseType: 'blob'`
+  delivers the JSON error body as a `Blob`, so the synchronous `extractErrorMessage` finds no
+  `.message` and degrades to `"Request failed with status code 400"`. Use
+  `await extractDownloadErrorMessage(error)` in every PDF/blob catch block. Mutation catches
+  keep the synchronous version — their bodies are already parsed JSON.
+- Server-side guards must be reflected in the UI. If the API will reject the action, the
+  button should be disabled, hidden, or explain the blocker — not fire and surface a 400.
+- Prefer disabling a control with a visible reason over silently hiding it.
+
+## Notifications
+
+In-app notifications resolve recipients from the company's **linked portal users**. If a
+company has none, `notify()` logs `0 recipients — skipped` and stores nothing, with no error.
+SMS and email still send, because they address the company's phone and email directly. Check
+this before debugging a "missing notification".
+
+## PDF generation
+
+Chromium is not installed in every environment. PDF paths must fall back to the hand-rolled
+generators (`styled-pdf.util.ts`, `buildFallbackPdf`, `buildTabularFallbackPdf`) rather than
+assume a headless browser exists.
+
+## Adding a new module to a NestJS app
+
+1. Create `modules/<feature>/` with `entities/`, `dto/`, and the four
+   `<feature>.{module,controller,service,repository}.ts` files.
+2. The entity extends `BaseEntity` from `@edr/api-common`.
+3. The repository extends `BaseRepository<Entity>` from `@edr/api-common`.
+4. The service injects the repository class (not `Repository<T>` directly).
+5. The controller uses `@ApiTags()` + `@ApiOperation()` for Swagger, and guards the route.
+6. Register the module in the app's `app.module.ts`.
+
+## Adding a new shared component to `@edr/ui-common`
+
+1. Create `src/components/<Name>/<Name>.tsx` and `src/components/<Name>/index.ts`.
+2. Export from `src/index.ts`.
+3. Component is a functional component with a `ComponentNameProps` interface
+   (named-exported alongside the default).
+
+## Definition of done
+
+A change is done when **all** of these hold. State explicitly which you ran.
+
+1. **It type-checks.** `pnpm turbo type-check --filter=<each touched package>` passes.
+   If you edited `packages/types`, you ran `pnpm turbo build --filter=@edr/types` first.
+2. **Raw SQL is verified.** Every new or edited SQL statement ran under `EXPLAIN` against the
+   dev database without error.
+3. **Migrations are safe.** Unique timestamp, idempotent DDL, and — if the migration adds
+   something the new code reads — applied to the dev database, since watch mode will not run it.
+4. **No new test failures.** `pnpm test` for `@edr/freight-api` is **currently red on `dev`**,
+   so a fully green suite is not the bar. Run the specs covering what you touched and confirm
+   you introduced no new failure.
+5. **Lint and format are clean** for the files you touched. Git hooks do **not** run these
+   automatically (see below), so run them yourself.
+6. **The behaviour was actually observed**, not merely compiled — you drove the flow, hit the
+   endpoint, or ran the query. If you could not, say so plainly.
+7. **Report honestly.** If a check was skipped, tests failed, or a fix is unverified, say it in
+   the summary. Never describe unverified work as done.
+
+### Hooks do not run
+
+`commitlint.config.js` and a `lint-staged` config both exist, and husky's shims are installed
+at `.husky/_/`. But there are **no user hook scripts** (`.husky/pre-commit`,
+`.husky/commit-msg`), so husky's shim exits 0 and **neither lint-staged nor commitlint ever
+fire.** Nothing validates your commit message or formats your staged files. Run the checks by
+hand; do not assume the hook caught it.
+
+## Known traps
+
+| Trap | What happens | What to do |
+| --- | --- | --- |
+| Schema drift | A recorded migration's column is missing; queries and inserts 500 | Write a new repair migration; never edit the recorded one |
+| Duplicate migration timestamps | Non-deterministic ordering; a migration can be skipped | Pick a fresh, higher timestamp |
+| `@edr/types` not rebuilt | Consumers can't see your new field | `pnpm turbo build --filter=@edr/types` |
+| Slow I/O in a transaction | Locks held for the gateway timeout | Queue it; fan out after commit; always set an HTTP timeout |
+| Blob error bodies | Real 400 message replaced by "Request failed with status code 400" | `await extractDownloadErrorMessage(error)` |
+| Company with no portal user | In-app notification silently vanishes | Check portal users before debugging |
+| Watch-mode reload | New code, old schema → 500 | Apply the migration to the dev DB or restart fully |
+
+## Project skills
+
+Reusable workflows live in `.claude/skills/`. Use them instead of re-deriving the steps:
+
+| Skill | Use for |
+| --- | --- |
+| `edr-db` | Query / `EXPLAIN`-validate / inspect the remote dev DB (`node .claude/skills/edr-db/query.cjs …`). psql is not installed — this is the sanctioned path. Also carries the 400/500 diagnosis loop. |
+| `verify` | The definition-of-done runner: targeted type-check, `@edr/types` rebuild, SQL validation, migration checklist, honest test bar. Run before calling anything finished. |
+| `standup` | "What did I do today / this week" reports for tickets, grounded in `git log` — including the check that commit subjects match their contents. |
+
+## Working style
+
+- **Verify before asserting.** Read the code or query the database. Do not infer behaviour
+  from a filename.
+- **Investigate, then propose.** For anything risky or wide-reaching, present the plan and the
+  trade-off before changing files.
+- **Small, reviewable commits**, one logical change each, conventional message.
+- **Branch from `dev`; PRs target `dev`.**
+- When a finding turns out to be wrong, say so and retract it. A rejected finding is a result.
diff --git a/docs/qa/edr-freight-qa-test-plan.md b/docs/qa/edr-freight-qa-test-plan.md
new file mode 100644
index 000000000..f9102bc18
--- /dev/null
+++ b/docs/qa/edr-freight-qa-test-plan.md
@@ -0,0 +1,292 @@
+# EDR Freight — Operations QA Test Plan
+
+End-to-end test flows from booking through warehouse, rail, and delivery — import and export,
+with and without first/last mile, self-haul and EDR haulage. Every status, guard, and endpoint
+below is taken from the code, not assumed.
+
+| | |
+|---|---|
+| **Branch** | `Truckdetantion` |
+| **Scope** | Warehouse · Fees · Allocation · First mile · Last mile |
+| **Depth** | Tester steps + technical refs |
+
+---
+
+## 00 · Test data setup
+
+Nothing below passes without this. Set it up once per environment and confirm each line before
+opening a single flow.
+
+- [ ] **Warehouse tree.** At least one `ACTIVE` warehouse with a yard and a zone. Capacities are in **tonnes**, not kg.
+- [ ] **Company has a linked portal user.** Critical — in-app notifications resolve recipients from the company's portal users. With none linked, `notify()` logs `0 recipients — skipped` and stores nothing. SMS/email still fire.
+- [ ] **Customer saved signature.** Required for Approve delivery; without it the API returns *"Please save your signature before approving delivery"*.
+- [ ] **Allocation rules** covering the freight type and trade direction under test (see §08), or accept the capacity-balanced fallback.
+- [ ] **Fee rules** — at least one each of `STORAGE_FEE`, `DEMURRAGE_FEE`, `DOUBLE_HANDLING_FEE`, `TRUCK_DETENTION_FEE` (see §07).
+- [ ] **Drivers and vehicles** registered; a train schedule with wagons for the route under test.
+- [ ] **Booking reaches `PAID`.** Receive-to-warehouse skips any booking that is not PAID.
+- [ ] **Container numbers are ISO 6346** — 4 letters + 7 digits, uppercase (`ABCU1234567`). Enforced at booking input and at every reference point.
+
+> **Direction is derived, not declared.** Receive-to-warehouse computes trade direction from the
+> *origin and destination yard countries*, not the booking's stored `trade_direction`. A booking
+> whose route says IMPORT will be skipped from an EXPORT receive with *"Booking route is IMPORT,
+> not EXPORT"*. Set up yards accordingly.
+
+---
+
+## 01 · Lifecycle reference
+
+The three state machines a tester needs to read a failure. Anything not listed as an allowed
+transition is rejected by `assertTransition`.
+
+### Warehouse inventory transitions
+
+| From | Allowed next | Notes |
+|---|---|---|
+| `UNLOADED` | `STORED`, `READY_FOR_PICKUP` | Import landing state after train unload |
+| `RECEIVED` | `STORED`, `READY_FOR_PICKUP` | Export landing state after truck receive |
+| `STORED` | `RESERVED`, `READY_FOR_LOADING` | Reserve is retired from the UI; `STORED → READY_FOR_LOADING` is the live path |
+| `READY_FOR_LOADING` | `LOADED` | Onto a wagon |
+| `LOADED` | `DISPATCHED` | |
+| `DISPATCHED` | `UNLOADED_AT_DJIBOUTI_PORT` | Export only, at Djibouti |
+| `READY_FOR_PICKUP` | `DELIVERED`, `STORED`, `DISPATCHED` | Import; may be put back into storage |
+
+### Container item stages
+
+```
+PENDING → RECEIVED → GRN → ASSIGNED → LOADED → LEFT → DELIVERED
+```
+
+**ASSIGNED** means the customer picked which containers ride which truck — planning only.
+**LOADED** requires the operator to actually load them, and only after the truck has arrived
+(`loaded_at` is stamped then). Assignment alone must never show LOADED.
+
+### First mile & last mile
+
+| Leg | Statuses, in order | Gate it controls |
+|---|---|---|
+| First mile | `PAYMENT_PENDING → READY_TO_TRANSIT → IN_TRANSIT → RECEIVED_TO_PORT` | Export receive is blocked until `RECEIVED_TO_PORT` |
+| Last mile | `PAYMENT_PENDING → READY_TO_TRANSIT → IN_TRANSIT → DELIVERED` | Truck-detention window: `arrivedAt` (reached destination) → `deliveredAt` (vehicle returned) |
+
+---
+
+## 02 · Export — without first mile
+
+Customer brings the cargo to the facility themselves. The happy path from a paid booking to cargo
+unloaded at Djibouti port with an interchange document.
+
+| Step | Tester action | Expected result | Technical ref |
+|---|---|---|---|
+| E1.1 | Create an export booking (route origin ET → destination DJ), pay it. | Booking reaches `PAID`. | Container numbers must be ISO 6346 |
+| E1.2 | Export Operations → **Receive for Loading**. Select the booking, capture the truck entrance (plate, driver, weights), pick warehouse/yard/zone. | Inventory created; **GRN issued** as `GRN-EXPORT-YYYYMMDD-XXXXXXXX`. Customer gets a receive SMS. | `POST /warehouse-inventory/receive-bulk` |
+| E1.3 | Store the item — auto-allocate, or pick warehouse/yard/zone in the Store modal. | Status `STORED`; note records "allocation rule", "capacity-balanced", or "operator-selected". | Capacity decremented in tonnes |
+| E1.4 | Inspect: mark selected items as inspected, outcome **PASSED**. | Export items advance straight to `READY_FOR_LOADING`. | Reserve step is retired |
+| E1.5 | Ready To Load tab → load onto the allocated wagon. | Status `LOADED`; a warehouse loading record exists. | Requires an allocated wagon |
+| E1.6 | Download the **export marshalling / load list** PDF. | PDF lists the train's wagons, bookings, containers. | train-scheduling controller |
+| E1.7 | Dispatch Queue → dispatch. | Status `DISPATCHED`. Customer receives **"Shipment dispatched"** naming origin → destination. | Per booking on the schedule |
+| E1.8 | Move the schedule to arrived at the Djibouti-side port. | Train appears in the Djibouti unloading queue. Customer receives **"Shipment arrived"**. | status `ARRIVED` / `ARRIVED_AT_DJIBOUTI` |
+| E1.9 | Grant the gate pass for the train, then **Unload at Djibouti**. | Items become `UNLOADED_AT_DJIBOUTI_PORT` and an **interchange document** is generated. | Unload checks `gatepass_granted_at` |
+| **E1.G** | Try to unload at Djibouti *before* granting the gate pass. | 🚫 **Blocked.** Items skipped with a gate-pass reason; no interchange document. | See §06 |
+
+---
+
+## 03 · Export — with first mile
+
+EDR collects the cargo from the customer's premises. Identical to §02 from the store step onward;
+the difference is entirely in the gate before receive.
+
+| Step | Tester action | Expected result | Technical ref |
+|---|---|---|---|
+| E2.1 | Create the export booking with a **first-mile pickup address** (or a service type that includes first mile). | Booking is flagged `hasFirstMile`. | Derived from address *or* `service_types.includes_first_mile` |
+| E2.2 | Create the first-mile request; assign a vehicle and driver. | Driver receives an SMS naming the vehicle, booking, pickup and destination. | First Mile page |
+| E2.3 | Walk the leg: `READY_TO_TRANSIT → IN_TRANSIT → RECEIVED_TO_PORT`. | Each transition persists. | |
+| E2.4 | Now run **Receive for Loading**. | Booking is received; truck entrance pre-filled from the first-mile vehicle and driver. | Then continue at E1.3 |
+| **E2.G1** | Attempt receive with **no first-mile request created**. | 🚫 Skipped: *"First-mile request not created"*. | |
+| **E2.G2** | Attempt receive while first-mile status is `IN_TRANSIT`. | 🚫 Skipped: *"First-mile truck has not arrived"*. | Only `RECEIVED_TO_PORT` passes |
+
+---
+
+## 04 · Import — self-haul (customer collects)
+
+The longest flow, and the one with the most guards. The customer assigns their own trucks, signs a
+booking-level handover, and collects. Test this one first — it exercises truck arrival, loading,
+weighing, handover, exit paper, and fees.
+
+```
+train arrives → unload → inspect → ready for pickup → assign truck → truck arrival
+  → sign handover → load → truck leaving → exit paper → deliver
+```
+
+| Step | Tester action | Expected result | Technical ref |
+|---|---|---|---|
+| I1.1 | Import booking (route DJ → ET), paid, **no last-mile address** and a service type that excludes last mile. | Booking is self-haul. | Drives `usesCustomerTruck` |
+| I1.2 | Import Operations → **Arrival Queue**. Open the arrived train, assign warehouse/yard/zone per booking, **Auto Unload Arrived Bookings**. | Inventory created at `UNLOADED`. Counter shows `n/total unloaded`. | Train must be `ARRIVED` |
+| I1.3 | Inspect the item, outcome **PASSED**. | Item advances to `READY_FOR_PICKUP`. Customer receives **"Assign a truck for pickup"** (in-app + SMS + email). | Fires only when self-haul *and* no truck assigned |
+| I1.4 | **Portal:** customer assigns truck(s), entering ISO container numbers per truck. | Containers move to stage `ASSIGNED` and show their planned truck. Booking becomes `TRUCK_ASSIGNED`. | 20ft → max 2/truck; 40ft → 1/truck; trucks ≤ containers |
+| I1.5 | Backoffice row menu → **Truck Arrival**. Select the assigned truck, record gate-in time and **tare** weight (tonnes). | Truck stamped arrived. A **SELF_HAUL handover** is generated (booking-level) and the customer is notified to sign, on all three channels. | Truck Arrival disabled until a truck is assigned |
+| I1.6 | **Portal:** customer opens the booking → **Approve delivery**. | The handover PDF opens for review; approving applies their saved signature and returns the signed PDF. | Signs all unsigned handovers on the booking |
+| I1.7 | Open the container list → select the assigned containers → **Load onto truck** (pick the arrived truck). | Containers move to `LOADED`; `loaded_at` stamped. | Only arrived, not-departed trucks are listed |
+| I1.8 | Row menu → **Truck Leaving**. Select the containers on the truck, record gate-out time and **gross** weight. | Net is computed from the selected containers' cargo weight and must equal `gross − tare`. Release document issued. | Weight match enforced client- *and* server-side |
+| I1.9 | Generate the **exit paper** for the truck. | PDF lists the truck, driver, and its containers. Containers move to `LEFT`. | Requires signed handover + cleared fees |
+| I1.10 | **Deliver** the inventory, recording the receiver name. | Status `DELIVERED`; handovers stamped delivered. | Requires handover signed *and* truck departed |
+
+> 🚫 **The single most likely bug you will hit.** Exit paper returns `400` when the handover is not
+> fully signed, or when a warehouse fee invoice is `ISSUED` / `PARTIALLY_PAID`. In the container
+> list, the Exit Paper button turns grey and clicking it **sends the customer a signature request**
+> instead of erroring. That is correct behaviour — verify the message, don't file it as a bug.
+
+---
+
+## 05 · Import — EDR last mile
+
+EDR delivers to the customer's door. No customer truck, no portal Approve delivery, and the
+handover is *per delivering truck* — not per booking. This is where truck detention accrues.
+
+| Step | Tester action | Expected result | Technical ref |
+|---|---|---|---|
+| I2.1 | Import booking with a **last-mile delivery address** (or service type including last mile). | `hasLastMile` is true; no "assign a truck" notification is sent. | EDR haulage — customer assigns nothing |
+| I2.2 | Unload from the arrived train, inspect PASSED. | Item becomes `READY_FOR_PICKUP` and the last-mile leg is accepted automatically. | |
+| I2.3 | Last Mile page: assign vehicle + driver. | Leg reaches `READY_TO_TRANSIT`. Row shows Assigned. | Driver notified by SMS |
+| I2.4 | **Truck Arrival** from the Last Mile row: gate-in, tare weight. | Weighing saved; the assigned last-mile truck is pre-selected. | Re-opening must show the saved details |
+| I2.5 | **Truck Leaving**: gate-out, gross weight. | Release document issued; leg moves to `IN_TRANSIT`. `arrivedAt` starts the detention clock. | Detention window opens |
+| I2.6 | Deliver at the customer's door, recording the receiver name. | Item `DELIVERED`. An **EDR_LAST_MILE handover is generated per delivering truck**, resolved from the container's allocated vehicle. | Not booking-level |
+| I2.7 | Return the vehicle → mark the leg `DELIVERED`. | `deliveredAt` stamped; detention clock stops. | |
+| I2.8 | Preview, then generate the **truck detention invoice**. | Charged per truck per day beyond the grace hours, at the matching tier. See §07. | `POST /last-mile/:id/generate-truck-detention-invoice` |
+| **I2.G** | Open the booking in the portal. | 🚫 **Approve delivery must NOT appear.** The portal flag counts only `SELF_HAUL` handovers; EDR handovers are signed by the receiver at the door. | Regression check |
+
+---
+
+## 06 · Marshalling, gate pass, interchange
+
+Documents are generated, not uploaded. Each has a precondition; test the precondition, not just the PDF.
+
+| Document | When | Precondition | Verify |
+|---|---|---|---|
+| **GRN** | On receive to warehouse | Booking `PAID`; route direction matches; export needs a truck entrance | Number format `GRN-<DIR>-<YYYYMMDD>-<8>`; PDF opens; customer SMS sent |
+| **Import load list / marshalling** | Import train, before unload | Schedule has bookings assigned | Summary endpoint and printable PDF agree; portrait/landscape both render |
+| **Export marshalling / load list** | Export train, after loading | Items `LOADED` onto wagons | Wagon, booking, container rows are complete |
+| **Gate pass** | Djibouti-side operations | Granted per schedule | `gatepass_granted_at` is set; **export Djibouti unload reads this same field** |
+| **Interchange document** | Automatically, after a successful Djibouti unload | At least one item unloaded | Document number returned in the unload response; visible in Interchange Documents |
+| **Handover** | Self-haul: on truck arrival. EDR: at delivery. | See §04 / §05 | Self-haul is booking-level, one per booking; EDR is one per delivering truck |
+| **Exit paper / release doc** | Truck leaving | Handover fully signed *and* no unpaid warehouse fee | Weights on the paper match the gate weighing |
+
+> ⚠️ **Cross-module quirk worth confirming with the team.** The *export* Djibouti unload checks the
+> gate-pass flag stored on the *import* Djibouti operations record
+> (`import_djibouti_operations.gatepass_granted_at`). It works, but it is surprising. If an export
+> unload silently skips every item, check that field first.
+
+---
+
+## 07 · Fee rules
+
+Four rule types. Two are day-based with free days and tiers; double handling is a flat rate
+multiplied by a basis; truck detention is hour-graced and vehicle-scoped.
+
+| Rule type | Charged on | Key fields | Test cases |
+|---|---|---|---|
+| `STORAGE_FEE` | Days in storage | free days, `tiers` | Within free days → zero. One day past → tier 1. Cross a tier boundary → correct tier rate. |
+| `DEMURRAGE_FEE` | Days beyond free time | free days, `tiers` | Same boundary tests. Confirm it blocks exit paper and delivery while `ISSUED`. |
+| `DOUBLE_HANDLING_FEE` | Flat rate × quantity | `basis`: `PER_CONTAINER` \| `PER_TON` \| `PER_ITEM` | Container booking → PER_CONTAINER uses container count. Bulk → PER_TON uses tonnage. Break-bulk machinery → PER_ITEM uses item count. **Import only.** Free days and tiers must not apply. |
+| `TRUCK_DETENTION_FEE` | Per truck, per day | `free_hours` grace, `tiers`, vehicle type scope | Return inside the grace window → zero. Just past grace → day 1 at tier 1. Multi-day → tier escalation. A vehicle type outside the rule's scope → no charge. **Import only.** |
+
+### Fee behaviour to verify on every rule
+
+- [ ] **Preview before invoice.** The preview amount must equal the issued invoice total.
+- [ ] **Notification on issue.** Issuing a warehouse fee invoice sends the customer an in-app `INVOICE_ISSUED` notification *and* an SMS, deep-linked to pay.
+- [ ] **Clearance gate.** While a warehouse-source invoice is `ISSUED` or `PARTIALLY_PAID`, exit paper, terminal release, and Approve delivery are all blocked.
+- [ ] **Payable-but-uninvoiced.** If fees are payable and no invoice exists yet, release is still blocked with *"Generate and fully pay…"*. Confirm the operator can generate it from that state.
+- [ ] **Fully paid** → release proceeds; a receipt PDF is available.
+- [ ] **Edit a rule** (rate, free days, tiers, grace hours) and confirm the next preview reflects it.
+
+---
+
+## 08 · Allocation rules
+
+Where an item is stored is decided by the first matching rule, in priority order. Test the
+precedence, not just one rule.
+
+| Match criteria (any may be null = wildcard) | Targets |
+|---|---|
+| `freight_type`, `trade_direction`, `cargo_type_code`, `container_status`, `requires_inspection`, ordered by `priority` | `target_facility_code`, `target_warehouse_code`, `target_yard_code` (required), `target_zone_code`, `storage_type` |
+
+### Precedence, highest first
+
+| # | Source of the location | How to trigger | Note recorded |
+|---|---|---|---|
+| 1 | **Operator selection** | Store modal → pick warehouse + yard + zone | "Stored at operator-selected location" |
+| 2 | **Allocation rule** | Leave the Store modal blank; a matching rule exists | "Stored by allocation rule `<name>`" |
+| 3 | **Capacity-balanced fallback** | Leave blank; no rule matches | "Stored by capacity-balanced allocation" |
+
+- [ ] Two matching rules → the **lower priority number wins**.
+- [ ] Yard dropdowns are filtered by **freight type** — container bookings offer container yards only.
+- [ ] Only `ACTIVE` warehouses, yards and zones are selectable.
+- [ ] Storing beyond a zone's capacity is rejected; capacities are compared in **tonnes**.
+- [ ] **Move** an item to another warehouse/yard/zone → capacity released at source, taken at destination.
+- [ ] Edit a rule, an existing warehouse, a yard, and a zone — all four must be editable.
+
+---
+
+## 09 · Negative & guard cases
+
+Every row here is intended behaviour. The test passes when the action is **refused** with the
+stated message. Anything that succeeds is the bug.
+
+| Area | Attempt | Expected refusal |
+|---|---|---|
+| Booking | Enter a container number that is not 4 letters + 7 digits (e.g. `MSKU10105185`, `3456789`). | *"Enter a valid ISO container number"*. Lowercase is auto-uppercased; input capped at 11 characters. |
+| Booking | Enter the **same container number twice** in one shipment. | *"Duplicate container number in this shipment."* |
+| Receive | Receive a booking that is not `PAID`. | Skipped: *"Booking not PAID"*. |
+| Receive | Receive the same booking twice. | Skipped: *"Already received"*. |
+| Receive | Export receive with no truck entrance captured. | Rejected before any inventory is created. |
+| Truck assign | Put **two 40ft containers** on one truck. | *"A 40ft container fills the truck — assign only 1 container to this truck"*. |
+| Truck assign | Put **three containers** on one truck. | *"A truck carries at most 2 containers"*. |
+| Truck assign | Assign **more trucks than the booking has containers**. | *"Cannot assign more trucks than containers…"*. |
+| Truck assign | Assign a container from another booking, or one already on another truck. | *"…is not one of this booking's containers"* / *"…already loaded onto another truck"*. |
+| Truck assign | Edit a truck **after it has arrived**. | Refused — edits are allowed only until arrival. |
+| Loading | **Load containers onto a truck that has not arrived.** | *"Record the truck arrival before loading…"*. The truck picker lists only arrived, not-departed trucks. |
+| Loading | Load onto a truck that has already departed. | *"This truck has already left — its load is locked"*. |
+| Stages | Customer assigns containers to a truck, then check the container list. | Stage is `ASSIGNED`, **never** `LOADED`. Exit Paper is not offered. |
+| Truck leaving | Enter a gross weight where `gross − tare` ≠ the selected containers' cargo weight. | *"Weight mismatch…"*. Exit paper and gate clearance blocked, client and server. |
+| Truck leaving | Save leaving with **no containers selected**. | *"Select the containers loaded on this truck"*. |
+| Exit paper | Generate before the handover is signed. | *"Handover must be signed…"*. In the container list the button is grey and instead **sends the customer a signature request**. |
+| Exit paper | Generate with an `ISSUED` demurrage/storage invoice. | *"…must be fully paid before terminal release"*. |
+| Approve delivery | Approve without a saved signature. | *"Please save your signature…"* and the portal routes to the signature page. |
+| Approve delivery | Approve before warehouse inspection has passed. | *"Delivery can be approved after warehouse inspection has passed"*. |
+| Approve delivery | Approve when a truck is assigned but has not arrived. | *"Customer truck arrival must be recorded before delivery approval"*. |
+| Deliver | Deliver before a release order was issued, or before the self-haul truck has left. | *"A release order must be issued…"* / *"Deliver is available only after the customer truck has left"*. |
+| Djibouti unload | Unload an export train with no gate pass granted. | Items skipped; no interchange document generated. |
+| Warehouse | Store into an `INACTIVE` warehouse/yard/zone, or beyond capacity. | Not selectable / *"No active warehouse yard/zone is available"* / capacity error. |
+
+---
+
+## 10 · Notifications
+
+All customer notifications land in the same portal inbox. Verify the message, the deep link, and —
+where noted — the SMS and email.
+
+| Notification | Fires when | Channels | Deep link |
+|---|---|---|---|
+| Shipment dispatched | Train schedule dispatched, per booking | In-app, SMS, email | Booking |
+| Shipment arrived | Train schedule arrived, per booking | In-app, SMS, email | Booking |
+| Assign a truck for pickup | Export: on warehouse receive. Import: on inspection pass → ready for pickup. Only if self-haul *and* no truck assigned. | In-app, SMS, email | Booking → assign truck |
+| Handover — signature needed | Self-haul truck arrives (handover generated), and re-sent when an operator requests a signature from the Exit Paper button | In-app, SMS, email | Booking → approve delivery |
+| Warehouse fee due | Storage / demurrage invoice issued | In-app, SMS | Booking → pay |
+| Wagon allocated / payment window | Scheduling | In-app | Booking |
+
+> 🚫 **Do not chase a missing in-app notification before checking this.** Recipients are resolved
+> from the company's linked portal users. If a company has none, `notify()` logs *"0 recipients —
+> skipped"* and stores nothing — the notification simply never appears, with no error. SMS and
+> email still go out, because they address the company's phone and email directly. On a fresh
+> environment this is the usual explanation.
+
+---
+
+## 11 · Known open issues
+
+Do not raise duplicates for these. Each is already identified.
+
+| Status | Issue | Impact on testing |
+|---|---|---|
+| 🔴 **Open** | **Export receive returns 500** on the deployed environment (`POST /warehouse-inventory/receive-bulk`). | Blocks flows E1 and E2 at step .2. Awaiting the response body / server log to diagnose. Likely schema drift, not the SQL. |
+| 🟠 **Fix pending deploy** | **Export receive was extremely slow.** The owner SMS was awaited inside the DB transaction, and the SMS client had no HTTP timeout. | Fixed on branch: SMS now has a timeout, and notifications are sent after commit. Re-test receive latency once deployed. |
+| 🟠 **Data** | **Drivers table has no unique constraints** on licence number, email, or phone, despite the entity declaring them unique. | Duplicate drivers can be created. Do not rely on uniqueness in test assertions. |
+| 🔵 **Behaviour** | **Handover generated before truck arrival.** If an operator triggers a signature request from the Exit Paper button while a truck is assigned but not arrived, Approve delivery refuses with *"truck arrival must be recorded"*. | Only reachable off the normal path. Follow flow I1 in order and it will not occur. |

From 001babbd2d522c01168fa4fa74ae77045562119b Mon Sep 17 00:00:00 2001
From: Hagernesh <hagernesh@example.com>
Date: Thu, 9 Jul 2026 13:40:50 +0000
Subject: [PATCH 21/25] fix(warehouses): repair missing
 warehouse_inventory.grn_number column

AddGrnNumberToWarehouseInventory1828000000000 is recorded in the migrations
table but the column is absent - it was added, then dropped out-of-band. Because
TypeORM has the original recorded it will never re-run, so every GRN read/write
fails with "column grn_number does not exist":

  - bulkReceive()             INSERT names grn_number   (receive to warehouse)
  - importQueueByStatuses()   Unloaded + Dispatch queues
  - exportInventoryByStatus() Received / Ready-To-Load / Loaded tabs
  - grnDocument()             GRN PDF

Re-adds the column, backfills from the "GRN Number:" receive note, recreates the
partial index. Idempotent, and down() is a deliberate no-op so reverting the
repair cannot re-introduce the outage.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .../2090000000000-RepairGrnNumberColumn.ts    | 55 +++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100644 apps/edr-freight-api/src/migrations/2090000000000-RepairGrnNumberColumn.ts

diff --git a/apps/edr-freight-api/src/migrations/2090000000000-RepairGrnNumberColumn.ts b/apps/edr-freight-api/src/migrations/2090000000000-RepairGrnNumberColumn.ts
new file mode 100644
index 000000000..aa2f998a2
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/2090000000000-RepairGrnNumberColumn.ts
@@ -0,0 +1,55 @@
+import { MigrationInterface, QueryRunner } from 'typeorm';
+
+/**
+ * Repairs `freight.warehouse_inventory.grn_number`.
+ *
+ * AddGrnNumberToWarehouseInventory1828000000000 is recorded in `migrations` but
+ * the column is absent on at least one environment - it was added, then dropped
+ * out-of-band (a stray `synchronize: true`, same class of damage that
+ * RepairSynchronizeDrift1870000000000 already had to undo). Because TypeORM has
+ * the original recorded, it will never re-run it.
+ *
+ * Without the column, everything that reads or writes a GRN fails with
+ * `column ... grn_number does not exist`:
+ *   - bulkReceive()             -> INSERT names grn_number  (receive to warehouse)
+ *   - importQueueByStatuses()   -> Unloaded + Dispatch queues
+ *   - exportInventoryByStatus() -> Received / Ready-To-Load / Loaded tabs
+ *   - grnDocument()             -> GRN PDF
+ *
+ * Idempotent: a no-op on environments where the column survived.
+ */
+export class RepairGrnNumberColumn2090000000000 implements MigrationInterface {
+  name = 'RepairGrnNumberColumn2090000000000';
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.warehouse_inventory
+      ADD COLUMN IF NOT EXISTS grn_number VARCHAR(100) NULL
+    `);
+
+    // Recover the GRN for rows received before the column existed: it was also
+    // written into the receive note as "GRN Number: <value>".
+    await queryRunner.query(`
+      UPDATE freight.warehouse_inventory
+         SET grn_number = substring(notes FROM 'GRN Number: ([^\\n\\r]+)')
+       WHERE grn_number IS NULL
+         AND notes IS NOT NULL
+         AND notes ~ 'GRN Number: '
+    `);
+
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS idx_warehouse_inventory_grn_number
+      ON freight.warehouse_inventory(grn_number)
+      WHERE grn_number IS NOT NULL
+    `);
+  }
+
+  /**
+   * Deliberately a no-op. Dropping the column is what broke these environments
+   * in the first place, and the original 1828 migration already owns its own
+   * down(). Reverting this repair must not re-introduce the outage.
+   */
+  public async down(): Promise<void> {
+    // intentionally empty
+  }
+}

From ca774267cd08411921a1ec3af81318a23519d8ac Mon Sep 17 00:00:00 2001
From: Hagernesh <hagernesh@example.com>
Date: Thu, 9 Jul 2026 13:41:57 +0000
Subject: [PATCH 22/25] fix(warehouses): Store no longer strands an import item
 in STORED

READY_FOR_PICKUP allows STORED (park an import item back into storage), but
STORED allowed only RESERVED / READY_FOR_LOADING - so readyForPickup() hit
assertTransition(STORED, READY_FOR_PICKUP) and threw. The item could never
return to pickup, and getNextInventoryAction returned null for an import STORED
item, leaving the row with no action at all.

- allow STORED -> READY_FOR_PICKUP
- an inspected import STORED item now advances to ready-for-pickup

readyForPickup() still rejects non-IMPORT inventory, so the new edge cannot be
reached from the export flow.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .../warehouses/entities/warehouse-inventory.entity.ts        | 4 +++-
 apps/edr-freight-web/backoffice/src/types/warehouse.ts       | 5 +++--
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/apps/edr-freight-api/src/modules/warehouses/entities/warehouse-inventory.entity.ts b/apps/edr-freight-api/src/modules/warehouses/entities/warehouse-inventory.entity.ts
index a54f40973..b2c4ca3c4 100644
--- a/apps/edr-freight-api/src/modules/warehouses/entities/warehouse-inventory.entity.ts
+++ b/apps/edr-freight-api/src/modules/warehouses/entities/warehouse-inventory.entity.ts
@@ -36,7 +36,9 @@ export const WAREHOUSE_INVENTORY_TRANSITIONS: Record<WarehouseInventoryStatus, W
   RECEIVED: ['STORED', 'READY_FOR_PICKUP'],
   // Reserve is retired from the operator flow — a stored export item advances
   // straight to loading prep. RESERVED kept for any in-flight/legacy items.
-  STORED: ['RESERVED', 'READY_FOR_LOADING'],
+  // READY_FOR_PICKUP is the way back out for an IMPORT item that was parked in
+  // storage from READY_FOR_PICKUP; without it, Store is a one-way door.
+  STORED: ['RESERVED', 'READY_FOR_LOADING', 'READY_FOR_PICKUP'],
   RESERVED: ['READY_FOR_LOADING'],
   READY_FOR_LOADING: ['LOADED'],
   LOADED: ['DISPATCHED'],
diff --git a/apps/edr-freight-web/backoffice/src/types/warehouse.ts b/apps/edr-freight-web/backoffice/src/types/warehouse.ts
index e16271880..339540453 100644
--- a/apps/edr-freight-web/backoffice/src/types/warehouse.ts
+++ b/apps/edr-freight-web/backoffice/src/types/warehouse.ts
@@ -86,8 +86,9 @@ export function getNextInventoryAction(item: WarehouseInventoryItem): InventoryA
       return 'store';
     case 'STORED':
       // Reserve is retired: a stored export item goes straight to loading prep
-      // once inspection passes. Import STORED is handled via the import queue.
-      if (isImport) return null;
+      // once inspection passes. An import item parked back into storage returns
+      // to pickup — otherwise Store would strand it with no action.
+      if (isImport) return inspected ? 'ready-for-pickup' : null;
       return inspected ? 'ready-for-loading' : null;
     case 'RESERVED':
       // Export loading is gated on a passed inspection.

From 7bf407b503f96a724ee80bc809dd3876764a3278 Mon Sep 17 00:00:00 2001
From: Hagernesh <hagernesh@example.com>
Date: Thu, 9 Jul 2026 13:44:11 +0000
Subject: [PATCH 23/25] fix(warehouses): surface the real reason when a PDF
 download fails

Blob downloads set responseType: 'blob', so axios delivers the JSON error body
as a Blob. extractErrorMessage() reads `.message` off it, finds nothing, and
falls back to "Request failed with status code 400" - hiding every real reason
("Handover must be signed...", "...must be fully paid before terminal release").

Only ContainerItemsModal used the async Blob decoder. Switch the remaining nine
blob-download catches to extractDownloadErrorMessage():

  InventoryWorkbench      release paper, handover
  WarehouseInventoryTable GRN
  ReceiveInventoryModal   GRN (x2), handover, exit paper
  FeePreviewModal         release paper
  TruckDispatchModal      truck exit paper

Mutation-error catches are untouched - their bodies are already parsed JSON.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .../src/components/warehouses/FeePreviewModal.tsx      |  4 ++--
 .../src/components/warehouses/InventoryWorkbench.tsx   |  6 +++---
 .../components/warehouses/ReceiveInventoryModal.tsx    | 10 +++++-----
 .../src/components/warehouses/TruckDispatchModal.tsx   |  4 ++--
 .../components/warehouses/WarehouseInventoryTable.tsx  |  4 ++--
 5 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/apps/edr-freight-web/backoffice/src/components/warehouses/FeePreviewModal.tsx b/apps/edr-freight-web/backoffice/src/components/warehouses/FeePreviewModal.tsx
index 78e09a7e0..5eeee7d13 100644
--- a/apps/edr-freight-web/backoffice/src/components/warehouses/FeePreviewModal.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/warehouses/FeePreviewModal.tsx
@@ -7,7 +7,7 @@ import { useMutation, useQuery } from '@tanstack/react-query';
 import { api } from '@/services/api';
 import { useToast } from '@/hooks/use-toast';
 import { warehouseService } from '@/services/warehouse.service';
-import { extractErrorMessage } from './options';
+import { extractDownloadErrorMessage, extractErrorMessage } from './options';
 import type { FeePreview, WarehouseInventoryItem, WarehouseInvoiceStatus } from '@/types/warehouse';
 import { openPdfBlob } from './pdf';
 
@@ -157,7 +157,7 @@ export function FeePreviewModal({ opened, onClose, inventoryId }: FeePreviewModa
         pdfWindow?.close();
         toast({
           title: 'Gate clearance recorded',
-          description: `Release paper could not be opened: ${extractErrorMessage(documentError)}`,
+          description: `Release paper could not be opened: ${await extractDownloadErrorMessage(documentError)}`,
         });
       }
       onClose();
diff --git a/apps/edr-freight-web/backoffice/src/components/warehouses/InventoryWorkbench.tsx b/apps/edr-freight-web/backoffice/src/components/warehouses/InventoryWorkbench.tsx
index b8bb43086..c4f1f5cec 100644
--- a/apps/edr-freight-web/backoffice/src/components/warehouses/InventoryWorkbench.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/warehouses/InventoryWorkbench.tsx
@@ -18,7 +18,7 @@ import { LoadInventoryModal } from './LoadInventoryModal';
 import { MoveInventoryModal } from './MoveInventoryModal';
 import { ReleaseOrderModal } from './ReleaseOrderModal';
 import { WarehouseInventoryTable } from './WarehouseInventoryTable';
-import { extractErrorMessage } from './options';
+import { extractDownloadErrorMessage, extractErrorMessage } from './options';
 import { openPdfBlob } from './pdf';
 
 interface InventoryWorkbenchProps {
@@ -111,7 +111,7 @@ export function InventoryWorkbench({ items, isLoading, onLastMile }: InventoryWo
       toast({
         variant: 'destructive',
         title: 'Release paper preview failed',
-        description: extractErrorMessage(error),
+        description: await extractDownloadErrorMessage(error),
       });
     } finally {
       setBusyId(null);
@@ -131,7 +131,7 @@ export function InventoryWorkbench({ items, isLoading, onLastMile }: InventoryWo
       toast({
         variant: 'destructive',
         title: 'Handover document failed',
-        description: extractErrorMessage(error),
+        description: await extractDownloadErrorMessage(error),
       });
     } finally {
       setBusyId(null);
diff --git a/apps/edr-freight-web/backoffice/src/components/warehouses/ReceiveInventoryModal.tsx b/apps/edr-freight-web/backoffice/src/components/warehouses/ReceiveInventoryModal.tsx
index 3b4be03db..dd04cd3ff 100644
--- a/apps/edr-freight-web/backoffice/src/components/warehouses/ReceiveInventoryModal.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/warehouses/ReceiveInventoryModal.tsx
@@ -76,7 +76,7 @@ import { MoveInventoryModal } from './MoveInventoryModal';
 import { ReleaseOrderModal } from './ReleaseOrderModal';
 import { StoreInventoryModal } from './StoreInventoryModal';
 import { WarehouseInquiryTable } from './WarehouseInquiryTable';
-import { extractErrorMessage, formatDate, formatNumber, inventoryStatusOptions } from './options';
+import { extractDownloadErrorMessage, extractErrorMessage, formatDate, formatNumber, inventoryStatusOptions } from './options';
 import { openPdfBlob } from './pdf';
 import '@/components/overview/overview.css';
 
@@ -112,7 +112,7 @@ function GrnDocumentButton({ inventoryId, grnNumber }: { inventoryId: string; gr
       toast({ title: opened ? 'GRN document opened' : 'GRN document downloaded' });
     } catch (error) {
       pdfWindow?.close();
-      toast({ variant: 'destructive', title: 'GRN document failed', description: extractErrorMessage(error) });
+      toast({ variant: 'destructive', title: 'GRN document failed', description: await extractDownloadErrorMessage(error) });
     } finally {
       setLoading(false);
     }
@@ -900,7 +900,7 @@ function EligibleTab({
           toast({ title: opened ? 'GRN document opened' : 'GRN document downloaded' });
         } catch (error) {
           pdfWindow?.close();
-          toast({ variant: 'destructive', title: 'GRN document failed', description: extractErrorMessage(error) });
+          toast({ variant: 'destructive', title: 'GRN document failed', description: await extractDownloadErrorMessage(error) });
         }
       }
       setSelected(new Set());
@@ -2282,7 +2282,7 @@ function ImportUnloadedQueueTab({ enabled }: { enabled: boolean }) {
       void qc.invalidateQueries({ queryKey: ['warehouse-inventory'] });
     } catch (error) {
       pdfWindow?.close();
-      toast({ variant: 'destructive', title: 'Handover document failed', description: extractErrorMessage(error) });
+      toast({ variant: 'destructive', title: 'Handover document failed', description: await extractDownloadErrorMessage(error) });
     } finally {
       setBusyId(null);
     }
@@ -2296,7 +2296,7 @@ function ImportUnloadedQueueTab({ enabled }: { enabled: boolean }) {
       openPdfBlob(response.data, `release-${row.bookingReference ?? row.id}.pdf`, pdfWindow);
     } catch (error) {
       pdfWindow?.close();
-      toast({ variant: 'destructive', title: 'Exit paper failed', description: extractErrorMessage(error) });
+      toast({ variant: 'destructive', title: 'Exit paper failed', description: await extractDownloadErrorMessage(error) });
     } finally {
       setBusyId(null);
     }
diff --git a/apps/edr-freight-web/backoffice/src/components/warehouses/TruckDispatchModal.tsx b/apps/edr-freight-web/backoffice/src/components/warehouses/TruckDispatchModal.tsx
index 73e37c1ec..f26469ac7 100644
--- a/apps/edr-freight-web/backoffice/src/components/warehouses/TruckDispatchModal.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/warehouses/TruckDispatchModal.tsx
@@ -5,7 +5,7 @@ import { useState } from 'react';
 
 import { useToast } from '@/hooks/use-toast';
 import { warehouseService } from '@/services/warehouse.service';
-import { extractErrorMessage } from './options';
+import { extractDownloadErrorMessage, extractErrorMessage } from './options';
 import { openPdfBlob } from './pdf';
 
 interface TruckDispatchModalProps {
@@ -56,7 +56,7 @@ export function TruckDispatchModal({ opened, onClose, bookingId, bookingReferenc
       const res = await warehouseService.downloadTruckExitPaper(assignmentId);
       openPdfBlob(res.data, `exit-${plate}.pdf`);
     } catch (e) {
-      toast({ variant: 'destructive', title: 'Exit paper not ready', description: extractErrorMessage(e) });
+      toast({ variant: 'destructive', title: 'Exit paper not ready', description: await extractDownloadErrorMessage(e) });
     }
   };
 
diff --git a/apps/edr-freight-web/backoffice/src/components/warehouses/WarehouseInventoryTable.tsx b/apps/edr-freight-web/backoffice/src/components/warehouses/WarehouseInventoryTable.tsx
index 871780bbf..63292b0af 100644
--- a/apps/edr-freight-web/backoffice/src/components/warehouses/WarehouseInventoryTable.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/warehouses/WarehouseInventoryTable.tsx
@@ -10,7 +10,7 @@ import {
   type WarehouseInventoryItem,
 } from '@/types/warehouse';
 import { InventoryStatusBadge } from './badges';
-import { extractErrorMessage, formatDate, formatNumber, humanizeEnum } from './options';
+import { extractDownloadErrorMessage, formatDate, formatNumber, humanizeEnum } from './options';
 import { openPdfBlob } from './pdf';
 
 interface WarehouseInventoryTableProps {
@@ -78,7 +78,7 @@ function GrnDocumentButton({ item }: { item: WarehouseInventoryItem }) {
       toast({ title: opened ? 'GRN document opened' : 'GRN document downloaded' });
     } catch (error) {
       pdfWindow?.close();
-      toast({ variant: 'destructive', title: 'GRN document failed', description: extractErrorMessage(error) });
+      toast({ variant: 'destructive', title: 'GRN document failed', description: await extractDownloadErrorMessage(error) });
     } finally {
       setLoading(false);
     }

From 7ab5e9edd5125ecbb6f91332a85ead656f9bec4b Mon Sep 17 00:00:00 2001
From: Hagernesh <hagernesh@example.com>
Date: Thu, 9 Jul 2026 15:06:24 +0000
Subject: [PATCH 24/25] feat(warehouses): handover-driven approve delivery,
 weigh-skip, 5-min sign reminders

Approve delivery now tracks the handover lifecycle exactly: the button appears
(detail page + portal dashboard) the moment a handover is generated and
disappears when the customer signs. The bookings list attaches the
handoverAwaitingSignature flag via one batched query per page; status
heuristics (COMPLETED / TRUCK_ASSIGNED+arrived) are gone.

- generate the arrival handover for ANY self-haul truck: portal-assigned OR
  walk-in registered at the gate (isSelfHaulBooking: assigned_at set, or no
  EDR last-mile leg). Same rule now guards the exit paper.
- remind every 5 minutes (in-app + SMS + email) until the handover is signed
  (@Cron in HandoverService; one reminder per booking per tick)
- Truck Leaving no longer opens blank: the import queue mapper now carries
  inv.notes, so the saved arrival renders read-only with only gate-out time
  and gross weight editable
- container bookings get "Weigh truck? Yes/No": No skips tare/gross and the
  container weight match (weighingSkipped on ReleaseOrderDto, decision made at
  arrival sticks for the exit via the Weighing: SKIPPED note). Bulk always
  weighs, unchanged.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .../src/modules/bookings/bookings.service.ts  | 28 +++++++-
 .../warehouses/dto/release-order.dto.ts       | 11 ++-
 .../modules/warehouses/handover.service.ts    | 32 +++++++++
 .../warehouses/warehouse-inventory.service.ts | 71 +++++++++++++------
 .../warehouses/ReceiveInventoryModal.tsx      |  3 +
 .../warehouses/ReleaseOrderModal.tsx          | 55 ++++++++++----
 .../backoffice/src/types/warehouse.ts         |  2 +
 .../MyPortalPage/components/BookingRow.tsx    |  4 +-
 .../BookingDetailPage/ReadonlyBookingView.tsx | 10 +--
 9 files changed, 174 insertions(+), 42 deletions(-)

diff --git a/apps/edr-freight-api/src/modules/bookings/bookings.service.ts b/apps/edr-freight-api/src/modules/bookings/bookings.service.ts
index 48a29988a..c804b2579 100644
--- a/apps/edr-freight-api/src/modules/bookings/bookings.service.ts
+++ b/apps/edr-freight-api/src/modules/bookings/bookings.service.ts
@@ -1125,6 +1125,30 @@ export class BookingsService {
     );
   }
 
+  /**
+   * Batched version of the findById flag: marks each page item whose booking
+   * has a generated-but-unsigned SELF_HAUL handover, so list rows (portal
+   * dashboard) can show "Approve delivery" for exactly the generated→signed
+   * window. One query for the whole page.
+   */
+  private async attachHandoverFlags(bookings: Booking[]): Promise<void> {
+    const ids = bookings.map((b) => b.id);
+    if (!ids.length) return;
+    const rows: Array<{ bookingId: string }> = await this.dataSource.query(
+      `SELECT DISTINCT booking_id AS "bookingId"
+         FROM freight.booking_handovers
+        WHERE booking_id = ANY($1::uuid[])
+          AND signed_at IS NULL AND deleted_at IS NULL
+          AND mile_type = 'SELF_HAUL'`,
+      [ids],
+    );
+    const pending = new Set(rows.map((r) => r.bookingId));
+    for (const b of bookings) {
+      (b as Booking & { handoverAwaitingSignature?: boolean }).handoverAwaitingSignature =
+        pending.has(b.id);
+    }
+  }
+
   async findAll(
     filter: FilterBookingDto,
     forceCompanyId?: string,
@@ -1135,7 +1159,7 @@ export class BookingsService {
     const statusFilter = this.parseStatusFilter(filter);
     const schedulingStatusFilter = this.parseSchedulingStatusFilter(filter);
 
-    return this.bookingsRepository.findAllPaginated({
+    const result = await this.bookingsRepository.findAllPaginated({
       page,
       pageSize,
       ...statusFilter,
@@ -1162,6 +1186,8 @@ export class BookingsService {
       sortBy: filter.sortBy,
       sortOrder: filter.sortOrder,
     });
+    await this.attachHandoverFlags(result.items ?? []);
+    return result;
   }
 
   /** Booking statuses at which a customer can pay (mirrors booking-payment.service). */
diff --git a/apps/edr-freight-api/src/modules/warehouses/dto/release-order.dto.ts b/apps/edr-freight-api/src/modules/warehouses/dto/release-order.dto.ts
index 681b30284..17b75b424 100644
--- a/apps/edr-freight-api/src/modules/warehouses/dto/release-order.dto.ts
+++ b/apps/edr-freight-api/src/modules/warehouses/dto/release-order.dto.ts
@@ -1,5 +1,5 @@
 import { ApiPropertyOptional } from '@nestjs/swagger';
-import { IsDateString, IsNumber, IsOptional, IsString, Min } from 'class-validator';
+import { IsBoolean, IsDateString, IsNumber, IsOptional, IsString, Min } from 'class-validator';
 
 /** Records a DO / release order being sent to the customer for import pickup. */
 export class ReleaseOrderDto {
@@ -90,4 +90,13 @@ export class ReleaseOrderDto {
   @IsOptional()
   @IsDateString()
   gateOutTime?: string;
+
+  @ApiPropertyOptional({
+    description:
+      'Container bookings only: the operator chose not to weigh this truck. ' +
+      'Tare/gross become optional and the container weight match is skipped. Bulk always weighs.',
+  })
+  @IsOptional()
+  @IsBoolean()
+  weighingSkipped?: boolean;
 }
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 5df15910e..48ab3ac48 100644
--- a/apps/edr-freight-api/src/modules/warehouses/handover.service.ts
+++ b/apps/edr-freight-api/src/modules/warehouses/handover.service.ts
@@ -1,4 +1,5 @@
 import { Injectable, Logger } from '@nestjs/common';
+import { Cron, CronExpression } from '@nestjs/schedule';
 import { NotificationAudience, NotificationType } from '@edr/types';
 import { DataSource, EntityManager, IsNull } from 'typeorm';
 
@@ -150,6 +151,37 @@ export class HandoverService {
     );
   }
 
+  /**
+   * Reminder loop: until a self-haul handover is signed, re-send the sign
+   * notification (in-app + SMS + email) every 5 minutes. One reminder per
+   * booking per tick, newest unsigned handover's reference. Stops the moment
+   * signForBooking() stamps signed_at.
+   *
+   * NB: runs in every API instance — keep a single instance in dev or the
+   * customer is reminded once per instance per tick.
+   */
+  @Cron(CronExpression.EVERY_5_MINUTES, { name: 'handover-sign-reminder' })
+  async remindUnsignedHandovers(): Promise<void> {
+    try {
+      const rows: Array<{ bookingId: string; reference: string }> = await this.dataSource.query(
+        `SELECT DISTINCT ON (booking_id)
+                booking_id AS "bookingId", reference
+           FROM freight.booking_handovers
+          WHERE signed_at IS NULL
+            AND deleted_at IS NULL
+            AND mile_type = 'SELF_HAUL'
+          ORDER BY booking_id, generated_at DESC`,
+      );
+      if (!rows.length) return;
+      this.logger.log(`Handover sign reminder: ${rows.length} booking(s) still unsigned`);
+      for (const row of rows) {
+        await this.notifySignNeeded(row.bookingId, row.reference);
+      }
+    } catch (err) {
+      this.logger.warn(`Handover sign reminder tick failed: ${(err as Error).message}`);
+    }
+  }
+
   /** Sign all unsigned handovers on a booking (self-haul: before the truck leaves). */
   async signForBooking(bookingId: string, userId?: string | null): Promise<void> {
     await this.dataSource
diff --git a/apps/edr-freight-api/src/modules/warehouses/warehouse-inventory.service.ts b/apps/edr-freight-api/src/modules/warehouses/warehouse-inventory.service.ts
index 06e84d455..2b98856d0 100644
--- a/apps/edr-freight-api/src/modules/warehouses/warehouse-inventory.service.ts
+++ b/apps/edr-freight-api/src/modules/warehouses/warehouse-inventory.service.ts
@@ -2357,6 +2357,27 @@ export class WarehouseInventoryService {
     });
   }
 
+  /**
+   * Self-haul = the customer's own truck collects the goods: either a truck
+   * assigned via the portal (customer_truck_assigned_at), or a walk-in truck
+   * registered at the gate on a booking with no EDR last-mile leg. EDR
+   * last-mile bookings are never self-haul.
+   */
+  private async isSelfHaulBooking(bookingId: string, manager?: EntityManager): Promise<boolean> {
+    const runner = manager ?? this.dataSource;
+    const [row]: Array<{ ok: number }> = await runner.query(
+      `SELECT 1 AS ok
+         FROM freight.bookings b
+         LEFT JOIN freight.service_types st ON st.id = b.service_type_id
+        WHERE b.id = $1 AND b.deleted_at IS NULL
+          AND (b.customer_truck_assigned_at IS NOT NULL
+               OR (NULLIF(TRIM(COALESCE(b.last_mile_delivery_address, '')), '') IS NULL
+                   AND COALESCE(st.includes_last_mile, false) = false))`,
+      [bookingId],
+    );
+    return Boolean(row);
+  }
+
   /** Record a DO / release order sent to the customer. Item stays READY_FOR_PICKUP. */
   async release(id: string, dto: ReleaseOrderDto): Promise<WarehouseInventory> {
     const item = await this.findById(id);
@@ -2366,19 +2387,17 @@ export class WarehouseInventoryService {
       );
     }
 
-    const isTruckLeaving = dto.grossWeight !== undefined && Boolean(dto.gateOutTime);
+    // Leaving = gate-out captured, with either a weighed gross or an explicit
+    // container weighing skip (bulk always weighs).
+    const isTruckLeaving =
+      Boolean(dto.gateOutTime) && (dto.grossWeight !== undefined || dto.weighingSkipped === true);
     if (isTruckLeaving) {
       await this.invoices.assertClearanceAllowed(id);
 
       if (item.bookingId) {
-        const [truckInfo]: Array<{ customerTruckAssignedAt: string | null }> =
-          await this.dataSource.query(
-            `SELECT customer_truck_assigned_at AS "customerTruckAssignedAt"
-               FROM freight.bookings
-              WHERE id = $1 AND deleted_at IS NULL`,
-            [item.bookingId],
-          );
-        const usesCustomerTruck = Boolean(truckInfo?.customerTruckAssignedAt);
+        // Self-haul = customer collects: a truck assigned via the portal, OR a
+        // walk-in truck registered at the gate on a booking with no EDR last mile.
+        const usesCustomerTruck = await this.isSelfHaulBooking(item.bookingId);
         // Self-haul: the handover must be signed before the exit paper is issued.
         // Prefer the structured handover record; fall back to the legacy note.
         const handoverSigned =
@@ -2392,7 +2411,8 @@ export class WarehouseInventoryService {
 
         // Authoritative weight match: the truck's net (gross − tare) must equal the
         // total VGM cargo weight of the containers selected as loaded on it.
-        if (dto.containerNumber && dto.grossWeight != null && dto.tareWeight != null) {
+        // Skipped when the operator chose not to weigh (containers only).
+        if (!dto.weighingSkipped && dto.containerNumber && dto.grossWeight != null && dto.tareWeight != null) {
           const selected = dto.containerNumber
             .split(/[,;\n]+/)
             .map((n) => n.trim())
@@ -2462,13 +2482,10 @@ export class WarehouseInventoryService {
           [item.bookingId],
         );
         // Self-haul: generate the per-booking handover on first truck arrival
-        // (idempotent). It must be signed before the truck leaves.
-        const [selfHaul]: Array<{ ok: number }> = await manager.query(
-          `SELECT 1 AS ok FROM freight.bookings
-            WHERE id = $1 AND customer_truck_assigned_at IS NOT NULL AND deleted_at IS NULL`,
-          [item.bookingId],
-        );
-        if (selfHaul) {
+        // (idempotent) and notify the customer to sign it. Covers BOTH portal-
+        // assigned trucks and walk-in trucks registered manually at the gate
+        // (no portal assignment, no EDR last mile). Must be signed before leaving.
+        if (await this.isSelfHaulBooking(item.bookingId, manager)) {
           await this.handover.ensureForArrivedTruck(item.bookingId, {}, manager);
         }
       }
@@ -4453,14 +4470,17 @@ export class WarehouseInventoryService {
     if (!dto.driverName?.trim()) {
       throw new BadRequestException('Driver name is required for exit inspection');
     }
-    if (dto.tareWeight === undefined) {
+    // Container bookings may skip the weighbridge entirely (weighingSkipped);
+    // bulk always weighs.
+    const weighingSkipped = dto.weighingSkipped === true;
+    if (dto.tareWeight === undefined && !weighingSkipped) {
       throw new BadRequestException('Tare weight is required for truck arrival');
     }
 
-    const tareWeight = Number(dto.tareWeight);
+    const tareWeight = dto.tareWeight === undefined ? null : Number(dto.tareWeight);
     const grossWeight = dto.grossWeight === undefined ? null : Number(dto.grossWeight);
     const computedNetWeight =
-      grossWeight == null ? null : Number((grossWeight - tareWeight).toFixed(3));
+      grossWeight == null || tareWeight == null ? null : Number((grossWeight - tareWeight).toFixed(3));
     const submittedNetWeight =
       dto.netWeight === undefined || computedNetWeight == null ? computedNetWeight : Number(dto.netWeight);
 
@@ -4472,7 +4492,11 @@ export class WarehouseInventoryService {
         throw new BadRequestException('Weight mismatch: net weight must equal gross weight minus tare weight.');
       }
     }
-    if ((dto.grossWeight !== undefined || dto.gateOutTime || dto.netWeight !== undefined) && grossWeight == null) {
+    if (
+      !weighingSkipped &&
+      (dto.grossWeight !== undefined || dto.gateOutTime || dto.netWeight !== undefined) &&
+      grossWeight == null
+    ) {
       throw new BadRequestException('Gross weight is required for truck exit');
     }
 
@@ -4488,7 +4512,8 @@ export class WarehouseInventoryService {
       dto.truckType?.trim() ? `Truck Type: ${dto.truckType.trim()}` : null,
       dto.containerNumber?.trim() ? `Container Number: ${dto.containerNumber.trim()}` : null,
       dto.gateInTime ? `Gate In Time: ${dto.gateInTime}` : null,
-      `Tare Weight: ${tareWeight} t`,
+      weighingSkipped ? 'Weighing: SKIPPED' : null,
+      tareWeight == null ? null : `Tare Weight: ${tareWeight} t`,
       grossWeight == null ? null : `Gross Weight: ${grossWeight} t`,
       computedNetWeight == null ? null : `Net Weight: ${computedNetWeight} t`,
       dto.gateOutTime ? `Gate Out Time: ${dto.gateOutTime}` : null,
@@ -4512,6 +4537,8 @@ export class WarehouseInventoryService {
       containerNumber: this.extractExitInspectionLine(inspection, 'Container Number') || dto.containerNumber,
       gateInTime: this.extractExitInspectionLine(inspection, 'Gate In Time') || dto.gateInTime,
       tareWeight: this.extractExitInspectionNumber(inspection, 'Tare Weight') ?? dto.tareWeight,
+      // The weigh/skip decision is made at arrival and sticks for the exit.
+      weighingSkipped: dto.weighingSkipped || /^Weighing:\s*SKIPPED/im.test(inspection) || undefined,
     };
   }
 
diff --git a/apps/edr-freight-web/backoffice/src/components/warehouses/ReceiveInventoryModal.tsx b/apps/edr-freight-web/backoffice/src/components/warehouses/ReceiveInventoryModal.tsx
index dd04cd3ff..d2540751e 100644
--- a/apps/edr-freight-web/backoffice/src/components/warehouses/ReceiveInventoryModal.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/warehouses/ReceiveInventoryModal.tsx
@@ -2245,6 +2245,9 @@ function ImportUnloadedQueueTab({ enabled }: { enabled: boolean }) {
       handoverDocumentReference: row.handoverDocumentReference,
       handoverDocumentDate: row.handoverDocumentDate,
       deliveredAt: row.deliveredAt,
+      // Carries the saved [Exit Inspection] block so Truck Leaving opens with the
+      // arrival details (plate, driver, tare, gate-in) read-only instead of blank.
+      notes: row.notes,
       booking: row.bookingId
         ? {
             id: row.bookingId,
diff --git a/apps/edr-freight-web/backoffice/src/components/warehouses/ReleaseOrderModal.tsx b/apps/edr-freight-web/backoffice/src/components/warehouses/ReleaseOrderModal.tsx
index 5cca0d3b2..d986e2aba 100644
--- a/apps/edr-freight-web/backoffice/src/components/warehouses/ReleaseOrderModal.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/warehouses/ReleaseOrderModal.tsx
@@ -1,5 +1,5 @@
 import { useEffect, useState } from 'react';
-import { Alert, Button, Group, Modal, MultiSelect, NumberInput, Select, SimpleGrid, Stack, Text, TextInput } from '@mantine/core';
+import { Alert, Button, Group, Modal, MultiSelect, NumberInput, SegmentedControl, Select, SimpleGrid, Stack, Text, TextInput } from '@mantine/core';
 import { Info, Scale } from 'lucide-react';
 
 import { useMutation, useQuery } from '@tanstack/react-query';
@@ -105,6 +105,7 @@ const parseInspectionNote = (notes: string | null | undefined) => {
     grossWeight: lineNumber(note, 'Gross Weight'),
     netWeight: lineNumber(note, 'Net Weight'),
     gateOutTime: toLocalDateTimeInput(lineValue(note, 'Gate Out Time')),
+    weighingSkipped: /^Weighing:\s*SKIPPED/im.test(note ?? ''),
   };
 };
 
@@ -135,6 +136,8 @@ export function ReleaseOrderModal({ opened, onClose, item, truckPrefill }: Relea
   const [containerNumbers, setContainerNumbers] = useState<string[]>(['']);
   const [gateInTime, setGateInTime] = useState('');
   const [tareWeight, setTareWeight] = useState<number | ''>('');
+  // Containers may skip the weighbridge (decided at arrival, sticks for exit). Bulk always weighs.
+  const [weighTruck, setWeighTruck] = useState<'yes' | 'no'>('yes');
   const [grossWeight, setGrossWeight] = useState<number | ''>('');
   const [netWeight, setNetWeight] = useState<number | ''>('');
   const [gateOutTime, setGateOutTime] = useState('');
@@ -158,6 +161,7 @@ export function ReleaseOrderModal({ opened, onClose, item, truckPrefill }: Relea
       setContainerNumbers(initialContainerNumbers(item, inspection.containerNumber || prefillContainerNumber || assignedContainerNumber));
       setGateInTime(inspection.gateInTime);
       setTareWeight(inspection.tareWeight);
+      setWeighTruck(inspection.weighingSkipped ? 'no' : 'yes');
       setGrossWeight(inspection.grossWeight);
       setNetWeight(item?.weight == null ? inspection.netWeight : Number(item.weight));
       setGateOutTime(inspection.gateOutTime);
@@ -165,7 +169,7 @@ export function ReleaseOrderModal({ opened, onClose, item, truckPrefill }: Relea
   }, [opened, item, truckPrefill]);
 
   const savedInspection = parseInspectionNote(item?.notes);
-  const isExitStep = savedInspection.tareWeight !== '';
+  const isExitStep = savedInspection.tareWeight !== '' || savedInspection.weighingSkipped;
   const isEntranceLocked = isExitStep;
   const isCustomerAssignedTruck = Boolean(item?.booking?.customerTruckAssignedAt);
   const hasLastMileTruckPrefill = Boolean(truckPrefill?.truckPlateNumber || truckPrefill?.trailerPlateNumber);
@@ -220,7 +224,9 @@ export function ReleaseOrderModal({ opened, onClose, item, truckPrefill }: Relea
       .reduce((sum, n) => sum + (containerWeightByNumber.get(n.toUpperCase()) ?? 0), 0)
       .toFixed(3),
   );
-  const useContainerNet = hasContainerWeights && selectedContainerNumbers.length > 0;
+  // Skip is only offered for container bookings; bulk always weighs.
+  const skipWeighing = hasContainerWeights && weighTruck === 'no';
+  const useContainerNet = hasContainerWeights && selectedContainerNumbers.length > 0 && !skipWeighing;
 
   const systemNetWeight = useContainerNet
     ? selectedCargoWeight
@@ -230,6 +236,7 @@ export function ReleaseOrderModal({ opened, onClose, item, truckPrefill }: Relea
   const computedNetWeight =
     tareWeight !== '' && grossWeight !== '' ? Number((Number(grossWeight) - Number(tareWeight)).toFixed(3)) : null;
   const weightMismatch =
+    !skipWeighing &&
     computedNetWeight != null && systemNetWeight !== '' && Math.abs(Number(systemNetWeight) - computedNetWeight) > 0.001;
   const title = isExitStep ? 'Customer truck leaving and exit weighing' : 'Customer truck arrival weighing';
 
@@ -239,19 +246,25 @@ export function ReleaseOrderModal({ opened, onClose, item, truckPrefill }: Relea
       toast({ variant: 'destructive', title: 'Truck plate and driver name are required' });
       return;
     }
-    if (!gateInTime || tareWeight === '') {
-      toast({ variant: 'destructive', title: 'Gate in time and tare weight are required' });
+    if (!gateInTime || (!skipWeighing && tareWeight === '')) {
+      toast({
+        variant: 'destructive',
+        title: skipWeighing ? 'Gate in time is required' : 'Gate in time and tare weight are required',
+      });
       return;
     }
-    if (isExitStep && (!gateOutTime || grossWeight === '')) {
-      toast({ variant: 'destructive', title: 'Gate out time and gross weight are required' });
+    if (isExitStep && (!gateOutTime || (!skipWeighing && grossWeight === ''))) {
+      toast({
+        variant: 'destructive',
+        title: skipWeighing ? 'Gate out time is required' : 'Gate out time and gross weight are required',
+      });
       return;
     }
     if (isExitStep && hasContainerWeights && selectedContainerNumbers.length === 0) {
       toast({ variant: 'destructive', title: 'Select the containers loaded on this truck' });
       return;
     }
-    if (isExitStep && systemNetWeight === '') {
+    if (isExitStep && !skipWeighing && systemNetWeight === '') {
       toast({ variant: 'destructive', title: 'System recorded net weight is missing' });
       return;
     }
@@ -279,9 +292,10 @@ export function ReleaseOrderModal({ opened, onClose, item, truckPrefill }: Relea
           truckType: truckType.trim() || undefined,
           containerNumber: containerNumbers.map((number) => number.trim()).filter(Boolean).join(', ') || undefined,
           gateInTime: toIsoDateTime(gateInTime),
-          tareWeight: Number(tareWeight),
-          grossWeight: grossWeight === '' ? undefined : Number(grossWeight),
-          netWeight: isExitStep && systemNetWeight !== '' ? Number(systemNetWeight) : undefined,
+          weighingSkipped: skipWeighing || undefined,
+          tareWeight: skipWeighing ? undefined : Number(tareWeight),
+          grossWeight: skipWeighing || grossWeight === '' ? undefined : Number(grossWeight),
+          netWeight: !skipWeighing && isExitStep && systemNetWeight !== '' ? Number(systemNetWeight) : undefined,
           gateOutTime: isExitStep ? toIsoDateTime(gateOutTime) : undefined,
         },
       });
@@ -421,9 +435,24 @@ export function ReleaseOrderModal({ opened, onClose, item, truckPrefill }: Relea
           )}
           <TextInput label="Gate in time" type="datetime-local" value={gateInTime} onChange={(e) => setGateInTime(e.currentTarget.value)} readOnly={isEntranceLocked} />
         </Group>
+        {hasContainerWeights && (
+          <Group gap="md" align="center">
+            <Text size="sm" fw={600}>Weigh truck?</Text>
+            <SegmentedControl
+              size="xs"
+              data={[{ value: 'yes', label: 'Yes — weigh' }, { value: 'no', label: 'No — pass' }]}
+              value={weighTruck}
+              onChange={(v) => setWeighTruck((v as 'yes' | 'no') ?? 'yes')}
+              disabled={isEntranceLocked}
+            />
+            {skipWeighing && (
+              <Text size="xs" c="dimmed">Weighbridge skipped — container passes without tare/gross.</Text>
+            )}
+          </Group>
+        )}
         <Group grow>
-          <NumberInput label="Tare weight (t)" required min={0} value={tareWeight} onChange={(v) => setTareWeight(v === '' ? '' : Number(v))} readOnly={isEntranceLocked} />
-          <NumberInput label="Gross weight (t)" required={isExitStep} min={0} value={grossWeight} onChange={(v) => setGrossWeight(v === '' ? '' : Number(v))} disabled={!isExitStep} />
+          <NumberInput label="Tare weight (t)" required={!skipWeighing} min={0} value={tareWeight} onChange={(v) => setTareWeight(v === '' ? '' : Number(v))} readOnly={isEntranceLocked} disabled={skipWeighing} />
+          <NumberInput label="Gross weight (t)" required={isExitStep && !skipWeighing} min={0} value={grossWeight} onChange={(v) => setGrossWeight(v === '' ? '' : Number(v))} disabled={!isExitStep || skipWeighing} />
           <NumberInput
             label={useContainerNet ? 'Selected cargo net (t)' : 'Recorded net weight (system t)'}
             min={0}
diff --git a/apps/edr-freight-web/backoffice/src/types/warehouse.ts b/apps/edr-freight-web/backoffice/src/types/warehouse.ts
index 339540453..8a806201e 100644
--- a/apps/edr-freight-web/backoffice/src/types/warehouse.ts
+++ b/apps/edr-freight-web/backoffice/src/types/warehouse.ts
@@ -368,6 +368,8 @@ export interface ReleaseOrderPayload {
   grossWeight?: number;
   netWeight?: number;
   gateOutTime?: string;
+  /** Container bookings only: operator chose not to weigh — tare/gross omitted, match skipped. */
+  weighingSkipped?: boolean;
 }
 
 /** Import branch: proof of delivery captured on customer pickup. */
diff --git a/apps/edr-freight-web/portal/src/pages/MyPortalPage/components/BookingRow.tsx b/apps/edr-freight-web/portal/src/pages/MyPortalPage/components/BookingRow.tsx
index b3acc1667..007fc7fe9 100644
--- a/apps/edr-freight-web/portal/src/pages/MyPortalPage/components/BookingRow.tsx
+++ b/apps/edr-freight-web/portal/src/pages/MyPortalPage/components/BookingRow.tsx
@@ -36,7 +36,9 @@ export const BookingRow = memo(function BookingRow({
   // Contract ready for signature → "View & sign" jumps straight to the
   // full-page contract viewer where the signature flow lives.
   const canSign = bookingIsSignable(booking);
-  const canApproveDelivery = booking.status === "COMPLETED";
+  // Visible from handover generation until the customer signs (flag is attached
+  // by the bookings list endpoint; false again the moment it's signed).
+  const canApproveDelivery = Boolean(booking.handoverAwaitingSignature);
   const origin = booking.originYard?.label ?? booking.originYard?.code ?? "—";
   const dest =
     booking.destinationYard?.label ?? booking.destinationYard?.code ?? "—";
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/ReadonlyBookingView.tsx b/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/ReadonlyBookingView.tsx
index 7384bbc4d..f135078c1 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/ReadonlyBookingView.tsx
+++ b/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/ReadonlyBookingView.tsx
@@ -107,10 +107,12 @@ export function ReadonlyBookingView({
     (isGeneralContract
       ? status === "FULLY_EXECUTED"
       : status === "SELECTED_FOR_BATCH");
-  const canApproveDelivery =
-    status === "COMPLETED" ||
-    Boolean(booking.handoverAwaitingSignature) ||
-    (status === "TRUCK_ASSIGNED" && Boolean(booking.customerTruckArrivedAt));
+  // Approve delivery tracks the handover lifecycle exactly: the button appears
+  // the moment a handover is generated (truck arrival, or an operator's
+  // signature request) and disappears the moment the customer signs it. The
+  // backend flag counts only unsigned SELF_HAUL handovers, so no status
+  // heuristics are needed here.
+  const canApproveDelivery = Boolean(booking.handoverAwaitingSignature);
   const usesCustomerTruck =
     booking.tradeDirection === "IMPORT"
       ? !booking.lastMileDeliveryAddress

From 58a66b3a238bb1bec4f61b9e928f50bb2c812f5f Mon Sep 17 00:00:00 2001
From: Hagernesh <hagernesh@example.com>
Date: Thu, 9 Jul 2026 15:14:44 +0000
Subject: [PATCH 25/25] fix(warehouses): retire per-booking Load and Dispatch
 buttons

Wagon loading happens in the train flow and dispatch at the train level, which
already advances inventory - the per-row buttons duplicated that and confused
operators.

- WarehouseInventoryTable (import dispatch queue + warehouse pages): suppress
  the 'load'/'dispatch' next-action buttons and drop the extra per-row Dispatch
  on READY_FOR_PICKUP rows (Store stays)
- Export Dispatch Queue: drop the per-row Dispatch button and its Actions
  column; the bulk Dispatch All / Dispatch Selected controls remain

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .../warehouses/ReceiveInventoryModal.tsx      | 14 --------
 .../warehouses/WarehouseInventoryTable.tsx    | 36 ++++++++-----------
 2 files changed, 15 insertions(+), 35 deletions(-)

diff --git a/apps/edr-freight-web/backoffice/src/components/warehouses/ReceiveInventoryModal.tsx b/apps/edr-freight-web/backoffice/src/components/warehouses/ReceiveInventoryModal.tsx
index d2540751e..a1b91decb 100644
--- a/apps/edr-freight-web/backoffice/src/components/warehouses/ReceiveInventoryModal.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/warehouses/ReceiveInventoryModal.tsx
@@ -1697,7 +1697,6 @@ function LoadedExportTab({
                 <Table.Th>Weight</Table.Th>
                 <Table.Th>Route</Table.Th>
                 <Table.Th>Status</Table.Th>
-                {dispatchable && <Table.Th ta="right">Actions</Table.Th>}
               </Table.Tr>
             </Table.Thead>
             <Table.Tbody>
@@ -1739,19 +1738,6 @@ function LoadedExportTab({
                       {r.status}
                     </Badge>
                   </Table.Td>
-                  {dispatchable && (
-                    <Table.Td ta="right">
-                      <Button
-                        size="compact-xs"
-                        variant="light"
-                        color="green"
-                        loading={bulkDispatch.isPending}
-                        onClick={() => dispatch([r.id])}
-                      >
-                        Dispatch
-                      </Button>
-                    </Table.Td>
-                  )}
                 </Table.Tr>
               ))}
             </Table.Tbody>
diff --git a/apps/edr-freight-web/backoffice/src/components/warehouses/WarehouseInventoryTable.tsx b/apps/edr-freight-web/backoffice/src/components/warehouses/WarehouseInventoryTable.tsx
index 63292b0af..51650b459 100644
--- a/apps/edr-freight-web/backoffice/src/components/warehouses/WarehouseInventoryTable.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/warehouses/WarehouseInventoryTable.tsx
@@ -160,7 +160,12 @@ export function WarehouseInventoryTable({
           {items.map((item) => {
             const kind = itemKind(item);
             const busy = busyId === item.id;
-            const nextAction = getNextInventoryAction(item);
+            // Per-booking Load and Dispatch are retired: wagon loading happens in
+            // the train flow and dispatch at the train level (which already
+            // advances inventory). Only the remaining lifecycle actions render.
+            const rawNextAction = getNextInventoryAction(item);
+            const nextAction =
+              rawNextAction === 'load' || rawNextAction === 'dispatch' ? null : rawNextAction;
             const canGenerateHandover =
               item.inspectionStatus === 'PASSED' &&
               Boolean(item.bookingId) &&
@@ -232,26 +237,15 @@ export function WarehouseInventoryTable({
                       </Button>
                     )}
                     {item.status === 'READY_FOR_PICKUP' && (
-                      <>
-                        <Button
-                          size="compact-xs"
-                          variant="light"
-                          color="blue"
-                          loading={busy}
-                          onClick={() => onAdvance(item, 'store')}
-                        >
-                          Store
-                        </Button>
-                        <Button
-                          size="compact-xs"
-                          variant="light"
-                          color="green"
-                          loading={busy}
-                          onClick={() => onAdvance(item, 'dispatch')}
-                        >
-                          Dispatch
-                        </Button>
-                      </>
+                      <Button
+                        size="compact-xs"
+                        variant="light"
+                        color="blue"
+                        loading={busy}
+                        onClick={() => onAdvance(item, 'store')}
+                      >
+                        Store
+                      </Button>
                     )}
                     {item.status !== 'DISPATCHED' && (
                       <Tooltip label="Move" withArrow>